Add method to set writer property PDF/UA

Set PDF/UA version flags ONLY when user manually  sets this flag with writer propeties.

DEVSIX-629

Author: LodrKumquat

kernel/src/main/java/com/itextpdf/kernel/pdf/PdfDocument.java

@@ -1845,7 +1845,7 @@ protected XMPMeta updateDefaultXmpMetadata() throws XMPException {
         XMPMeta xmpMeta = XMPMetaFactory.parseFromBuffer(getXmpMetadata(true));
         XmpMetaInfoConverter.appendDocumentInfoToMetadata(info, xmpMeta);
 
-        if (isTagged() && !isXmpMetaHasProperty(xmpMeta, XMPConst.NS_PDFUA_ID, XMPConst.PART)) {
+        if (isTagged() && writer.properties.pdfUA && !isXmpMetaHasProperty(xmpMeta, XMPConst.NS_PDFUA_ID, XMPConst.PART)) {
             xmpMeta.setPropertyInteger(XMPConst.NS_PDFUA_ID, XMPConst.PART, 1, new PropertyOptions(PropertyOptions.SEPARATE_NODE));
         }
 

kernel/src/main/java/com/itextpdf/kernel/pdf/WriterProperties.java

@@ -64,6 +64,7 @@ public class WriterProperties implements Serializable {
     protected boolean smartMode;
     protected boolean debugMode;
     protected boolean addXmpMetadata;
+    protected boolean pdfUA;
     protected PdfVersion pdfVersion;
     protected EncryptionProperties encryptionProperties;
     /**
@@ -79,6 +80,7 @@ public class WriterProperties implements Serializable {
     public WriterProperties() {
         smartMode = false;
         debugMode = false;
+        pdfUA = false;
         compressionLevel = CompressionConstants.DEFAULT_COMPRESSION;
         isFullCompression = null;
         encryptionProperties = new EncryptionProperties();
@@ -182,7 +184,7 @@ public WriterProperties setStandardEncryption(byte[] userPassword, byte[] ownerP
      * <p>
      * @param certs               the public certificates to be used for the encryption
      * @param permissions         the user permissions for each of the certificates
-     * @param encryptionType the type of encryption. It can be one of {@link EncryptionConstants#STANDARD_ENCRYPTION_40},
+     * @param encryptionAlgorithm the type of encryption. It can be one of {@link EncryptionConstants#STANDARD_ENCRYPTION_40},
      * {@link EncryptionConstants#STANDARD_ENCRYPTION_128}, {@link EncryptionConstants#ENCRYPTION_AES_128}
      *                       or {@link EncryptionConstants#ENCRYPTION_AES_256}.
      *                       Optionally {@link EncryptionConstants#DO_NOT_ENCRYPT_METADATA} can be ORed to output the metadata in cleartext
@@ -234,6 +236,18 @@ public WriterProperties useDebugMode() {
         return this;
     }
 
+    /**
+     * This method marks the document as PDF/UA and sets related flags is XMPMetaData.
+     * NOTE: iText does not validate PDF/UA, which means we don't check if created PDF meets all PDF/UA requirements.
+     * Don't use this method if you are not familiar with PDF/UA specification in order to avoid creation of non-conformant PDF/UA file.
+     *
+     * @return this {@code WriterProperties} instance
+     */
+    public WriterProperties setPdfUA() {
+        this.pdfUA = true;
+        return this;
+    }
+
     boolean isStandardEncryptionUsed() {
         return encryptionProperties.isStandardEncryptionUsed();
     }