1 /**
2 * This file Copyright (c) 2016-2018 Magnolia International
3 * Ltd. (http://www.magnolia-cms.com). All rights reserved.
4 *
5 *
6 * This file is dual-licensed under both the Magnolia
7 * Network Agreement and the GNU General Public License.
8 * You may elect to use one or the other of these licenses.
9 *
10 * This file is distributed in the hope that it will be
11 * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the
12 * implied warranty of MERCHANTABILITY or FITNESS FOR A
13 * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT.
14 * Redistribution, except as permitted by whichever of the GPL
15 * or MNA you select, is prohibited.
16 *
17 * 1. For the GPL license (GPL), you can redistribute and/or
18 * modify this file under the terms of the GNU General
19 * Public License, Version 3, as published by the Free Software
20 * Foundation. You should have received a copy of the GNU
21 * General Public License, Version 3 along with this program;
22 * if not, write to the Free Software Foundation, Inc., 51
23 * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
24 *
25 * 2. For the Magnolia Network Agreement (MNA), this file
26 * and the accompanying materials are made available under the
27 * terms of the MNA which accompanies this distribution, and
28 * is available at http://www.magnolia-cms.com/mna.html
29 *
30 * Any modifications to this file must keep this entire header
31 * intact.
32 *
33 */
34 package info.magnolia.config.maputil;
35
36 import java.util.Collection;
37 import java.util.Map;
38
39 import org.apache.commons.lang3.StringUtils;
40 import org.slf4j.Logger;
41 import org.slf4j.LoggerFactory;
42
43 import com.google.common.base.Function;
44 import com.google.common.collect.Maps;
45
46 /**
47 * Simple utility which brings an arbitrary source object to the {@link Map map} representation.
48 *
49 * <ul>
50 * <li>Should the source object be a {@link Map map} already, the operation is trivial;</li>
51 * <li>In case the source object is a {@link Collection collection} it is turned into a map with keys equal to either the values of {@value NAME_PROPERTY_KEY} property or consequent natural numbers;</li>
52 * <li>For any other source type - a log warning is emitted and an empty map is returned.</li>
53 * </ul>
54 *
55 * @param <S> source object type
56 * @param <K> resulting map key type
57 */
58 public class ToMap<S, K> implements Function<S, Map<K, Object>> {
59
60 private static final Logger log = LoggerFactory.getLogger(ToMap.class);
61
62 private static final String NAME_PROPERTY_KEY = "name";
63
64 public static <S, K> Map<K, Object> toMap(S source) {
65 return new ToMap<S, K>().apply(source);
66 }
67
68 @Override
69 public Map<K, Object> apply(S source) {
70
71 if (source instanceof Map) {
72 //noinspection unchecked
73 return (Map<K, Object>) source;
74 }
75
76 if (source instanceof Collection) {
77 //noinspection unchecked
78 return Maps.newLinkedHashMap(Maps.uniqueIndex((Collection<?>) source, new com.google.common.base.Function() {
79 private int numberNameRepresentation = 0;
80 @Override
81 public Object apply(Object value) {
82 String name = null;
83 if (value instanceof Map) {
84 final Map map = (Map) value;
85 if (map.containsKey(NAME_PROPERTY_KEY)) {
86 name = String.valueOf(map.get(NAME_PROPERTY_KEY));
87 }
88 }
89
90 return StringUtils.defaultIfBlank(name, String.valueOf(numberNameRepresentation++));
91 }
92 }));
93 }
94
95 if (source == null) {
96 log.debug("ToMap utility encountered 'null' input, will return empty map...");
97 } else {
98 log.debug("ToMap utility did not manage to convert an object [{}] of type [{}] to a map, will return empty map...", source, source.getClass().getSimpleName());
99 }
100
101 return Maps.newHashMap();
102 }
103 }