Save point: Simpler project structure for core t-engines

engines/pdfrenderer/.maven-dockerignore

@@ -0,0 +1 @@
+target/docker/

engines/pdfrenderer/Dockerfile

@@ -0,0 +1,37 @@
+# Image provides a container in which to run alfresco-pdf-renderer transformations for Alfresco Content Services.
+
+# alfresco-pdf-renderer uses the PDFium library from Google Inc. See the license at https://pdfium.googlesource.com/pdfium/+/master/LICENSE or in /pdfium.txt.
+
+FROM alfresco/alfresco-base-java:jre11-centos7-202205121725
+
+ENV ALFRESCO_PDF_RENDERER_LIB_RPM_URL=https://nexus.alfresco.com/nexus/service/local/repositories/releases/content/org/alfresco/alfresco-pdf-renderer/1.1/alfresco-pdf-renderer-1.1-linux.tgz
+ENV JAVA_OPTS=""
+
+# Set default user information
+ARG GROUPNAME=Alfresco
+ARG GROUPID=1000
+ARG PDFUSERNAME=pdf
+ARG USERID=33001
+
+COPY target/${env.project_artifactId}-${env.project_version}.jar /usr/bin
+
+RUN ln /usr/bin/${env.project_artifactId}-${env.project_version}.jar /usr/bin/${env.project_artifactId}.jar && \
+    curl -s -S $ALFRESCO_PDF_RENDERER_LIB_RPM_URL -o alfresco-pdf-renderer-linux.tgz && \
+    tar xf alfresco-pdf-renderer-linux.tgz -C /usr/bin && \
+	rm -f alfresco-pdf-renderer-linux.tgz && \
+    yum clean all
+
+ADD target/generated-resources/licenses              /licenses
+ADD target/generated-resources/licenses.xml          /licenses/
+ADD target/generated-sources/license/THIRD-PARTY.txt /licenses/
+COPY src/main/resources/licenses/3rd-party/ /
+
+RUN groupadd -g ${GROUPID} ${GROUPNAME} && \
+    useradd -u ${USERID} -G ${GROUPNAME} ${PDFUSERNAME} && \
+    chgrp -R ${GROUPNAME} /usr/bin/${env.project_artifactId}.jar
+
+EXPOSE 8090
+
+USER ${PDFUSERNAME}
+
+ENTRYPOINT java $JAVA_OPTS -jar /usr/bin/${env.project_artifactId}.jar

engines/pdfrenderer/LICENSES.md

@@ -0,0 +1,4 @@
+### Licenses
+
+* The alfresco-pdf-renderer transformer uses the PDFium library from Google Inc. See [https://pdfium.googlesource.com/pdfium/+/master/LICENSE](https://pdfium.googlesource.com/pdfium/+/master/LICENSE)
+or the [pdfium.txt](../alfresco-transform-pdf-renderer-boot/src/main/resources/licenses/3rd-party/pdfium.txt) file placed in the root directory of the docker image.

engines/pdfrenderer/pom.xml

@@ -0,0 +1,288 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>alfresco-transform-pdf-renderer</artifactId>
+    <name>- PdfRenderer</name>
+
+    <parent>
+        <groupId>org.alfresco</groupId>
+        <artifactId>alfresco-transform-core</artifactId>
+        <version>2.6.1-SNAPSHOT</version>
+        <relativePath>../../pom.xml</relativePath>
+    </parent>
+
+    <properties>
+        <image.name>alfresco/alfresco-pdf-renderer</image.name>
+        <image.registry>quay.io</image.registry>
+        <env.project_artifactId>${project.artifactId}</env.project_artifactId>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.alfresco</groupId>
+            <artifactId>alfresco-base-t-engine</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.alfresco</groupId>
+            <artifactId>alfresco-base-t-engine</artifactId>
+            <version>${project.version}</version>
+            <classifier>tests</classifier>
+            <type>test-jar</type>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-thymeleaf</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+            <exclusions>
+                <exclusion>
+                    <groupId>com.vaadin.external.google</groupId>
+                    <artifactId>android-json</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+        <dependency>
+            <groupId>org.dom4j</groupId>
+            <artifactId>dom4j</artifactId>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <configuration>
+                    <mainClass>org.alfresco.transform.base.Application</mainClass>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>license-maven-plugin</artifactId>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>test-jar</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+
+    <profiles>
+        <profile>
+            <id>docker-it-setup</id>
+            <!-- raises an ActiveMq container for the Integration Tests -->
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>org.apache.maven.plugins</groupId>
+                        <artifactId>maven-failsafe-plugin</artifactId>
+                    </plugin>
+                    <plugin>
+                        <groupId>io.fabric8</groupId>
+                        <artifactId>docker-maven-plugin</artifactId>
+                        <executions>
+                            <execution>
+                                <id>integration-tests</id>
+                                <goals>
+                                    <goal>start</goal>
+                                    <goal>stop</goal>
+                                </goals>
+                                <configuration>
+                                    <images>
+                                        <image>
+                                            <name>alfresco/alfresco-activemq:5.16.1</name>
+                                            <run>
+                                                <hostname>activemq</hostname>
+                                                <ports>
+                                                    <port>8161:8161</port>
+                                                    <port>5672:5672</port>
+                                                    <port>61616:61616</port>
+                                                </ports>
+                                                <wait>
+                                                    <log>Apache ActiveMQ 5.16.1 .* started</log>
+                                                    <time>20000</time>
+                                                    <kill>500</kill>
+                                                    <shutdown>100</shutdown>
+                                                    <exec>
+                                                        <preStop>kill 1</preStop>
+                                                        <preStop>kill -9 1</preStop>
+                                                    </exec>
+                                                </wait>
+                                            </run>
+                                        </image>
+                                        <image>
+                                            <name>${image.name}:${image.tag}</name>
+                                            <run>
+                                                <ports>
+                                                    <port>8090:8090</port>
+                                                </ports>
+                                                <wait>
+                                                    <http>
+                                                        <url>http://localhost:8090/transform/config</url>
+                                                        <method>GET</method>
+                                                        <status>200...299</status>
+                                                    </http>
+                                                    <time>300000</time>
+                                                    <kill>500</kill>
+                                                    <shutdown>100</shutdown>
+                                                    <exec>
+                                                        <preStop>kill 1</preStop>
+                                                        <preStop>kill -9 1</preStop>
+                                                    </exec>
+                                                </wait>
+                                            </run>
+                                        </image>
+                                    </images>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+
+        <profile>
+            <id>local</id>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>io.fabric8</groupId>
+                        <artifactId>docker-maven-plugin</artifactId>
+                        <executions>
+                            <execution>
+                                <id>build-image</id>
+                                <phase>package</phase>
+                                <goals>
+                                    <goal>build</goal>
+                                </goals>
+                                <configuration>
+                                    <images>
+                                        <image>
+                                            <name>${image.name}:${image.tag}</name>
+                                            <build>
+                                                <contextDir>${project.basedir}</contextDir>
+                                                <buildOptions>
+                                                    <squash>true</squash>
+                                                </buildOptions>
+                                            </build>
+                                        </image>
+                                    </images>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+
+        <profile>
+            <id>internal</id>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>io.fabric8</groupId>
+                        <artifactId>docker-maven-plugin</artifactId>
+                        <configuration>
+                            <images>
+                                <!-- QuayIO image -->
+                                <image>
+                                    <name>${image.name}:${image.tag}</name>
+                                    <registry>${image.registry}</registry>
+                                    <build>
+                                        <contextDir>${project.basedir}</contextDir>
+                                        <buildOptions>
+                                            <squash>true</squash>
+                                        </buildOptions>
+                                    </build>
+                                </image>
+                                <!-- DockerHub image -->
+                                <image>
+                                    <name>${image.name}:${image.tag}</name>
+                                    <build>
+                                        <contextDir>${project.basedir}</contextDir>
+                                        <buildOptions>
+                                            <squash>true</squash>
+                                        </buildOptions>
+                                    </build>
+                                </image>
+                            </images>
+                        </configuration>
+                        <executions>
+                            <execution>
+                                <id>build-image</id>
+                                <phase>package</phase>
+                                <goals>
+                                    <goal>build</goal>
+                                </goals>
+                            </execution>
+                            <execution>
+                                <id>push-image</id>
+                                <phase>install</phase>
+                                <goals>
+                                    <goal>push</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+
+        <profile>
+            <id>release</id>
+            <build>
+                <plugins>
+                    <plugin>
+                        <groupId>io.fabric8</groupId>
+                        <artifactId>docker-maven-plugin</artifactId>
+                        <configuration>
+                            <images>
+                                <!-- QuayIO image -->
+                                <image>
+                                    <name>${image.name}:${project.version}</name>
+                                    <registry>${image.registry}</registry>
+                                    <build>
+                                        <contextDir>${project.basedir}</contextDir>
+                                        <buildOptions>
+                                            <squash>true</squash>
+                                        </buildOptions>
+                                    </build>
+                                </image>
+                                <!-- DockerHub image -->
+                                <image>
+                                    <name>${image.name}:${project.version}</name>
+                                    <build>
+                                        <contextDir>${project.basedir}</contextDir>
+                                        <buildOptions>
+                                            <squash>true</squash>
+                                        </buildOptions>
+                                    </build>
+                                </image>
+                            </images>
+                        </configuration>
+                        <executions>
+                            <execution>
+                                <goals>
+                                    <goal>build</goal>
+                                    <goal>push</goal>
+                                </goals>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+        </profile>
+    </profiles>
+</project>

engines/pdfrenderer/src/main/java/org/alfresco/transform/pdfrenderer/PdfRendererOptionsBuilder.java

@@ -0,0 +1,134 @@
+/*
+ * #%L
+ * Alfresco Transform Core
+ * %%
+ * Copyright (C) 2005 - 2022 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.transform.pdfrenderer;
+
+import static org.alfresco.transform.base.util.Util.stringToBoolean;
+import static org.alfresco.transform.base.util.Util.stringToInteger;
+
+import java.util.StringJoiner;
+
+/**
+ * PdfRenderer options builder.
+ *
+ * @author Cezar Leahu
+ */
+public final class PdfRendererOptionsBuilder
+{
+    private Integer page;
+    private Integer width;
+    private Integer height;
+    private Boolean allowPdfEnlargement;
+    private Boolean maintainPdfAspectRatio;
+
+    private PdfRendererOptionsBuilder() {}
+
+    public PdfRendererOptionsBuilder withPage(final String page)
+    {
+        return withPage(stringToInteger(page));
+    }
+
+    public PdfRendererOptionsBuilder withPage(final Integer page)
+    {
+        this.page = page;
+        return this;
+    }
+
+    public PdfRendererOptionsBuilder withWidth(final String width)
+    {
+        return withWidth(stringToInteger(width));
+    }
+
+    public PdfRendererOptionsBuilder withWidth(final Integer width)
+    {
+        this.width = width;
+        return this;
+    }
+
+    public PdfRendererOptionsBuilder withHeight(final String height)
+    {
+        return withHeight(stringToInteger(height));
+    }
+
+    public PdfRendererOptionsBuilder withHeight(final Integer height)
+    {
+        this.height = height;
+        return this;
+    }
+
+    public PdfRendererOptionsBuilder withAllowPdfEnlargement(final String allowPdfEnlargement)
+    {
+        return withAllowPdfEnlargement(stringToBoolean(allowPdfEnlargement));
+    }
+
+    public PdfRendererOptionsBuilder withAllowPdfEnlargement(final Boolean allowPdfEnlargement)
+    {
+        this.allowPdfEnlargement = allowPdfEnlargement;
+        return this;
+    }
+
+    public PdfRendererOptionsBuilder withMaintainPdfAspectRatio(final String maintainPdfAspectRatio)
+    {
+        return withMaintainPdfAspectRatio(stringToBoolean(maintainPdfAspectRatio));
+    }
+
+    public PdfRendererOptionsBuilder withMaintainPdfAspectRatio(final Boolean maintainPdfAspectRatio)
+    {
+        this.maintainPdfAspectRatio = maintainPdfAspectRatio;
+        return this;
+    }
+
+    public String build()
+    {
+        StringJoiner args = new StringJoiner(" ");
+        if (width != null && width >= 0)
+        {
+            args.add("--width=" + width);
+        }
+        if (height != null && height >= 0)
+        {
+            args.add("--height=" + height);
+        }
+        if (allowPdfEnlargement != null && allowPdfEnlargement)
+        {
+            args.add("--allow-enlargement");
+        }
+        if (maintainPdfAspectRatio != null && maintainPdfAspectRatio)
+        {
+            args.add("--maintain-aspect-ratio");
+        }
+        if (page != null && page >= 0)
+        {
+            args.add("--page=" + page);
+        }
+        return args.toString();
+    }
+
+    public static PdfRendererOptionsBuilder builder()
+    {
+        return new PdfRendererOptionsBuilder();
+    }
+}

engines/pdfrenderer/src/main/java/org/alfresco/transform/pdfrenderer/PdfRendererTransformEngine.java

@@ -0,0 +1,75 @@
+/*
+ * #%L
+ * Alfresco Transform Core
+ * %%
+ * Copyright (C) 2005 - 2022 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.transform.pdfrenderer;
+
+import org.alfresco.transform.base.TransformEngine;
+import org.alfresco.transform.base.probes.ProbeTestTransform;
+import org.alfresco.transform.common.TransformConfigResourceReader;
+import org.alfresco.transform.config.TransformConfig;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Component;
+
+import java.util.Collections;
+
+import static org.alfresco.transform.base.logging.StandardMessages.COMMUNITY_LICENCE;
+import static org.alfresco.transform.common.Mimetype.MIMETYPE_IMAGE_PNG;
+import static org.alfresco.transform.common.Mimetype.MIMETYPE_PDF;
+import static org.alfresco.transform.common.Mimetype.MIMETYPE_TEXT_PLAIN;
+
+@Component
+public class PdfRendererTransformEngine implements TransformEngine
+{
+    @Autowired
+    private TransformConfigResourceReader transformConfigResourceReader;
+
+    @Override
+    public String getTransformEngineName()
+    {
+        return "0040-PdfRenderer";
+    }
+
+    @Override
+    public String getStartupMessage() {
+        return COMMUNITY_LICENCE +
+                "This transformer uses alfresco-pdf-renderer which uses the PDFium library from Google Inc. "+
+                "See the license at https://pdfium.googlesource.com/pdfium/+/master/LICENSE or in /pdfium.txt";
+    }
+
+    @Override
+    public TransformConfig getTransformConfig()
+    {
+        return transformConfigResourceReader.read("classpath:pdfrenderer_engine_config.json");
+    }
+
+    @Override
+    public ProbeTestTransform getLivenessAndReadinessProbeTestTransform()
+    {
+        return new ProbeTestTransform("quick.pdf", "quick.png",
+                MIMETYPE_PDF, MIMETYPE_IMAGE_PNG, Collections.emptyMap(),
+                7455, 1024, 150, 10240, 60 * 20 + 1, 60 * 15 - 15);
+    }
+}

engines/pdfrenderer/src/main/java/org/alfresco/transform/pdfrenderer/transformers/PdfRendererTransformer.java

@@ -0,0 +1,129 @@
+/*
+ * #%L
+ * Alfresco Transform Core
+ * %%
+ * Copyright (C) 2005 - 2022 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.transform.pdfrenderer.transformers;
+
+import org.alfresco.transform.base.CustomTransformer;
+import org.alfresco.transform.base.executors.AbstractCommandExecutor;
+import org.alfresco.transform.base.executors.RuntimeExec;
+import org.alfresco.transform.common.TransformException;
+import org.alfresco.transform.pdfrenderer.PdfRendererOptionsBuilder;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Component;
+
+import javax.annotation.PostConstruct;
+import java.io.File;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.util.HashMap;
+import java.util.Map;
+
+import static org.alfresco.transform.base.util.Util.stringToLong;
+import static org.alfresco.transform.common.RequestParamMap.ALLOW_PDF_ENLARGEMENT;
+import static org.alfresco.transform.common.RequestParamMap.HEIGHT_REQUEST_PARAM;
+import static org.alfresco.transform.common.RequestParamMap.MAINTAIN_PDF_ASPECT_RATIO;
+import static org.alfresco.transform.common.RequestParamMap.PAGE_REQUEST_PARAM;
+import static org.alfresco.transform.common.RequestParamMap.TIMEOUT;
+import static org.alfresco.transform.common.RequestParamMap.WIDTH_REQUEST_PARAM;
+
+/**
+ * CommandExecutor implementation for running PDF Renderer transformations. It runs the
+ * transformation logic as a separate Shell process.
+ */
+@Component
+public class PdfRendererTransformer extends AbstractCommandExecutor implements CustomTransformer
+{
+    @Value("${transform.core.pdfrenderer.exe}")
+    private String exe;
+
+    @PostConstruct
+    private void createCommands()
+    {
+        if (exe == null || exe.isEmpty())
+        {
+            throw new IllegalArgumentException("PdfRendererTransformer PDFRENDERER_EXE variable cannot be null or empty");
+        }
+        super.transformCommand = createTransformCommand();
+        super.checkCommand = createCheckCommand();
+    }
+
+    @Override public String getTransformerName()
+    {
+        return "pdfrenderer";
+    }
+
+    @Override
+    protected RuntimeExec createTransformCommand()
+    {
+        RuntimeExec runtimeExec = new RuntimeExec();
+        Map<String, String[]> commandsAndArguments = new HashMap<>();
+        commandsAndArguments.put(".*", new String[]{exe, "SPLIT:${options}", "${source}", "${target}"});
+        runtimeExec.setCommandsAndArguments(commandsAndArguments);
+
+        Map<String, String> defaultProperties = new HashMap<>();
+        defaultProperties.put("key", null);
+        runtimeExec.setDefaultProperties(defaultProperties);
+
+        runtimeExec.setErrorCodes("1");
+
+        return runtimeExec;
+    }
+
+    @Override
+    protected RuntimeExec createCheckCommand()
+    {
+        RuntimeExec runtimeExec = new RuntimeExec();
+        Map<String, String[]> commandsAndArguments = new HashMap<>();
+        commandsAndArguments.put(".*", new String[]{exe, "--version"});
+        runtimeExec.setCommandsAndArguments(commandsAndArguments);
+        return runtimeExec;
+    }
+
+    @Override
+    public void transform(String sourceMimetype, String sourceEncoding, InputStream inputStream,
+            String targetMimetype, String targetEncoding, OutputStream outputStream,
+            Map<String, String> transformOptions) throws Exception
+    {
+        throw new TransformException(500, "TODO PdfRenderer transform");
+    }
+    public void transform(String transformName, String sourceMimetype, String targetMimetype,
+                          Map<String, String> transformOptions,
+                          File sourceFile, File targetFile) throws TransformException
+    {
+        final String options = PdfRendererOptionsBuilder
+                .builder()
+                .withPage(transformOptions.get(PAGE_REQUEST_PARAM))
+                .withWidth(transformOptions.get(WIDTH_REQUEST_PARAM))
+                .withHeight(transformOptions.get(HEIGHT_REQUEST_PARAM))
+                .withAllowPdfEnlargement(transformOptions.get(ALLOW_PDF_ENLARGEMENT))
+                .withMaintainPdfAspectRatio(transformOptions.get(MAINTAIN_PDF_ASPECT_RATIO))
+                .build();
+
+        Long timeout = stringToLong(transformOptions.get(TIMEOUT));
+
+        run(options, sourceFile, targetFile, timeout);
+    }
+}

engines/pdfrenderer/src/main/resources/application-default.yaml

@@ -0,0 +1,7 @@
+queue:
+  engineRequestQueue: ${TRANSFORM_ENGINE_REQUEST_QUEUE:org.alfresco.transform.engine.alfresco-pdf-renderer.acs}
+transform:
+  core:
+    version: @project.version@
+    pdfrenderer:
+      exe: ${PDFRENDERER_EXE:/usr/bin/alfresco-pdf-renderer}

engines/pdfrenderer/src/main/resources/licenses/3rd-party/pdfium.txt

@@ -0,0 +1,27 @@
+// Copyright 2014 PDFium Authors. All rights reserved.
+//
+// Redistribution and use in source and binary forms, with or without
+// modification, are permitted provided that the following conditions are
+// met:
+//
+//    * Redistributions of source code must retain the above copyright
+// notice, this list of conditions and the following disclaimer.
+//    * Redistributions in binary form must reproduce the above
+// copyright notice, this list of conditions and the following disclaimer
+// in the documentation and/or other materials provided with the
+// distribution.
+//    * Neither the name of Google Inc. nor the names of its
+// contributors may be used to endorse or promote products derived from
+// this software without specific prior written permission.
+//
+// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

engines/pdfrenderer/src/main/resources/pdfrenderer_engine_config.json

@@ -0,0 +1,23 @@
+{
+  "transformOptions": {
+    "pdfRendererOptions": [
+      {"value": {"name": "page"}},
+      {"value": {"name": "width"}},
+      {"value": {"name": "height"}},
+      {"value": {"name": "allowPdfEnlargement"}},
+      {"value": {"name": "maintainPdfAspectRatio"}}
+    ]
+  },
+  "transformers": [
+    {
+      "transformerName": "pdfrenderer",
+      "supportedSourceAndTargetList": [
+        {"sourceMediaType": "application/pdf",                            "targetMediaType": "image/png" },
+        {"sourceMediaType": "application/illustrator",                    "targetMediaType": "image/png" }
+      ],
+      "transformOptions": [
+        "pdfRendererOptions"
+      ]
+    }
+  ]
+}

engines/pdfrenderer/src/main/resources/templates/transformForm.html

@@ -0,0 +1,30 @@
+<html xmlns:th="http://www.thymeleaf.org">
+<body>
+
+	<div>
+        <h2>Alfresco PDF Renderer 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><div style="text-align:right">testDelay</div></td><td><input type="text" name="testDelay" value="" /></td></tr>
+
+				<tr><td><div style="text-align:right">page</div></td><td><input type="text" name="page" value="" /></td></tr>
+				
+				<tr><td><div style="text-align:right">width</div></td><td><input type="text" name="width" value="" /></td></tr>
+				<tr><td><div style="text-align:right">height</div></td><td><input type="text" name="height" value="" /></td></tr>
+				<tr><td><div style="text-align:right">allowPdfEnlargement</div></td><td><input type="checkbox" name="allowPdfEnlargement" value="true" /></td></tr>
+				<tr><td><div style="text-align:right">maintainPdfAspectRatio</div></td><td><input type="checkbox" name="maintainPdfAspectRatio" value="true" /></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>

engines/pdfrenderer/src/test/java/org/alfresco/transform/pdfrenderer/AlfrescoPdfRendererControllerTest.java

@@ -0,0 +1,327 @@
+/*
+ * #%L
+ * Alfresco Transform Core
+ * %%
+ * Copyright (C) 2005 - 2022 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.transform.pdfrenderer;
+
+import static org.alfresco.transform.common.RequestParamMap.ENDPOINT_TRANSFORM;
+import static org.hamcrest.Matchers.containsString;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyLong;
+import static org.mockito.Mockito.when;
+import static org.springframework.http.HttpHeaders.ACCEPT;
+import static org.springframework.http.HttpHeaders.CONTENT_DISPOSITION;
+import static org.springframework.http.HttpHeaders.CONTENT_TYPE;
+import static org.springframework.http.HttpStatus.BAD_REQUEST;
+import static org.springframework.http.HttpStatus.CREATED;
+import static org.springframework.http.HttpStatus.OK;
+import static org.springframework.http.MediaType.APPLICATION_JSON_VALUE;
+import static org.springframework.http.MediaType.APPLICATION_PDF_VALUE;
+import static org.springframework.http.MediaType.IMAGE_PNG_VALUE;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+import static org.springframework.util.StringUtils.getFilenameExtension;
+
+import java.io.File;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.util.Arrays;
+import java.util.Map;
+import java.util.UUID;
+
+import javax.annotation.PostConstruct;
+
+import org.alfresco.transform.client.model.TransformReply;
+import org.alfresco.transform.client.model.TransformRequest;
+import org.alfresco.transform.base.TransformController;
+import org.alfresco.transform.base.AbstractTransformControllerTest;
+import org.alfresco.transform.pdfrenderer.transformers.PdfRendererTransformer;
+import org.alfresco.transform.base.executors.RuntimeExec;
+import org.alfresco.transform.base.executors.RuntimeExec.ExecutionResult;
+import org.alfresco.transform.base.model.FileRefEntity;
+import org.alfresco.transform.base.model.FileRefResponse;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.mockito.Mock;
+import org.mockito.stubbing.Answer;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
+import org.springframework.core.io.FileSystemResource;
+import org.springframework.core.io.Resource;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.ResponseEntity;
+import org.springframework.mock.web.MockMultipartFile;
+import org.springframework.test.util.ReflectionTestUtils;
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders;
+
+/**
+ * Test the AlfrescoPdfRendererController without a server.
+ * Super class includes tests for the TransformController.
+ */
+@WebMvcTest()
+public class AlfrescoPdfRendererControllerTest extends AbstractTransformControllerTest
+{
+    private static final String ENGINE_CONFIG_NAME = "pdfrenderer_engine_config.json";
+
+    @Mock
+    private ExecutionResult mockExecutionResult;
+
+    @Mock
+    protected RuntimeExec mockTransformCommand;
+
+    @Mock
+    protected RuntimeExec mockCheckCommand;
+
+    @Value("${transform.core.pdfrenderer.exe}")
+    protected String execPath;
+
+    protected PdfRendererTransformer commandExecutor;
+
+    @PostConstruct
+    private void init()
+    {
+        commandExecutor = new PdfRendererTransformer();
+    }
+
+    @BeforeEach
+    public void before() throws IOException
+    {
+        setFields();
+
+        mockTransformCommand("pdf", "png", APPLICATION_PDF_VALUE, true);
+    }
+
+    protected void setFields()
+    {
+        ReflectionTestUtils.setField(commandExecutor, "transformCommand", mockTransformCommand);
+        ReflectionTestUtils.setField(commandExecutor, "checkCommand", mockCheckCommand);
+        ReflectionTestUtils.setField(controller, "commandExecutor", commandExecutor);
+    }
+
+    @Override
+    public String getEngineConfigName()
+    {
+        return ENGINE_CONFIG_NAME;
+    }
+
+    @Override
+    public void mockTransformCommand(String sourceExtension,
+        String targetExtension, String sourceMimetype,
+        boolean readTargetFileBytes) throws IOException
+    {
+        this.sourceExtension = sourceExtension;
+        this.targetExtension = targetExtension;
+        this.sourceMimetype = sourceMimetype;
+        this.targetMimetype = IMAGE_PNG_VALUE;
+
+        expectedOptions = null;
+        expectedSourceSuffix = null;
+        expectedSourceFileBytes = readTestFile(sourceExtension);
+        expectedTargetFileBytes = readTargetFileBytes ? readTestFile(targetExtension) : null;
+        sourceFile = new MockMultipartFile("file", "quick." + sourceExtension, sourceMimetype,
+            expectedSourceFileBytes);
+
+        when(mockTransformCommand.execute(any(), anyLong())).thenAnswer(
+            (Answer<RuntimeExec.ExecutionResult>) invocation -> {
+                Map<String, String> actualProperties = invocation.getArgument(0);
+                assertEquals(3, actualProperties.size(), "There should be 3 properties");
+
+                String actualOptions = actualProperties.get("options");
+                String actualSource = actualProperties.get("source");
+                String actualTarget = actualProperties.get("target");
+                String actualTargetExtension = getFilenameExtension(actualTarget);
+
+                assertNotNull(actualSource);
+                assertNotNull(actualTarget);
+                if (expectedSourceSuffix != null)
+                {
+                    assertTrue(actualSource.endsWith(expectedSourceSuffix),
+                        "The source file \"" + actualSource +
+                               "\" should have ended in \"" + expectedSourceSuffix + "\"");
+                    actualSource = actualSource.substring(0,
+                        actualSource.length() - expectedSourceSuffix.length());
+                }
+
+                assertNotNull(actualOptions);
+                if (expectedOptions != null)
+                {
+                    assertEquals(expectedOptions, actualOptions,"expectedOptions");
+                }
+
+                Long actualTimeout = invocation.getArgument(1);
+                assertNotNull(actualTimeout);
+                if (expectedTimeout != null)
+                {
+                    assertEquals(expectedTimeout, actualTimeout,"expectedTimeout");
+                }
+
+                // Copy a test file into the target file location if it exists
+                int i = actualTarget.lastIndexOf('_');
+                if (i >= 0)
+                {
+                    String testFilename = actualTarget.substring(i + 1);
+                    File testFile = getTestFile(testFilename, false);
+                    File targetFile = new File(actualTarget);
+                    generateTargetFileFromResourceFile(actualTargetExtension, testFile,
+                        targetFile);
+                }
+
+                // Check the supplied source file has not been changed.
+                byte[] actualSourceFileBytes = Files.readAllBytes(new File(actualSource).toPath());
+                assertTrue(Arrays.equals(expectedSourceFileBytes, actualSourceFileBytes),
+                    "Source file is not the same");
+
+                return mockExecutionResult;
+            });
+
+        when(mockExecutionResult.getExitValue()).thenReturn(0);
+        when(mockExecutionResult.getStdErr()).thenReturn("STDERROR");
+        when(mockExecutionResult.getStdOut()).thenReturn("STDOUT");
+    }
+
+    @Test
+    public void optionsTest() throws Exception
+    {
+        expectedOptions = "--width=321 --height=654 --allow-enlargement --maintain-aspect-ratio --page=2";
+        mockMvc
+            .perform(MockMvcRequestBuilders
+                .multipart(ENDPOINT_TRANSFORM)
+                .file(sourceFile)
+                .param("targetExtension", targetExtension)
+                .param("targetMimetype", targetMimetype)
+                .param("sourceMimetype", sourceMimetype)
+
+                .param("page", "2")
+
+                .param("width", "321")
+                .param("height", "654")
+                .param("allowPdfEnlargement", "true")
+                .param("maintainPdfAspectRatio", "true"))
+            .andExpect(status().is(OK.value()))
+            .andExpect(content().bytes(expectedTargetFileBytes))
+            .andExpect(header().string("Content-Disposition",
+                "attachment; filename*= UTF-8''quick." + targetExtension));
+    }
+
+    @Test
+    public void optionsNegateBooleansTest() throws Exception
+    {
+        expectedOptions = "--width=321 --height=654 --page=2";
+        mockMvc
+            .perform(MockMvcRequestBuilders
+                .multipart(ENDPOINT_TRANSFORM)
+                .file(sourceFile)
+                .param("targetExtension", targetExtension)
+                .param("targetMimetype", targetMimetype)
+                .param("sourceMimetype", sourceMimetype)
+
+                .param("page", "2")
+
+                .param("width", "321")
+                .param("height", "654")
+                .param("allowPdfEnlargement", "false")
+                .param("maintainPdfAspectRatio", "false"))
+            .andExpect(status().is(OK.value()))
+            .andExpect(content().bytes(expectedTargetFileBytes))
+            .andExpect(header().string("Content-Disposition",
+                "attachment; filename*= UTF-8''quick." + targetExtension));
+    }
+
+    @Override
+    protected void updateTransformRequestWithSpecificOptions(TransformRequest transformRequest)
+    {
+        transformRequest.setSourceExtension("pdf");
+        transformRequest.setTargetExtension("png");
+        transformRequest.setSourceMediaType(APPLICATION_PDF_VALUE);
+        transformRequest.setTargetMediaType(IMAGE_PNG_VALUE);
+    }
+
+    @Test
+    public void badExitCodeTest() throws Exception
+    {
+        when(mockExecutionResult.getExitValue()).thenReturn(1);
+
+        mockMvc.perform(mockMvcRequest(ENDPOINT_TRANSFORM, sourceFile, "targetExtension", "xxx"))
+               .andExpect(status().is(BAD_REQUEST.value()))
+               .andExpect(status()
+                   .reason(containsString("Transformer exit code was not 0: \nSTDERR")));
+    }
+
+    @Test
+    public void testPojoTransform() throws Exception
+    {
+        // Files
+        String sourceFileRef = UUID.randomUUID().toString();
+        File sourceFile = getTestFile("quick." + sourceExtension, true);
+        String targetFileRef = UUID.randomUUID().toString();
+
+        TransformRequest transformRequest = createTransformRequest(sourceFileRef, sourceFile);
+
+        // HTTP Request
+        HttpHeaders headers = new HttpHeaders();
+        headers.set(CONTENT_DISPOSITION, "attachment; filename=quick." + sourceExtension);
+        ResponseEntity<Resource> response = new ResponseEntity<>(new FileSystemResource(
+            sourceFile), headers, OK);
+
+        when(alfrescoSharedFileStoreClient.retrieveFile(sourceFileRef)).thenReturn(response);
+        when(alfrescoSharedFileStoreClient.saveFile(any()))
+            .thenReturn(new FileRefResponse(new FileRefEntity(targetFileRef)));
+        when(mockExecutionResult.getExitValue()).thenReturn(0);
+
+        // Update the Transformation Request with any specific params before sending it
+        updateTransformRequestWithSpecificOptions(transformRequest);
+
+        // Serialize and call the transformer
+        String tr = objectMapper.writeValueAsString(transformRequest);
+        String transformationReplyAsString = mockMvc
+            .perform(MockMvcRequestBuilders
+                .post(ENDPOINT_TRANSFORM)
+                .header(ACCEPT, APPLICATION_JSON_VALUE)
+                .header(CONTENT_TYPE, APPLICATION_JSON_VALUE)
+                .content(tr))
+            .andExpect(status().is(CREATED.value()))
+            .andReturn().getResponse().getContentAsString();
+
+        TransformReply transformReply = objectMapper.readValue(transformationReplyAsString,
+            TransformReply.class);
+
+        // Assert the reply
+        assertEquals(transformRequest.getRequestId(), transformReply.getRequestId());
+        assertEquals(transformRequest.getClientData(), transformReply.getClientData());
+        assertEquals(transformRequest.getSchema(), transformReply.getSchema());
+    }
+
+    @Test
+    public void testOverridingExecutorPaths()
+    {
+        //System test property value can me modified in the pom.xml
+        assertEquals(execPath, System.getProperty("PDF_RENDERER_EXE"));
+    }
+}

engines/pdfrenderer/src/test/java/org/alfresco/transform/pdfrenderer/AlfrescoPdfRendererHttpRequestTest.java

@@ -0,0 +1,50 @@
+/*
+ * #%L
+ * Alfresco Transform Core
+ * %%
+ * Copyright (C) 2005 - 2022 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.transform.pdfrenderer;
+
+import org.alfresco.transform.base.AbstractHttpRequestTest;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.boot.test.context.SpringBootTest.WebEnvironment;
+
+/**
+ * Tests AlfrescoPdfRendererController with a server test harness.
+ */
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
+public class AlfrescoPdfRendererHttpRequestTest extends AbstractHttpRequestTest
+{
+    @Override
+    protected String getTransformerName()
+    {
+        return "Alfresco PDF Renderer";
+    }
+
+    @Override
+    protected String getSourceExtension()
+    {
+        return "pdf";
+    }
+}

engines/pdfrenderer/src/test/java/org/alfresco/transform/pdfrenderer/AlfrescoPdfRendererQueueTransformServiceIT.java

@@ -0,0 +1,60 @@
+/*
+ * #%L
+ * Alfresco Transform Core
+ * %%
+ * Copyright (C) 2005 - 2022 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.transform.pdfrenderer;
+
+import static org.alfresco.transform.common.Mimetype.MIMETYPE_OPENXML_WORDPROCESSING;
+import static org.alfresco.transform.common.Mimetype.MIMETYPE_PDF;
+
+import java.util.UUID;
+
+import org.alfresco.transform.client.model.TransformRequest;
+import org.alfresco.transform.base.AbstractQueueTransformServiceIT;
+import org.springframework.boot.test.context.SpringBootTest;
+
+/**
+ * @author Lucian Tuca
+ * created on 15/01/2019
+ */
+@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT,
+                properties = {"activemq.url=nio://localhost:61616"})
+public class AlfrescoPdfRendererQueueTransformServiceIT extends AbstractQueueTransformServiceIT
+{
+    @Override
+    protected TransformRequest buildRequest()
+    {
+        return TransformRequest
+            .builder()
+            .withRequestId(UUID.randomUUID().toString())
+            .withSourceMediaType(MIMETYPE_OPENXML_WORDPROCESSING)
+            .withTargetMediaType(MIMETYPE_PDF)
+            .withTargetExtension("pdf")
+            .withSchema(1)
+            .withClientData("ACS")
+            .withSourceReference(UUID.randomUUID().toString())
+            .withSourceSize(32L).build();
+    }
+}

engines/pdfrenderer/src/test/java/org/alfresco/transform/pdfrenderer/AlfrescoPdfRendererTransformationIT.java

@@ -0,0 +1,93 @@
+/*
+ * #%L
+ * Alfresco Transform Core
+ * %%
+ * Copyright (C) 2005 - 2022 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.transform.pdfrenderer;
+
+import static java.text.MessageFormat.format;
+import static java.util.function.Function.identity;
+import static java.util.stream.Collectors.toMap;
+import static org.alfresco.transform.base.EngineClient.sendTRequest;
+import static org.alfresco.transform.base.TestFileInfo.testFile;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.fail;
+import static org.springframework.http.HttpStatus.OK;
+
+import java.util.Map;
+import java.util.stream.Stream;
+
+import org.alfresco.transform.base.TestFileInfo;
+import org.junit.jupiter.params.ParameterizedTest;
+import org.junit.jupiter.params.provider.MethodSource;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.core.io.Resource;
+import org.springframework.http.ResponseEntity;
+
+/**
+ * @author Cezar Leahu
+ */
+public class AlfrescoPdfRendererTransformationIT
+{
+    private static final Logger logger = LoggerFactory.getLogger(
+        AlfrescoPdfRendererTransformationIT.class);
+    private static final String ENGINE_URL = "http://localhost:8090";
+
+    private static final Map<String, TestFileInfo> TEST_FILES = Stream.of(
+        testFile("application/pdf","pdf","quick.pdf"),
+        testFile("application/illustrator","ai","quickCS3.ai")  ,      
+        testFile("application/illustrator","ai","quickCS5.ai")
+    ).collect(toMap(TestFileInfo::getPath, identity()));
+
+    public static Stream<String> engineTransformations()
+    {
+        return Stream.of(
+            "quick.pdf",
+            "quickCS3.ai",
+            "quickCS5.ai"
+        );
+    }
+
+    @ParameterizedTest
+    @MethodSource("engineTransformations")
+    public void testTransformation(String sourceFile)
+    {
+        final String sourceMimetype = TEST_FILES.get(sourceFile).getMimeType();
+
+        final String descriptor = format("Transform ({0}, {1} -> {2}, {3})",
+            sourceFile, sourceMimetype, "image/png", "png");
+
+        try
+        {
+            final ResponseEntity<Resource> response = sendTRequest(ENGINE_URL, sourceFile, sourceMimetype,
+                "image/png", "png");
+            assertEquals(OK, response.getStatusCode(),descriptor);
+        }
+        catch (Exception e)
+        {
+            fail(descriptor + " exception: " + e.getMessage());
+        }
+    }
+}

engines/pdfrenderer/src/test/resources/engine_config_complete.json

@@ -0,0 +1,22 @@
+{
+  "transformOptions": {
+    "engineXOptions": [
+      {"value": {"name": "page"}},
+      {"value": {"name": "width"}},
+      {"group": {"transformOptions": [
+        {"value": {"name": "cropGravity"}}
+      ]}}
+    ]
+  },
+  "transformers": [
+    {
+      "transformerName": "engineX",
+      "supportedSourceAndTargetList": [
+        {"sourceMediaType": "application/pdf", "targetMediaType": "image/png" }
+      ],
+      "transformOptions": [
+        "engineXOptions"
+      ]
+    }
+  ]
+}

engines/pdfrenderer/src/test/resources/engine_config_incomplete.json

@@ -0,0 +1,10 @@
+{
+  "transformOptions": {},
+  "transformers": [
+    {
+      "supportedSourceAndTargetList": [
+        {"sourceMediaType": "application/pdf", "targetMediaType": "image/png" }
+      ]
+    }
+  ]
+}

engines/pdfrenderer/src/test/resources/engine_config_no_transform_options.json

@@ -0,0 +1,10 @@
+{
+  "transformers": [
+    {
+      "transformerName": "engineX",
+      "supportedSourceAndTargetList": [
+        {"sourceMediaType": "application/pdf", "targetMediaType": "image/png" }
+      ]
+    }
+  ]
+}

engines/pdfrenderer/src/test/resources/engine_config_with_duplicates.json

@@ -0,0 +1,26 @@
+{
+  "transformOptions": {
+    "engineXOptions": [
+      {"value": {"name": "page"}},
+      {"value": {"name": "page"}},
+      {"value": {"name": "width"}},
+      {"group": {"transformOptions": [
+        {"value": {"name": "cropGravity"}}
+      ]}}
+    ]
+  },
+  "transformers": [
+    {
+      "transformerName": "engineX",
+      "supportedSourceAndTargetList": [
+        {"sourceMediaType": "application/pdf", "targetMediaType": "image/png" },
+        {"sourceMediaType": "application/pdf", "targetMediaType": "image/png" },
+        {"sourceMediaType": "application/pdf", "targetMediaType": "image/png" }
+      ],
+      "transformOptions": [
+        "engineXOptions",
+        "engineXOptions"
+      ]
+    }
+  ]
+}

engines/pdfrenderer/src/test/resources/pdfrenderer_engine_config.json

@@ -0,0 +1,23 @@
+{
+  "transformOptions": {
+    "pdfRendererOptions": [
+      {"value": {"name": "page"}},
+      {"value": {"name": "width"}},
+      {"value": {"name": "height"}},
+      {"value": {"name": "allowPdfEnlargement"}},
+      {"value": {"name": "maintainPdfAspectRatio"}}
+    ]
+  },
+  "transformers": [
+    {
+      "transformerName": "pdfrenderer",
+      "supportedSourceAndTargetList": [
+        {"sourceMediaType": "application/pdf",                            "targetMediaType": "image/png" },
+        {"sourceMediaType": "application/illustrator",                    "targetMediaType": "image/png" }
+      ],
+      "transformOptions": [
+        "pdfRendererOptions"
+      ]
+    }
+  ]
+}