com.adobe.platform.operation.pdfops

Class ProtectPDFOperation

java.lang.Object

com.adobe.platform.operation.pdfops.ProtectPDFOperation

All Implemented Interfaces:

Operation

public class ProtectPDFOperation
extends Object
implements Operation

An operation that converts a PDF file into a password protected PDF file. The password is used for encrypting PDF contents and will be required for viewing the PDF file.

The supported algorithm for encrypting the PDF contents are listed here. The EncryptionAlgorithm enum can be used to set the encryption algorithm.

• AES-128
• AES-256

For AES-128 encryption the user password supports ASCII characters only; allowed minimum length of password is 6 characters and maximum length of password is 32 characters. For AES-256 encryption the user password supports Unicode character set and the maximum length of password is 127 UTF-8 bytes.

Sample Usage:

   ProtectPDFOptions protectPDFOptions = ProtectPDFOptions.passwordProtectOptionsBuilder()
                  .setUserPassword("mypassword")
                  .setEncryptionAlgorithm(EncryptionAlgorithm.AES_128)
                  .build();
   ProtectPDFOperation protectPDFOperation = ProtectPDFOperation.createNew(protectPDFOptions);
   protectPDFOperation.setInput(FileRef.createFromLocalFile("~/Documents/protectOperationInput.pdf",
                                                              ProtectPDFOperation.SupportedSourceFormat.PDF.getMediaType()));
   Credentials credentials = Credentials.serviceAccountCredentialsBuilder().fromFile("pdftools-api-credentials.json").build();
   FileRef result = protectPDFOperation.execute(ExecutionContext.create(credentials));
   result.saveAs("output/protectOperationOutput.pdf");
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ProtectPDFOperation.SupportedSourceFormat Supported source file formats for ProtectPDFOperation.

Method Summary

Modifier and Type	Method and Description
static ProtectPDFOperation	createNew(ProtectPDFOptions protectPDFOptions) Constructs a ProtectPDFOperation instance.
FileRef	execute(ExecutionContext context) Executes this operation synchronously using the supplied context and returns a new FileRef instance for the resulting PDF file.
void	setInput(FileRef sourceFileRef) Sets an input file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createNew

public static ProtectPDFOperation createNew(ProtectPDFOptions protectPDFOptions)

Constructs a ProtectPDFOperation instance.

Parameters:

protectPDFOptions - options for setting User Password (used for encrypting PDF); Cannot be null

Returns:

a new ProtectPDFOperation instance

setInput

public void setInput(FileRef sourceFileRef)

Sets an input file.

Parameters:

sourceFileRef - an input file; can not be null

execute

public FileRef execute(ExecutionContext context)
                throws ServiceApiException,
                       IOException,
                       ServiceUsageException

Executes this operation synchronously using the supplied context and returns a new FileRef instance for the resulting PDF file.

The resulting file may be stored in the system temporary directory (per java.io.tmpdir System property). See FileRef for how temporary resources are cleaned up.

Specified by:

execute in interface Operation

Parameters:

context - the context in which to execute the operation

Returns:

the resulting PDF file

Throws:

ServiceApiException - if an API call results in an error response

IOException - if there is an error in reading either the input source or the resulting PDF file

ServiceUsageException - if service usage limits have been reached or credentials quota has been exhausted