Rendering Rights-Enabled Forms

Include project files

Include client JAR files, such as adobe-forms-client.jar, in your Java project’s class path.

Create a Forms Client API object

• Create a ServiceClientFactory object that contains connection properties.
• Create an FormsServiceClient object by using its constructor and passing the ServiceClientFactory object.

Set usage rights run-time options

• Create a ReaderExtensionSpec object by using its constructor.
• Specify the alias of the credential by invoking the ReaderExtensionSpec object’s setReCredentialAlias method and specify a string value that represents the alias value.
• Set each usage right by invoking the corresponding method that belongs to the ReaderExtensionSpec object. However, you can only set a usage right if the credential that you reference lets you do so. That is, you cannot set a usage right if the credential does not let you set it. For example. to set the usage right that enables a user to fill in form fields and save the form, invoke the ReaderExtensionSpec object’s setReFillIn method and pass true.

NOTE

It is not necessary to invoke the ReaderExtensionSpec object’s setReCredentialPassword method. This method is not used by the Forms service.

Render a rights-enabled form

Invoke the FormsServiceClient object’s renderPDFFormWithUsageRights method and pass the following values:

• A string value that specifies the form design name, including the file name extension. If you reference a form design that is part of a Forms application, ensure that you specify the complete path, such as Applications/FormsApplication/1.0/FormsFolder/Loan.xdp.
• A com.adobe.idp.Document object that contains data to merge with the form. If you do not want to merge data, pass an empty com.adobe.idp.Document object.
• A PDFFormRenderSpec object that stores run-time options.
• A ReaderExtensionSpec object that stores usage rights run-time options.
• A URLSpec object that contains URI values that are required by the Forms service.

The renderPDFFormWithUsageRights method returns a FormsResult object that contains a form data stream that must be written to the client web browser.

Write the form data stream to the client web browser

• Create a com.adobe.idp.Document object by invoking the FormsResult object 's getOutputContent method.
• Get the content type of the com.adobe.idp.Document object by invoking its getContentType method.
• Set the javax.servlet.http.HttpServletResponse object’s content type by invoking its setContentType method and passing the content type of the com.adobe.idp.Document object.
• Create a javax.servlet.ServletOutputStream object used to write the form data stream to the client web browser by invoking the javax.servlet.http.HttpServletResponse object’s getOutputStream method.
• Create a java.io.InputStream object by invoking the com.adobe.idp.Document object’s getInputStream method.
• Create a byte array populate it with the form data stream by invoking the InputStream object’s read method and passing the byte array as an argument.
• Invoke the javax.servlet.ServletOutputStream object’s write method to send the form data stream to the client web browser. Pass the byte array to the write method.