View Javadoc
1   /**
2    * This file Copyright (c) 2013-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.ui.form.field.factory;
35  
36  import info.magnolia.cms.i18n.I18nContentSupport;
37  import info.magnolia.objectfactory.ComponentProvider;
38  import info.magnolia.ui.api.context.UiContext;
39  import info.magnolia.ui.api.i18n.I18NAuthoringSupport;
40  import info.magnolia.ui.form.field.CompositeField;
41  import info.magnolia.ui.form.field.definition.CompositeFieldDefinition;
42  import info.magnolia.ui.form.field.transformer.Transformer;
43  
44  import java.util.List;
45  
46  import javax.inject.Inject;
47  
48  import org.slf4j.Logger;
49  import org.slf4j.LoggerFactory;
50  
51  import com.vaadin.v7.data.Item;
52  import com.vaadin.v7.data.util.PropertysetItem;
53  import com.vaadin.v7.ui.Field;
54  
55  /**
56   * Factory used to initialize a {@link CompositeField}.
57   *
58   * @param <D> the field definition type — has to inherit from {@link CompositeFieldDefinition}.
59   */
60  public class CompositeFieldFactory<D extends CompositeFieldDefinition> extends AbstractFieldFactory<D, PropertysetItem> {
61  
62      private static final Logger log = LoggerFactory.getLogger(CompositeFieldFactory.class);
63      private FieldFactoryFactory fieldFactoryFactory;
64      private ComponentProvider componentProvider;
65      private final I18NAuthoringSupport i18nAuthoringSupport;
66  
67      @Inject
68      public CompositeFieldFactory(D definition, Item relatedFieldItem, UiContext uiContext, I18NAuthoringSupport i18nAuthoringSupport, FieldFactoryFactory fieldFactoryFactory, ComponentProvider componentProvider) {
69          super(definition, relatedFieldItem, uiContext, i18nAuthoringSupport);
70          this.fieldFactoryFactory = fieldFactoryFactory;
71          this.componentProvider = componentProvider;
72          this.i18nAuthoringSupport = i18nAuthoringSupport;
73      }
74  
75      /**
76       * @deprecated since 5.4.7 - use {@link #CompositeFieldFactory(CompositeFieldDefinition, Item, UiContext, I18NAuthoringSupport, FieldFactoryFactory, ComponentProvider)} instead.
77       */
78      @Deprecated
79      public CompositeFieldFactory(D definition, Item relatedFieldItem, FieldFactoryFactory fieldFactoryFactory, ComponentProvider componentProvider, I18NAuthoringSupport i18nAuthoringSupport) {
80          this(definition, relatedFieldItem, null, i18nAuthoringSupport, fieldFactoryFactory, componentProvider);
81      }
82  
83      /**
84       * @deprecated since 5.3.5 removing i18nContentSupport dependency (actually unused way before that). Besides, fields should use i18nAuthoringSupport for internationalization.
85       */
86      @Deprecated
87      public CompositeFieldFactory(D definition, Item relatedFieldItem, FieldFactoryFactory fieldFactoryFactory, I18nContentSupport i18nContentSupport, ComponentProvider componentProvider) {
88          this(definition, relatedFieldItem, null, componentProvider.getComponent(I18NAuthoringSupport.class), fieldFactoryFactory, componentProvider);
89      }
90  
91      @Override
92      protected Field<PropertysetItem> createFieldComponent() {
93          // FIXME change i18n setting : MGNLUI-1548
94          definition.setI18nBasename(getMessages().getBasename());
95  
96          // we do not support composite fields themselves to be required. Definition is overwritten here. Can't set it on the field after its creation cause otherwise the required asterisk is displayed.
97          if (definition.isRequired()) {
98              log.warn("Definition of the composite field named [{}] is configured as required which is not supported (it is possible to configure the sub-fields as required though).", definition.getName());
99              definition.setRequired(false);
100         }
101         CompositeFieldompositeField.html#CompositeField">CompositeField field = new CompositeField(definition, fieldFactoryFactory, componentProvider, item, i18nAuthoringSupport);
102         return field;
103     }
104 
105     /**
106      * Create a new Instance of {@link Transformer}.
107      */
108     @Override
109     protected Transformer<?> initializeTransformer(Class<? extends Transformer<?>> transformerClass) {
110         List<String> propertyNames = definition.getFieldNames();
111         Transformer<?> transformer = this.componentProvider.newInstance(transformerClass, item, definition, PropertysetItem.class, propertyNames);
112         transformer.setLocale(getLocale());
113         return transformer;
114     }
115 }