001/*
002 * (C) Copyright 2006-2011 Nuxeo SA (http://nuxeo.com/) and others.
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 *     http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 * See the License for the specific language governing permissions and
014 * limitations under the License.
015 *
016 * Contributors:
017 *     bstefanescu, jcarsique
018 */
019package org.nuxeo.connect.update.task.standalone;
020
021import java.io.File;
022import java.io.IOException;
023import java.io.Reader;
024import java.io.StringReader;
025import java.util.ArrayList;
026import java.util.LinkedList;
027import java.util.List;
028import java.util.Map;
029
030import javax.xml.parsers.DocumentBuilder;
031import javax.xml.parsers.DocumentBuilderFactory;
032import javax.xml.parsers.ParserConfigurationException;
033
034import org.nuxeo.common.utils.FileUtils;
035import org.nuxeo.connect.update.LocalPackage;
036import org.nuxeo.connect.update.PackageException;
037import org.nuxeo.connect.update.PackageUpdateService;
038import org.nuxeo.connect.update.ValidationStatus;
039import org.nuxeo.connect.update.task.Command;
040import org.nuxeo.connect.update.xml.XmlWriter;
041import org.w3c.dom.Document;
042import org.w3c.dom.Element;
043import org.w3c.dom.Node;
044import org.xml.sax.InputSource;
045import org.xml.sax.SAXException;
046
047/**
048 * A command based task.
049 *
050 * @author <a href="mailto:bs@nuxeo.com">Bogdan Stefanescu</a>
051 */
052public abstract class CommandsTask extends AbstractTask {
053
054    protected final List<Command> commands;
055
056    /**
057     * The log is generated in the inverse order of commands to ensure last command is rollbacked first.
058     */
059    protected final LinkedList<Command> commandLog;
060
061    public CommandsTask(PackageUpdateService pus) {
062        super(pus);
063        commands = new ArrayList<Command>();
064        commandLog = new LinkedList<Command>();
065    }
066
067    /**
068     * Get the commands file from where to load commands for this task.
069     */
070    protected abstract File getCommandsFile() throws PackageException;
071
072    @SuppressWarnings("hiding")
073    @Override
074    public void initialize(LocalPackage pkg, boolean restart) throws PackageException {
075        super.initialize(pkg, restart);
076        loadCommands();
077    }
078
079    /**
080     * Load the commands of this task given the user parameters. The parameter map may be null.
081     */
082    protected void loadCommands() throws PackageException {
083        try {
084            String content = loadParametrizedFile(getCommandsFile(), env);
085            StringReader reader = new StringReader(content);
086            readLog(reader);
087        } catch (IOException e) {
088            throw new PackageException("Failed to load commands file", e);
089        }
090    }
091
092    /**
093     * Gets the commands to execute.
094     */
095    public List<Command> getCommands() {
096        return commands;
097    }
098
099    /**
100     * Gets the command log. These are the commands ran so far.
101     */
102    public List<Command> getCommandLog() {
103        return commandLog;
104    }
105
106    /**
107     * Adds a command to this task.
108     */
109    public void addCommand(Command command) {
110        commands.add(command);
111    }
112
113    /**
114     * User parameters are not handled by default. You need to implement your own task to do this.
115     */
116    @Override
117    protected void doRun(Map<String, String> params) throws PackageException {
118        for (Command cmd : commands) {
119            Command rollbackCmd = cmd.run(this, params);
120            if (rollbackCmd != null) {
121                if (rollbackCmd.isPostInstall()) {
122                    commandLog.add(rollbackCmd);
123                } else {
124                    commandLog.addFirst(rollbackCmd);
125                }
126            }
127        }
128        // XXX: force a flush?
129        flush();
130    }
131
132    /**
133     * @throws PackageException
134     * @since 5.6
135     */
136    protected abstract void flush() throws PackageException;
137
138    @Override
139    protected void doRollback() throws PackageException {
140        while (!commandLog.isEmpty()) {
141            commandLog.removeFirst().run(this, null);
142        }
143    }
144
145    @Override
146    public void doValidate(ValidationStatus status) throws PackageException {
147        // the target platform is not checked at install
148        // check that commands can be run
149        for (Command cmd : commands) {
150            cmd.validate(this, status);
151        }
152    }
153
154    public void writeLog(File file) throws PackageException {
155        XmlWriter writer = new XmlWriter();
156        writer.start("uninstall");
157        writer.startContent();
158        for (Command cmd : commandLog) {
159            cmd.writeTo(writer);
160        }
161        writer.end("uninstall");
162        try {
163            // replace all occurrences of the installation path with the corresponding variable otherwise the uninstall
164            // will not work after renaming the installation directory
165            String content = parametrizePaths(writer.toString());
166            // replace '//' by '/' if any
167            content = content.replace(File.separator.concat(File.separator), File.separator);
168            FileUtils.writeFile(file, content);
169        } catch (IOException e) {
170            throw new PackageException("Failed to write commands", e);
171        }
172    }
173
174    public String parametrizePaths(String content) {
175        return content.replace(serverPathPrefix, "${" + ENV_SERVER_HOME + "}/");
176    }
177
178    public void readLog(Reader reader) throws PackageException {
179        try {
180            DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
181            factory.setNamespaceAware(true);
182            DocumentBuilder builder = factory.newDocumentBuilder();
183            Document document = builder.parse(new InputSource(reader));
184            Element root = document.getDocumentElement();
185            Node node = root.getFirstChild();
186            while (node != null) {
187                if (node.getNodeType() == Node.ELEMENT_NODE) {
188                    Element element = (Element) node;
189                    String id = node.getNodeName();
190                    Command cmd = service.getCommand(id);
191                    if (cmd == null) { // may be the name of an embedded class
192                        try {
193                            cmd = (Command) pkg.getData().loadClass(id).getConstructor().newInstance();
194                        } catch (ReflectiveOperationException t) {
195                            throw new PackageException("Unknown command: " + id);
196                        }
197                    }
198                    cmd.initialize(element);
199                    commands.add(cmd);
200                }
201                node = node.getNextSibling();
202            }
203        } catch (ParserConfigurationException | SAXException | IOException e) {
204            throw new PackageException("Failed to read commands", e);
205        }
206    }
207
208}