1 /*
2 * Copyright 2012-2025 CodeLibs Project and the Others.
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
13 * either express or implied. See the License for the specific language
14 * governing permissions and limitations under the License.
15 */
16 package org.codelibs.fess.util;
17
18 import java.util.Collection;
19 import java.util.List;
20 import java.util.stream.Collectors;
21
22 import org.codelibs.core.beans.util.BeanUtil;
23 import org.dbflute.Entity;
24 import org.lastaflute.web.response.render.RenderData;
25
26 /**
27 * Utility class for managing render data in web responses.
28 * This class provides methods to register values in RenderData objects with proper handling
29 * of Entity objects and Collections that may contain Entity objects.
30 *
31 */
32 public class RenderDataUtil {
33
34 /**
35 * Default constructor.
36 */
37 private RenderDataUtil() {
38 // Default constructor
39 }
40
41 /**
42 * Registers a value in the render data with the specified key.
43 * If the value is an Entity object, it will be converted to a Map using BeanUtil.
44 * If the value is a Collection containing Entity objects, each Entity will be converted to a Map.
45 * For other types of values, they are registered directly.
46 *
47 * @param data the RenderData object to register the value in
48 * @param key the key to associate with the value
49 * @param value the value to register; can be null, Entity, Collection, or any other object
50 */
51 public static void register(final RenderData data, final String key, final Object value) {
52 if (value == null) {
53 return;
54 }
55
56 if (value instanceof Entity) {
57 data.register(key, BeanUtil.copyBeanToNewMap(value));
58 } else {
59 if (value instanceof final Collection<?> coll && !coll.isEmpty()) {
60 // care performance for List that the most frequent pattern
61 final Object first = coll instanceof List<?> ? ((List<?>) coll).get(0) : coll.iterator().next();
62 if (first instanceof Entity) {
63 data.register(key, coll.stream().map(BeanUtil::copyBeanToNewMap).collect(Collectors.toList()));
64 return;
65 }
66 }
67 data.register(key, value);
68 }
69 }
70
71 }