Provide high level api for PDF/UA document generation

DEVSIX-8478

Author: guustysebie

pom.xml

@@ -62,7 +62,6 @@
       <groupId>com.itextpdf</groupId>
       <artifactId>pdfua</artifactId>
       <version>${itext.version}</version>
-      <scope>test</scope>
     </dependency>
   </dependencies>
 

src/main/java/com/itextpdf/html2pdf/ConverterProperties.java

@@ -28,7 +28,9 @@ This file is part of the iText (R) project.
 import com.itextpdf.html2pdf.attach.util.AlternateDescriptionResolver;
 import com.itextpdf.html2pdf.css.apply.ICssApplierFactory;
 import com.itextpdf.kernel.pdf.PdfAConformance;
+import com.itextpdf.kernel.pdf.PdfConformance;
 import com.itextpdf.kernel.pdf.PdfOutputIntent;
+import com.itextpdf.kernel.pdf.PdfUAConformance;
 import com.itextpdf.layout.font.FontProvider;
 import com.itextpdf.styledxmlparser.css.media.MediaDeviceDescription;
 import com.itextpdf.styledxmlparser.resolver.resource.IResourceRetriever;
@@ -122,7 +124,7 @@ public class ConverterProperties {
     /**
      * Conformance for conversion to pdf/a.
      */
-    private PdfAConformance aConformance;
+    private PdfConformance conformance = new PdfConformance();
 
     /**
      * Instantiates a new {@link ConverterProperties} instance.
@@ -151,7 +153,8 @@ public ConverterProperties(ConverterProperties other) {
         this.limitOfLayouts = other.limitOfLayouts;
         this.immediateFlush = other.immediateFlush;
         this.continuousContainerEnabled = other.continuousContainerEnabled;
-
+        this.conformance = other.conformance;
+        this.outputIntent = other.outputIntent;
         for (Class<?> aClass : other.dependencies.keySet()) {
             this.dependencies.put(aClass, other.dependencies.get(aClass));
         }
@@ -354,7 +357,6 @@ public boolean isCreateAcroForm() {
      * When enabling this acroform creation, it will disable the immediateFlushing property.
      *
      * @param createAcroForm true if an AcroForm needs to be created
-     *
      * @return the {@link ConverterProperties} instance
      */
     public ConverterProperties setCreateAcroForm(boolean createAcroForm) {
@@ -420,16 +422,28 @@ public ConverterProperties setCharset(String charset) {
         return this;
     }
 
+    /**
+     * Gets pdf document output intent (final destination device) to reproduce the color in the PDF.
+     *
+     * <p>
+     * Note, output intent isn't applicable for HtmlConverter#convertToElements methods
+     * (e.g. {@link HtmlConverter#convertToElements(InputStream, ConverterProperties)})
+     *
+     * @return pdf output intent
+     */
+    public PdfOutputIntent getDocumentOutputIntent() {
+        return outputIntent;
+    }
+
     /**
      * Sets pdf document output intent (final destination device) to reproduce the color in the PDF.
-     * Required parameter, when converting to pdf/a one have to specify an explicit output intent.
+     * Required parameter, when converting to pdf/a one has to specify an explicit output intent.
      *
      * <p>
      * Note, output intent isn't applicable for HtmlConverter#convertToElements methods
      * (e.g. {@link HtmlConverter#convertToElements(InputStream, ConverterProperties)})
      *
      * @param outputIntent a {@link PdfOutputIntent} instance
-     *
      * @return the {@link ConverterProperties} instance
      */
     public ConverterProperties setDocumentOutputIntent(PdfOutputIntent outputIntent) {
@@ -438,38 +452,45 @@ public ConverterProperties setDocumentOutputIntent(PdfOutputIntent outputIntent)
     }
 
     /**
-     * Sets the generation and strictness level of the PDF/A that must be followed.
-     * Required parameter, when converting to pdf/a one have to specify an explicit pdf/a conformance.
+     * Gets the generation and strictness level of the PDF/A that must be followed.
      *
-     * @param conformance a {@link PdfAConformance} constant
+     * @return pdf/a conformance
+     */
+    public PdfAConformance getPdfAConformance() {
+        return conformance.getAConformance();
+    }
+
+    /**
+     * Sets the generation and strictness level of the PDF/A that must be followed.
+     * Required parameter, when converting to pdf/a one has to specify an explicit pdf/a conformance.
      *
+     * @param aConformance a {@link PdfAConformance} constant
      * @return the {@link ConverterProperties} instance
      */
-    public ConverterProperties setPdfAConformance(PdfAConformance conformance) {
-        this.aConformance = conformance;
+    public ConverterProperties setPdfAConformance(PdfAConformance aConformance) {
+        this.conformance = new PdfConformance(aConformance, conformance.getUAConformance());
         return this;
     }
 
     /**
-     * Gets pdf document output intent (final destination device) to reproduce the color in the PDF.
+     * Gets the generation and strictness level of the PDF/UA that must be followed.
      *
-     * <p>
-     * Note, output intent isn't applicable for HtmlConverter#convertToElements methods
-     * (e.g. {@link HtmlConverter#convertToElements(InputStream, ConverterProperties)})
-     *
-     * @return pdf output intent
+     * @return The PDF/UA conformance level.
      */
-    public PdfOutputIntent getDocumentOutputIntent() {
-        return outputIntent;
+    public PdfUAConformance getPdfUaConformance() {
+        return conformance.getUAConformance();
     }
 
     /**
-     * Gets the generation and strictness level of the PDF/A that must be followed.
+     * Sets the generation and strictness level of the PDF/UA that must be followed.
+     * Required parameter, when converting to PDF/UA one has to specify an explicit PDF/UA conformance.
      *
-     * @return pdf/a conformance
+     * @param uaConformance a {@link PdfUAConformance} constant
+     * @return the {@link ConverterProperties} instance
      */
-    public PdfAConformance getPdfAConformance() {
-        return aConformance;
+    public ConverterProperties setPdfUAConformance(PdfUAConformance uaConformance) {
+        this.conformance = new PdfConformance(conformance.getAConformance(), uaConformance);
+        return this;
     }
 
     /**