Add fabric8 plugin to all docker projects and removed the /docker projects that created the images

Refactor all poms and moved the sources up a level

alfresco-docker-libreoffice/src/main/java/org/alfresco/transformer/Application.java

@@ -0,0 +1,38 @@
+/*
+ * #%L
+ * Alfresco Repository
+ * %%
+ * Copyright (C) 2005 - 2018 Alfresco Software Limited
+ * %%
+ * This file is part of the Alfresco software.
+ * If the software was purchased under a paid Alfresco license, the terms of
+ * the paid license agreement will prevail.  Otherwise, the software is
+ * provided under the following open source license terms:
+ *
+ * Alfresco is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alfresco is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+package org.alfresco.transformer;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class Application
+{
+    public static void main(String[] args)
+    {
+        SpringApplication.run(Application.class, args);
+    }
+}

alfresco-docker-libreoffice/src/main/java/org/alfresco/transformer/JodConverter.java

@@ -0,0 +1,45 @@
+/*
+ * #%L
+ * Alfresco Repository
+ * %%
+ * Copyright (C) 2005 - 2018 Alfresco Software Limited
+ * %%
+ * This file is part of the Alfresco software.
+ * If the software was purchased under a paid Alfresco license, the terms of
+ * the paid license agreement will prevail.  Otherwise, the software is
+ * provided under the following open source license terms:
+ *
+ * Alfresco is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alfresco is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+package org.alfresco.transformer;
+
+import org.artofsolving.jodconverter.office.OfficeManager;
+
+///////// THIS FILE IS A COPY OF THE CODE IN alfresco-repository /////////////
+
+public interface JodConverter
+{
+    /**
+     * Gets the JodConverter OfficeManager.
+     * @return
+     */
+    public abstract OfficeManager getOfficeManager();
+
+    /**
+     * This method returns a boolean indicating whether the JodConverter connection to OOo is available.
+     * @return <code>true</code> if available, else <code>false</code>
+     */
+    public abstract boolean isAvailable();
+}

alfresco-docker-libreoffice/src/main/java/org/alfresco/transformer/JodConverterSharedInstance.java

@@ -0,0 +1,526 @@
+/*
+ * #%L
+ * Alfresco Repository
+ * %%
+ * Copyright (C) 2005 - 2018 Alfresco Software Limited
+ * %%
+ * This file is part of the Alfresco software.
+ * If the software was purchased under a paid Alfresco license, the terms of
+ * the paid license agreement will prevail.  Otherwise, the software is
+ * provided under the following open source license terms:
+ *
+ * Alfresco is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alfresco is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+package org.alfresco.transformer;
+
+import java.io.File;
+import java.io.FileFilter;
+import java.io.FilenameFilter;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.StringTokenizer;
+
+import org.alfresco.error.AlfrescoRuntimeException;
+import org.apache.commons.logging.Log;
+import org.apache.commons.logging.LogFactory;
+import org.artofsolving.jodconverter.office.DefaultOfficeManagerConfiguration;
+import org.artofsolving.jodconverter.office.OfficeException;
+import org.artofsolving.jodconverter.office.OfficeManager;
+import org.springframework.beans.factory.DisposableBean;
+import org.springframework.beans.factory.InitializingBean;
+
+///////// THIS FILE IS A COPY OF THE CODE IN alfresco-repository /////////////
+
+/**
+ * Makes use of the JodConverter library and an installed
+ * OpenOffice application to perform OpenOffice-driven conversions.
+ *
+ * @author Neil McErlean
+ */
+public class JodConverterSharedInstance implements InitializingBean, DisposableBean, JodConverter
+{
+    private static Log logger = LogFactory.getLog(JodConverterSharedInstance.class);
+
+    private OfficeManager officeManager;
+    boolean isAvailable = false;
+
+    // JodConverter's built-in configuration settings.
+    //
+    // These properties are set by Spring dependency injection at system startup in the usual way.
+    // If the values are changed via the JMX console at runtime, then the subsystem will be stopped
+    // and can be restarted with the new values - meaning that JodConverter will also be stopped and restarted.
+    // Therefore there is no special handling required for changes to e.g. portNumbers which determines
+    // the number of OOo instances there should be in the pool.
+    //
+    // Numeric parameters have to be handled as Strings, as that is what Spring gives us for missing values
+    // e.g. if jodconverter.maxTasksPerProcess is not specified in the properties file, the value
+    //      "${jodconverter.maxTasksPerProcess}" will be injected.
+
+    private Integer maxTasksPerProcess;
+    private String officeHome;
+    private int[] portNumbers;
+    private Long taskExecutionTimeout;
+    private Long taskQueueTimeout;
+    private File templateProfileDir;
+    private Boolean enabled;
+    private Long connectTimeout;
+
+    private String deprecatedOooExe;
+    private Boolean deprecatedOooEnabled;
+    private int[] deprecatedOooPortNumbers;
+
+    public void setMaxTasksPerProcess(String maxTasksPerProcess)
+    {
+        Long l = parseStringForLong(maxTasksPerProcess.trim());
+        if (l != null)
+        {
+            this.maxTasksPerProcess = l.intValue();
+        }
+    }
+
+    public void setOfficeHome(String officeHome)
+    {
+        this.officeHome = officeHome == null ? "" : officeHome.trim();
+    }
+
+    public void setDeprecatedOooExe(String deprecatedOooExe)
+    {
+        this.deprecatedOooExe = deprecatedOooExe == null ? "" : deprecatedOooExe.trim();
+    }
+
+    public void setPortNumbers(String s)
+    {
+        portNumbers = parsePortNumbers(s, "jodconverter");
+    }
+
+    public void setDeprecatedOooPort(String s)
+    {
+        deprecatedOooPortNumbers = parsePortNumbers(s, "ooo");
+    }
+
+    private int[] parsePortNumbers(String s, String sys)
+    {
+        int[] portNumbers = null;
+        s = s == null ? null : s.trim();
+        if (s != null && !s.isEmpty())
+        {
+            StringTokenizer tokenizer = new StringTokenizer(s, ",");
+            int tokenCount = tokenizer.countTokens();
+            portNumbers = new int[tokenCount];
+            for (int i = 0;tokenizer.hasMoreTokens();i++)
+            {
+                try
+                {
+                    portNumbers[i] = Integer.parseInt(tokenizer.nextToken().trim());
+                }
+                catch (NumberFormatException e)
+                {
+                    // Logging this as an error as this property would prevent JodConverter & therefore
+                    // OOo from starting as specified
+                    if (logger.isErrorEnabled())
+                    {
+                        logger.error("Unparseable value for property '" + sys + ".portNumbers': " + s);
+                    }
+                    // We'll not rethrow the exception, instead allowing the problem to be picked up
+                    // when the OOoJodConverter subsystem is started.
+                }
+            }
+        }
+        return portNumbers;
+    }
+
+    public void setTaskExecutionTimeout(String taskExecutionTimeout)
+    {
+        this.taskExecutionTimeout = parseStringForLong(taskExecutionTimeout.trim());
+    }
+
+    public void setTemplateProfileDir(String templateProfileDir)
+    {
+        if (templateProfileDir == null || templateProfileDir.trim().length() == 0)
+        {
+            this.templateProfileDir = null;
+        }
+        else
+        {
+            File tmp = new File(templateProfileDir);
+            if (!tmp.isDirectory())
+            {
+                throw new AlfrescoRuntimeException("OpenOffice template profile directory "+templateProfileDir+" does not exist.");
+            }
+            this.templateProfileDir = tmp;
+        }
+    }
+
+    public void setTaskQueueTimeout(String taskQueueTimeout)
+    {
+        this.taskQueueTimeout = parseStringForLong(taskQueueTimeout.trim());
+    }
+
+    public void setConnectTimeout(String connectTimeout)
+    {
+        this.connectTimeout = parseStringForLong(connectTimeout.trim());
+    }
+
+    public void setEnabled(String enabled)
+    {
+        this.enabled = parseEnabled(enabled);
+
+        // If this is a request from the Enterprise Admin console to disable the JodConverter.
+        if (this.enabled == false && (deprecatedOooEnabled == null || deprecatedOooEnabled == false))
+        {
+            // We need to change isAvailable to false so we don't make calls to a previously started OfficeManger.
+            // In the case of Enterprise it is very unlikely that ooo.enabled will have been set to true.
+            this.isAvailable = false;
+        }
+    }
+
+    public void setDeprecatedOooEnabled(String deprecatedOooEnabled)
+    {
+        this.deprecatedOooEnabled = parseEnabled(deprecatedOooEnabled);
+        // No need to worry about isAvailable as this setting cannot be changed via the Admin console.
+    }
+
+    private Boolean parseEnabled(String enabled)
+    {
+        enabled = enabled == null ? "" : enabled.trim();
+        return Boolean.parseBoolean(enabled);
+    }
+
+    // So that Community systems <= Alfresco 6.0.1-ea keep working on upgrade, we may need to use the deprecated
+    // ooo.exe setting rather than the jodconverter.officeHome setting if we don't have the jod setting as
+    // oooDirect was replaced by jodconverter after this release.
+    String getOfficeHome()
+    {
+        String officeHome = this.officeHome;
+        if ((officeHome == null || officeHome.isEmpty()) && (deprecatedOooExe != null && !deprecatedOooExe.isEmpty()))
+        {
+            // It will only be possible to use the ooo.exe value if it includes a path, which itself has the officeHome
+            // value in it.
+
+            // jodconverter.officeHome=/opt/libreoffice5.4/
+            //                 ooo.exe=/opt/libreoffice5.4/program/soffice.bin
+
+            // jodconverter.officeHome=C:/noscan/installs/521~1.1/LIBREO~1/App/libreoffice
+            //                 ooo.exe=C:/noscan/installs/COMMUN~1.0-E/LIBREO~1/App/libreoffice/program/soffice.exe
+
+            File oooExe = new File(deprecatedOooExe);
+            File parent = oooExe.getParentFile();
+            if (parent != null && "program".equals(parent.getName()))
+            {
+                File grandparent = parent.getParentFile();
+                if (grandparent != null)
+                {
+                    officeHome = grandparent.getPath();
+                }
+            }
+        }
+        return officeHome;
+    }
+
+    // So that Community systems <= Alfresco 6.0.1-ea keep working on upgrade, we may need to use the deprecated
+    // ooo.enabled setting if true rather than the jodconverter.enabled setting as oooDirect was replaced by
+    // jodconverter after this release.
+    //     If ooo.enabled is true the JodConverter will be enabled.
+    //     If ooo.enabled is false or unset the jodconverter.enabled value is used.
+    //     Community set properties via alfresco-global.properties.
+    //     Enterprise may do the same but may also reset jodconverter.enabled them via the Admin console.
+    //     In the case of Enterprise it is very unlikely that ooo.enabled will be set to true.
+    boolean isEnabled()
+    {
+        return (deprecatedOooEnabled != null && deprecatedOooEnabled) || (enabled != null && enabled);
+    }
+
+    // So that Community systems <= Alfresco 6.0.1-ea keep working on upgrade, we may need to use the deprecated
+    // ooo.port setting rather than the jodconverter.portNumbers if ooo.enabled is true and jodconverter.enabled
+    // is false.
+    int[] getPortNumbers()
+    {
+        return (enabled == null || !enabled) && deprecatedOooEnabled != null && deprecatedOooEnabled
+                ? deprecatedOooPortNumbers
+                : portNumbers;
+    }
+
+    private Long parseStringForLong(String string)
+    {
+        Long result = null;
+        try
+        {
+            long l = Long.parseLong(string);
+            result = new Long(l);
+        }
+        catch (NumberFormatException nfe)
+        {
+            if (logger.isDebugEnabled())
+            {
+                logger.debug("Cannot parse numerical value from " + string);
+            }
+            // else intentionally empty
+        }
+        return result;
+    }
+
+    /*
+     * (non-Javadoc)
+     * @see org.alfresco.repo.content.JodConverter#isAvailable()
+     */
+    public boolean isAvailable()
+    {
+        final boolean result = isAvailable && officeManager != null;
+        return result;
+    }
+
+    /*
+     * (non-Javadoc)
+     * @see org.springframework.beans.factory.InitializingBean#afterPropertiesSet()
+     */
+    public void afterPropertiesSet() throws Exception
+    {
+        // isAvailable defaults to false afterPropertiesSet. It only becomes true on successful completion of this method.
+        this.isAvailable = false;
+
+        int[] portNumbers = getPortNumbers();
+        String officeHome = getOfficeHome();
+        if (logger.isDebugEnabled())
+        {
+            logger.debug("JodConverter settings (null settings will be replaced by jodconverter defaults):");
+            logger.debug("  officeHome = " + officeHome);
+            logger.debug("  enabled = " + isEnabled());
+            logger.debug("  portNumbers = " + getString(portNumbers));
+            logger.debug("    ooo.exe = " + deprecatedOooExe);
+            logger.debug("    ooo.enabled = " + deprecatedOooEnabled);
+            logger.debug("    ooo.port = " + getString(deprecatedOooPortNumbers));
+            logger.debug("    jodConverter.enabled = " + enabled);
+            logger.debug("    jodconverter.portNumbers = " + getString(this.portNumbers));
+            logger.debug("  jodconverter.officeHome = " + this.officeHome);
+            logger.debug("  jodconverter.maxTasksPerProcess = " + maxTasksPerProcess);
+            logger.debug("  jodconverter.taskExecutionTimeout = " + taskExecutionTimeout);
+            logger.debug("  jodconverter.taskQueueTimeout = " + taskQueueTimeout);
+            logger.debug("  jodconverter.connectTimeout = " + connectTimeout);
+        }
+
+        // Only start the JodConverter instance(s) if the subsystem is enabled.
+        if (isEnabled() == false)
+        {
+            return;
+        }
+
+        logAllSofficeFilesUnderOfficeHome();
+
+        try
+        {
+            DefaultOfficeManagerConfiguration defaultOfficeMgrConfig = new DefaultOfficeManagerConfiguration();
+            if (maxTasksPerProcess != null && maxTasksPerProcess > 0)
+            {
+                defaultOfficeMgrConfig.setMaxTasksPerProcess(maxTasksPerProcess);
+            }
+            if (officeHome != null)
+            {
+                defaultOfficeMgrConfig.setOfficeHome(officeHome);
+            }
+            if (portNumbers != null && portNumbers.length != 0)
+            {
+                defaultOfficeMgrConfig.setPortNumbers(portNumbers);
+            }
+            if (taskExecutionTimeout != null && taskExecutionTimeout > 0)
+            {
+                defaultOfficeMgrConfig.setTaskExecutionTimeout(taskExecutionTimeout);
+            }
+            if (taskQueueTimeout != null && taskQueueTimeout > 0)
+            {
+                defaultOfficeMgrConfig.setTaskQueueTimeout(taskQueueTimeout);
+            }
+            if (templateProfileDir != null)
+            {
+                defaultOfficeMgrConfig.setTemplateProfileDir(templateProfileDir);
+            }
+            if (connectTimeout != null)
+            {
+                defaultOfficeMgrConfig.setConnectTimeout(connectTimeout);
+            }
+            // Try to configure and start the JodConverter library.
+            officeManager = defaultOfficeMgrConfig.buildOfficeManager();
+            officeManager.start();
+        }
+        catch (IllegalStateException isx)
+        {
+            if (logger.isErrorEnabled())
+            {
+                logger.error("Unable to pre-initialise JodConverter library. "
+                        + "The following error is shown for informational purposes only.", isx);
+            }
+            return;
+        }
+        catch (OfficeException ox)
+        {
+            if (logger.isErrorEnabled())
+            {
+                logger.error("Unable to start JodConverter library. "
+                        + "The following error is shown for informational purposes only.", ox);
+            }
+
+            // We need to let it continue (comment-out return statement) even if an error occurs. See MNT-13706 and associated issues.
+            //return;
+        }
+        catch (Exception x)
+        {
+            if (logger.isErrorEnabled())
+            {
+                logger.error("Unexpected error in configuring or starting the JodConverter library."
+                        + "The following error is shown for informational purposes only.",x);
+            }
+            return;
+        }
+
+        // If any exceptions are thrown in the above code, then isAvailable
+        // should remain false, hence the return statements.
+        this.isAvailable = true;
+    }
+
+    private String getString(int[] portNumbers)
+    {
+        StringBuilder portInfo = new StringBuilder();
+        if (portNumbers != null)
+        {
+            for (int i = 0;i < portNumbers.length;i++)
+            {
+                portInfo.append(portNumbers[i]);
+                if (i < portNumbers.length - 1)
+                {
+                    portInfo.append(", ");
+                }
+            }
+        }
+        return portInfo.toString();
+    }
+
+    private void logAllSofficeFilesUnderOfficeHome()
+    {
+        if (logger.isDebugEnabled() == false)
+        {
+            return;
+        }
+
+        String officeHome = getOfficeHome();
+        File requestedOfficeHome = new File(officeHome);
+
+        logger.debug("Some information on soffice* files and their permissions");
+
+        logFileInfo(requestedOfficeHome);
+
+        for (File f : findSofficePrograms(requestedOfficeHome, new ArrayList<File>(), 2))
+        {
+            logFileInfo(f);
+        }
+    }
+
+    private List<File> findSofficePrograms(File searchRoot, List<File> results, int maxRecursionDepth)
+    {
+        return this.findSofficePrograms(searchRoot, results, 0, maxRecursionDepth);
+    }
+
+    private List<File> findSofficePrograms(File searchRoot, List<File> results,
+                                           int currentRecursionDepth, int maxRecursionDepth)
+    {
+        if (currentRecursionDepth >= maxRecursionDepth)
+        {
+            return results;
+        }
+
+        File[] matchingFiles = searchRoot.listFiles(new FilenameFilter()
+        {
+            @Override
+            public boolean accept(File dir, String name)
+            {
+                return name.startsWith("soffice");
+            }
+        });
+        for (File f : matchingFiles)
+        {
+            results.add(f);
+        }
+
+        for (File dir : searchRoot.listFiles(new FileFilter()
+        {
+            @Override
+            public boolean accept(File f) {
+                return f.isDirectory();
+            }
+        }))
+        {
+            findSofficePrograms(dir, results, currentRecursionDepth + 1, maxRecursionDepth);
+        }
+
+        return results;
+    }
+
+    /**
+     * Logs some information on the specified file, including name and r/w/x permissions.
+     * @param f the file to log.
+     */
+    private void logFileInfo(File f)
+    {
+        if (logger.isDebugEnabled() == false)
+        {
+            return;
+        }
+
+        StringBuilder msg = new StringBuilder();
+        msg.append(f).append(" ");
+        if (f.exists())
+        {
+            if (f.canRead())
+            {
+                msg.append("(")
+                        .append(f.isDirectory() ? "d" : "-")
+                        .append(f.canRead() ? "r" : "-")
+                        .append(f.canWrite() ? "w" : "-")
+                        .append(f.canExecute() ? "x" : "-")
+                        .append(")");
+            }
+        }
+        else
+        {
+            msg.append("does not exist");
+        }
+        logger.debug(msg.toString());
+    }
+
+    /*
+     * (non-Javadoc)
+     * @see org.springframework.beans.factory.DisposableBean#destroy()
+     */
+    public void destroy() throws Exception {
+        this.isAvailable = false;
+        if (officeManager != null)
+        {
+            // If there is an OfficeException when stopping the officeManager below, then there is
+            // little that can be done other than logging the exception and carrying on. The JodConverter-based
+            // libraries will not be used in any case, as isAvailable is false.
+            //
+            // Any exception thrown out of this method will be logged and swallowed by Spring
+            // (see javadoc for method declaration). Therefore there is no handling here for
+            // exceptions from jodConverter.
+            officeManager.stop();
+        }
+    }
+
+    /* (non-Javadoc)
+     * @see org.alfresco.repo.content.JodConverterWorker#getOfficeManager()
+     */
+    public OfficeManager getOfficeManager()
+    {
+        return officeManager;
+    }
+}

alfresco-docker-libreoffice/src/main/java/org/alfresco/transformer/LibreOfficeController.java

@@ -0,0 +1,220 @@
+/*
+ * #%L
+ * Alfresco Repository
+ * %%
+ * Copyright (C) 2005 - 2018 Alfresco Software Limited
+ * %%
+ * This file is part of the Alfresco software.
+ * If the software was purchased under a paid Alfresco license, the terms of
+ * the paid license agreement will prevail.  Otherwise, the software is
+ * provided under the following open source license terms:
+ *
+ * Alfresco is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * Alfresco is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with Alfresco. If not, see <http://www.gnu.org/licenses/>.
+ * #L%
+ */
+package org.alfresco.transformer;
+
+import com.sun.star.task.ErrorCodeIOException;
+import org.alfresco.transformer.base.AbstractTransformerController;
+import org.alfresco.transformer.base.TransformException;
+import org.apache.commons.logging.LogFactory;
+import org.apache.pdfbox.pdmodel.PDDocument;
+import org.apache.pdfbox.pdmodel.PDPage;
+import org.apache.pdfbox.pdmodel.PDPageContentStream;
+import org.artofsolving.jodconverter.OfficeDocumentConverter;
+import org.artofsolving.jodconverter.office.OfficeException;
+import org.artofsolving.jodconverter.office.OfficeManager;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.core.io.Resource;
+import org.springframework.http.ResponseEntity;
+import org.springframework.stereotype.Controller;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.multipart.MultipartFile;
+
+import javax.servlet.http.HttpServletRequest;
+import java.io.File;
+import java.io.IOException;
+
+/**
+ * Controller for the Docker based LibreOffice transformer.
+ *
+ *
+ * Status Codes:
+ *
+ *   200 Success
+ *   400 Bad Request: Request parameter <name> is missing (missing mandatory parameter)
+ *   400 Bad Request: Request parameter <name> is of the wrong type
+ *   400 Bad Request: Transformer exit code was not 0 (possible problem with the source file)
+ *   400 Bad Request: The source filename was not supplied
+ *   500 Internal Server Error: (no message with low level IO problems)
+ *   500 Internal Server Error: The target filename was not supplied (should not happen as targetExtension is checked)
+ *   500 Internal Server Error: Transformer version check exit code was not 0
+ *   500 Internal Server Error: Transformer version check failed to create any output
+ *   500 Internal Server Error: Could not read the target file
+ *   500 Internal Server Error: The target filename was malformed (should not happen because of other checks)
+ *   500 Internal Server Error: Transformer failed to create an output file (the exit code was 0, so there should be some content)
+ *   500 Internal Server Error: Filename encoding error
+ *   507 Insufficient Storage: Failed to store the source file
+ */
+@Controller
+public class LibreOfficeController extends AbstractTransformerController
+{
+    private static final String OFFICE_HOME =  "/opt/libreoffice5.4";
+
+    private static final int JODCONVERTER_TRANSFORMATION_ERROR_CODE = 3088;
+
+    private JodConverter jodconverter;
+
+    @Autowired
+    public LibreOfficeController() throws Exception
+    {
+        logger = LogFactory.getLog(LibreOfficeController.class);
+
+        setJodConverter(createJodConverter());
+    }
+
+    private static JodConverter createJodConverter() throws Exception
+    {
+        JodConverterSharedInstance jodconverter = new JodConverterSharedInstance();
+
+        jodconverter.setOfficeHome(OFFICE_HOME);         // jodconverter.officeHome
+        jodconverter.setMaxTasksPerProcess("200");       // jodconverter.maxTasksPerProcess
+        jodconverter.setTaskExecutionTimeout("120000");  // jodconverter.maxTasksPerProcess
+        jodconverter.setTaskQueueTimeout("30000");       // jodconverter.taskQueueTimeout
+        jodconverter.setConnectTimeout("28000");         // jodconverter.connectTimeout
+        jodconverter.setPortNumbers("8100");             // jodconverter.portNumbers
+        jodconverter.setTemplateProfileDir("");          // jodconverter.templateProfileDir
+        jodconverter.setEnabled("true");                 // jodconverter.enabled
+        jodconverter.afterPropertiesSet();
+
+        return jodconverter;
+    }
+
+    public void setJodConverter(JodConverter jodconverter)
+    {
+        this.jodconverter = jodconverter;
+    }
+
+    @PostMapping("/transform")
+    public ResponseEntity<Resource> transform(HttpServletRequest request,
+                                              @RequestParam("file") MultipartFile sourceMultipartFile,
+                                              @RequestParam("targetExtension") String targetExtension,
+                                              @RequestParam(value = "timeout", required = false) Long timeout)
+    {
+        String targetFilename = createTargetFileName(sourceMultipartFile, targetExtension);
+        File sourceFile = createSourceFile(request, sourceMultipartFile);
+        File targetFile = createTargetFile(request, targetFilename);
+        // Both files are deleted by TransformInterceptor.afterCompletion
+
+        executeTransformCommand(sourceFile, targetFile);
+
+        return createAttachment(targetFilename, targetFile);
+    }
+
+    protected void executeTransformCommand(File sourceFile, File targetFile)
+    {
+        try
+        {
+            OfficeManager officeManager = jodconverter.getOfficeManager();
+            OfficeDocumentConverter converter = new OfficeDocumentConverter(officeManager);
+            converter.convert(sourceFile, targetFile);
+        }
+        catch (OfficeException e)
+        {
+            throw new TransformException(500, "LibreOffice server conversion failed: \n"+
+                    "   from file: " + sourceFile + "\n" +
+                    "   to file: " + targetFile,
+                    e);
+        }
+        catch (Throwable throwable)
+        {
+            // Because of the known bug with empty Spreadsheets in JodConverter try to catch exception and produce empty pdf file
+            if (throwable.getCause() instanceof ErrorCodeIOException &&
+                    ((ErrorCodeIOException) throwable.getCause()).ErrCode == JODCONVERTER_TRANSFORMATION_ERROR_CODE)
+            {
+                logger.warn("Transformation failed: \n" +
+                        "from file: " + sourceFile + "\n" +
+                        "to file: " + targetFile +
+                        "Source file " + sourceFile + " has no content");
+                produceEmptyPdfFile(targetFile);
+            }
+            else
+            {
+                throw throwable;
+            }
+        }
+
+        if (!targetFile.exists() || targetFile.length() == 0L)
+        {
+            throw new TransformException(500, "Transformer failed to create an output file");
+        }
+    }
+
+    /**
+     * This method produces an empty PDF file at the specified File location.
+     * Apache's PDFBox is used to create the PDF file.
+     */
+    private void produceEmptyPdfFile(File targetFile)
+    {
+        // If improvement PDFBOX-914 is incorporated, we can do this with a straight call to
+        // org.apache.pdfbox.TextToPdf.createPDFFromText(new StringReader(""));
+        // https://issues.apache.org/jira/browse/PDFBOX-914
+
+        PDDocument pdfDoc = null;
+        PDPageContentStream contentStream = null;
+        try
+        {
+            pdfDoc = new PDDocument();
+            PDPage pdfPage = new PDPage();
+            // Even though, we want an empty PDF, some libs (e.g. PDFRenderer) object to PDFs
+            // that have literally nothing in them. So we'll put a content stream in it.
+            contentStream = new PDPageContentStream(pdfDoc, pdfPage);
+            pdfDoc.addPage(pdfPage);
+
+            // Now write the in-memory PDF document into the temporary file.
+            pdfDoc.save(targetFile.getAbsolutePath());
+
+        }
+        catch (IOException iox)
+        {
+            throw new TransformException(500, "Error creating empty PDF file", iox);
+        }
+        finally
+        {
+            if (contentStream != null)
+            {
+                try
+                {
+                    contentStream.close();
+                }
+                catch (IOException ignored)
+                {
+                    // Intentionally empty
+                }
+            }
+            if (pdfDoc != null)
+            {
+                try
+                {
+                    pdfDoc.close();
+                }
+                catch (IOException ignored)
+                {
+                    // Intentionally empty.
+                }
+            }
+        }
+    }
+}

alfresco-docker-libreoffice/src/main/resources/templates/transformForm.html

@@ -0,0 +1,26 @@
+<html xmlns:th="http://www.thymeleaf.org">
+<body>
+
+	<div th:if="${message}">
+		<h2 th:text="${message}"/>
+	</div>
+
+	<div>
+        <h2>LiberOffice Test Transformation</h2>
+		<form method="POST" enctype="multipart/form-data" action="/transform">
+			<table>
+                <tr><td><div style="text-align:right">file *</div></td><td><input type="file" name="file" /></td></tr>
+                <tr><td><div style="text-align:right">targetExtension *</div></td><td><input type="text" name="targetExtension" value="" /></td></tr>
+				<tr><td><div style="text-align:right">timeout</div></td><td><input type="text" name="timeout" value="" /></td></tr>
+
+				<tr><td></td><td><input type="submit" value="Transform" /></td></tr>
+			</table>
+		</form>
+	</div>
+
+    <div>
+        <a href="/log">Log entries</a>
+    </div>
+
+</body>
+</html>