View Javadoc
1   /**
2    * This file Copyright (c) 2013-2016 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.framework.setup;
35  
36  import static info.magnolia.nodebuilder.Ops.*;
37  
38  import info.magnolia.i18nsystem.setup.RemoveHardcodedI18nPropertiesFromDialogsTask;
39  import info.magnolia.jcr.util.NodeTypes;
40  import info.magnolia.module.DefaultModuleVersionHandler;
41  import info.magnolia.module.InstallContext;
42  import info.magnolia.module.delta.ArrayDelegateTask;
43  import info.magnolia.module.delta.BootstrapSingleModuleResource;
44  import info.magnolia.module.delta.BootstrapSingleResource;
45  import info.magnolia.module.delta.ChangeAllPropertiesWithCertainValueTask;
46  import info.magnolia.module.delta.CheckAndModifyPropertyValueTask;
47  import info.magnolia.module.delta.DeltaBuilder;
48  import info.magnolia.module.delta.IsModuleInstalledOrRegistered;
49  import info.magnolia.module.delta.ModuleDependencyBootstrapTask;
50  import info.magnolia.module.delta.MoveNodeTask;
51  import info.magnolia.module.delta.NewPropertyTask;
52  import info.magnolia.module.delta.NodeExistsDelegateTask;
53  import info.magnolia.module.delta.PartialBootstrapTask;
54  import info.magnolia.module.delta.PropertyValueDelegateTask;
55  import info.magnolia.module.delta.RemoveNodeTask;
56  import info.magnolia.module.delta.RenameNodesTask;
57  import info.magnolia.module.delta.SetPropertyTask;
58  import info.magnolia.module.delta.Task;
59  import info.magnolia.nodebuilder.task.ErrorHandling;
60  import info.magnolia.nodebuilder.task.NodeBuilderTask;
61  import info.magnolia.repository.RepositoryConstants;
62  import info.magnolia.ui.dialog.action.CallbackDialogActionDefinition;
63  import info.magnolia.ui.dialog.setup.migration.CheckBoxRadioControlMigrator;
64  import info.magnolia.ui.dialog.setup.migration.CheckBoxSwitchControlMigrator;
65  import info.magnolia.ui.dialog.setup.migration.ControlMigratorsRegistry;
66  import info.magnolia.ui.dialog.setup.migration.DateControlMigrator;
67  import info.magnolia.ui.dialog.setup.migration.EditCodeControlMigrator;
68  import info.magnolia.ui.dialog.setup.migration.EditControlMigrator;
69  import info.magnolia.ui.dialog.setup.migration.FckEditControlMigrator;
70  import info.magnolia.ui.dialog.setup.migration.FileControlMigrator;
71  import info.magnolia.ui.dialog.setup.migration.HiddenControlMigrator;
72  import info.magnolia.ui.dialog.setup.migration.LinkControlMigrator;
73  import info.magnolia.ui.dialog.setup.migration.MultiSelectControlMigrator;
74  import info.magnolia.ui.dialog.setup.migration.SelectControlMigrator;
75  import info.magnolia.ui.dialog.setup.migration.StaticControlMigrator;
76  import info.magnolia.ui.form.field.definition.BasicTextCodeFieldDefinition;
77  import info.magnolia.ui.form.field.definition.CompositeFieldDefinition;
78  import info.magnolia.ui.form.field.definition.MultiValueFieldDefinition;
79  import info.magnolia.ui.form.field.definition.SwitchableFieldDefinition;
80  import info.magnolia.ui.form.field.factory.BasicTextCodeFieldFactory;
81  import info.magnolia.ui.form.field.factory.CompositeFieldFactory;
82  import info.magnolia.ui.form.field.factory.MultiValueFieldFactory;
83  import info.magnolia.ui.form.field.factory.RichTextFieldFactory;
84  import info.magnolia.ui.form.field.factory.SwitchableFieldFactory;
85  import info.magnolia.ui.framework.command.CleanTempFilesCommand;
86  
87  import java.util.ArrayList;
88  import java.util.List;
89  
90  import javax.inject.Inject;
91  
92  /**
93   * Version handler for the Ui framework module.
94   */
95  public class UiFrameworkModuleVersionHandler extends DefaultModuleVersionHandler {
96  
97      private static final class RenameLegacyI18nNodeIfExistingTask extends IsModuleInstalledOrRegistered {
98          public RenameLegacyI18nNodeIfExistingTask() {
99              super("Rename legacy i18n node", "Renames /server/i18n/authoring as authoringLegacy. Only run if adminInterface legacy module is installed.", "adminInterface", new RenameNodesTask("", "", RepositoryConstants.CONFIG, "/server/i18n", "authoring", "authoringLegacy", NodeTypes.ContentNode.NAME));
100         }
101     }
102 
103     @Inject
104     public UiFrameworkModuleVersionHandler(ControlMigratorsRegistry controlMigratorsRegistry) {
105         // Register control migration task.
106         controlMigratorsRegistry.register("edit", new EditControlMigrator());
107         controlMigratorsRegistry.register("fckEdit", new FckEditControlMigrator());
108         controlMigratorsRegistry.register("date", new DateControlMigrator());
109         controlMigratorsRegistry.register("select", new SelectControlMigrator());
110         controlMigratorsRegistry.register("checkbox", new CheckBoxRadioControlMigrator(true));
111         controlMigratorsRegistry.register("checkboxSwitch", new CheckBoxSwitchControlMigrator());
112         controlMigratorsRegistry.register("radio", new CheckBoxRadioControlMigrator(false));
113         controlMigratorsRegistry.register("uuidLink", new LinkControlMigrator());
114         controlMigratorsRegistry.register("link", new LinkControlMigrator());
115         controlMigratorsRegistry.register("multiselect", new MultiSelectControlMigrator(false));
116         controlMigratorsRegistry.register("file", new FileControlMigrator());
117         controlMigratorsRegistry.register("static", new StaticControlMigrator());
118         controlMigratorsRegistry.register("hidden", new HiddenControlMigrator());
119         controlMigratorsRegistry.register("editCode", new EditCodeControlMigrator());
120 
121         register(DeltaBuilder.update("5.0.1", "")
122                 .addTask(new RenameLegacyI18nNodeIfExistingTask())
123                 .addTask(new RenameNodesTask("Rename 5.0 i18n node", "Renames /server/i18n/authoring50 as authoring.", RepositoryConstants.CONFIG, "/server/i18n", "authoring50", "authoring", NodeTypes.ContentNode.NAME))
124                 .addTask(new BootstrapSingleModuleResource("Add dialogs to ui-framework", "", "config.modules.ui-framework.dialogs.xml")));
125 
126         register(DeltaBuilder.update("5.1", "")
127                 .addTask(new BootstrapSingleModuleResource("Register WorkbenchFieldDefinition", "", "config.modules.ui-framework.fieldTypes.workbenchField.xml"))
128                 .addTask(new RemoveNodeTask("Remove MultiLinkField definition mapping", "", RepositoryConstants.CONFIG, "/modules/ui-framework/fieldTypes/multiLinkField"))
129                 .addTask(createNewFieldDefinition("basicTextCodeField", BasicTextCodeFieldDefinition.class.getName(), BasicTextCodeFieldFactory.class.getName()))
130                 .addTask(createNewFieldDefinition("switchableField", SwitchableFieldDefinition.class.getName(), SwitchableFieldFactory.class.getName()))
131                 .addTask(createNewFieldDefinition("multiField", MultiValueFieldDefinition.class.getName(), MultiValueFieldFactory.class.getName()))
132                 .addTask(createNewFieldDefinition("compositeField", CompositeFieldDefinition.class.getName(), CompositeFieldFactory.class.getName()))
133                 .addTask((new ReplaceMultiLinkFieldDefinitionTask("Change the MultiLinkFieldDefinition by MultiValueFieldDefinition ", "", RepositoryConstants.CONFIG, " select * from [nt:base] as t where contains(t.*,'info.magnolia.ui.form.field.definition.MultiLinkFieldDefinition') ")))
134                 .addTask((new ReplaceSaveModeTypeFieldDefinitionTask("Update field definition sub task from 'saveModeType' to 'transformerClass' ", "", RepositoryConstants.CONFIG, " select * from [nt:base] as t where name(t) = 'saveModeType' ")))
135                 .addTask(new ChangeAllPropertiesWithCertainValueTask("Change package name of CallbackDialogActionDefinition class", "", RepositoryConstants.CONFIG, "info.magnolia.ui.admincentral.dialog.action.CallbackDialogActionDefinition", CallbackDialogActionDefinition.class.getName()))
136                 .addTask((new RemoveHardcodedI18nPropertiesFromDialogsTask("ui-framework"))));
137 
138         register(DeltaBuilder.update("5.2.2", "")
139                 .addTask(new NodeExistsDelegateTask("Register WorkbenchFieldDefinition if not yet done", "", RepositoryConstants.CONFIG, "/modules/ui-framework/fieldTypes/workbenchField", null, new BootstrapSingleModuleResource("Register WorkbenchFieldDefinition", "", "config.modules.ui-framework.fieldTypes.workbenchField.xml")))
140                 .addTask(new NodeExistsDelegateTask("Rename fieldType if it's misspelled", "/modules/ui-framework/fieldTypes/compositField",
141                         new MoveNodeTask("Rename misspelled fieldType", "/modules/ui-framework/fieldTypes/compositField", "/modules/ui-framework/fieldTypes/compositeField", false)
142                         ))
143                 .addTask(new NodeExistsDelegateTask("Rename command catalog if it's incorrect", "Rename command catalog to 'default' if it's incorrect", RepositoryConstants.CONFIG, "/modules/ui-framework/commands/deafult",
144                         new MoveNodeTask("Rename command catalog", "Rename command catalog to 'default'", RepositoryConstants.CONFIG, "/modules/ui-framework/commands/deafult",
145                                 "/modules/ui-framework/commands/default", false)
146                         ))
147                 .addTask(new NodeExistsDelegateTask("Bootstrap 'importZip' command it doesn't exists yet", "Bootstrap 'importZip' command it doesn't exists yet", RepositoryConstants.CONFIG, "/modules/ui-framework/commands/default/importZip", null, new BootstrapSingleModuleResource("Bootstrap 'importZip' command", "Bootstrap 'importZip' command", "config.modules.ui-framework.commands.xml"
148                         )))
149                 .addTask(new NodeExistsDelegateTask("Bootstrap 'importZip' dialog it doesn't exists yet", "Bootstrap 'importZip' dialog it doesn't exists yet", RepositoryConstants.CONFIG, "/modules/ui-framework/dialog/importZip", null,
150                         new PartialBootstrapTask("Bootstrap 'importZip' dialog", "Bootstraps 'importZip' dialog.", "/mgnl-bootstrap/ui-framework/config.modules.ui-framework.dialogs.xml", "dialogs/importZip")))
151                 .addTask(new SetPropertyTask(RepositoryConstants.CONFIG, "/modules/ui-framework/dialogs/importZip/form/tabs/import/fields/encoding/options/utf-8", "label", "UTF-8"))
152                 .addTask(new SetPropertyTask(RepositoryConstants.CONFIG, "/modules/ui-framework/dialogs/importZip/form/tabs/import/fields/encoding/options/windows", "label", "CP437")));
153 
154         register(DeltaBuilder.update("5.3", "")
155                 .addTask(new ArrayDelegateTask("Make dialogs light", "Turns edit node name and edit folder name dialogs into light dialogs.",
156                         new NodeExistsDelegateTask("", "", RepositoryConstants.CONFIG, "/modules/ui-framework/dialogs/rename",
157                                 new NewPropertyTask("", "", RepositoryConstants.CONFIG, "/modules/ui-framework/dialogs/rename", "modalityLevel", "light")),
158                         new NodeExistsDelegateTask("", "", RepositoryConstants.CONFIG, "/modules/ui-framework/dialogs/folder",
159                                 new NewPropertyTask("", "", RepositoryConstants.CONFIG, "/modules/ui-framework/dialogs/folder", "modalityLevel", "light"))
160                         )));
161 
162         register(DeltaBuilder.update("5.4", "")
163                 .addTask(new PartialBootstrapTask("Add new code fieldType", "/mgnl-bootstrap/ui-framework/config.modules.ui-framework.fieldTypes.xml", "fieldTypes/code"))
164         );
165 
166         register(DeltaBuilder.update("5.4.2", "")
167                 .addTask(new NodeExistsDelegateTask("Check if path '/modules/ui-framework/dialogs/importZip/form/tabs/import/fields/name' exist.", "/modules/ui-framework/dialogs/importZip/form/tabs/import/fields/name",
168                         new ArrayDelegateTask("",
169                                 new CheckAndModifyPropertyValueTask("Add mimeType application/octet-stream that is used by google chrome for zip files.", "Add mimeType application/octet-stream that is used by google chrome for zip files.", RepositoryConstants.CONFIG, "/modules/ui-framework/dialogs/importZip/form/tabs/import/fields/name", "allowedMimeTypePattern", "application/(zip|x-zip|x-zip-compressed)", "application/(zip|x-zip|x-zip-compressed|octet-stream)")))));
170         register(DeltaBuilder.update("5.4.3", "")
171                 .addTask(new NodeExistsDelegateTask("Configure 'cleanTempFiles' command if does not exists.", "/modules/ui-framework/commands/default/cleanTempFiles", null,
172                         new PartialBootstrapTask("Configure 'cleanTempFiles' command.", "/mgnl-bootstrap/ui-framework/config.modules.ui-framework.commands.xml", "commands/default/cleanTempFiles")))
173                 .addTask(new IsModuleInstalledOrRegistered("Configure 'CleanTempFiles' job - check if scheduler module is installed.", "scheduler",
174                         new NodeExistsDelegateTask("Check if 'cleanTempFiles' command was already configured.", "/modules/ui-framework/commands/default/cleanTempFiles",
175                                 new PropertyValueDelegateTask("Check if 'class' property of 'cleanTempFiles' command has required value 'info.magnolia.ui.framework.command.CleanTempFilesCommand'.", "/modules/ui-framework/commands/default/cleanTempFiles", "class", CleanTempFilesCommand.class.getName(), false,
176                                         new NodeExistsDelegateTask("Configure 'CleanTempFiles' job if does not exist.", "/modules/scheduler/config/jobs/cleanTempFiles", null,
177                                                 new BootstrapSingleResource("", "Configure 'CleanTempFiles' job.", "/info/magnolia/module/ui-framework/setup/scheduler/config.modules.scheduler.config.jobs.cleanTempFiles.xml")))))));
178 
179         register(DeltaBuilder.update("5.4.4", "")
180             .addTask(new PartialBootstrapTask("Add JCR node-type selector field", "/mgnl-bootstrap/ui-framework/config.modules.ui-framework.fieldTypes.xml", "fieldTypes/nodeTypeField"))
181         );
182 
183         register(DeltaBuilder.update("5.4.8", "")
184                 .addTask(new IsModuleInstalledOrRegistered("Check if dam-app module is installed", "dam-app", (Task)null,
185                             new NodeExistsDelegateTask("Change AssetsEnabledRichTextFieldFactory to RichTextFieldFactory", "/modules/ui-framework/fieldTypes/textArea",
186                                 new CheckAndModifyPropertyValueTask("/modules/ui-framework/fieldTypes/textArea", "factoryClass", "info.magnolia.dam.app.ui.field.factory.AssetsEnabledRichTextFieldFactory", RichTextFieldFactory.class.getName()))))
187                 .addTask(new IsModuleInstalledOrRegistered("Check if form module is installed", "form", (Task)null,
188                             new RemoveNodeTask("Remove formStaticField", "/modules/ui-framework/fieldTypes/formStaticField")))
189         );
190     }
191 
192     @Override
193     protected List<Task> getExtraInstallTasks(InstallContext installContext) {
194         ArrayList<Task> tasks = new ArrayList<Task>();
195         tasks.add(new ModuleDependencyBootstrapTask("scheduler"));
196         return tasks;
197     }
198 
199     /**
200      * Create a new Field Definition.
201      */
202     private NodeBuilderTask createNewFieldDefinition(String fieldName, String definitionClass, String factoryClass) {
203         return new NodeBuilderTask("Add definition for the newly introduce field: " + fieldName, "", ErrorHandling.logging, RepositoryConstants.CONFIG, "/modules/ui-framework",
204                 getNode("fieldTypes").then(
205                         addNode(fieldName, NodeTypes.ContentNode.NAME),
206                         getNode(fieldName).then(
207                                 addProperty("definitionClass", definitionClass),
208                                 addProperty("factoryClass", factoryClass)
209                                 )
210                         ));
211     }
212 }