Quick Start (SOAP mode): Rendering a rights-enabled form using the Java API

The following code example renders a rights-enabled form to a client web browser. The usage rights set in this code example enable a user to add comments in the form and save form data. (See Rendering Rights-Enabled Forms.)

/* 
    * This Java Quick Start uses the following JAR files 
    * 1. adobe-forms-client.jar 
    * 2. adobe-livecycle-client.jar 
    * 3. adobe-usermanager-client.jar 
    * 4. activation.jar (required for SOAP mode) 
    * 5. axis.jar (required for SOAP mode) 
    * 6. commons-codec-1.3.jar (required for SOAP mode) 
    * 7. commons-collections-3.2.jar  (required for SOAP mode) 
    * 8. commons-discovery.jar (required for SOAP mode) 
    * 9. commons-logging.jar (required for SOAP mode) 
    * 10. dom3-xml-apis-2.5.0.jar (required for SOAP mode) 
    * 11. jaxen-1.1-beta-9.jar (required for SOAP mode) 
    * 12. jaxrpc.jar (required for SOAP mode) 
    * 13. log4j.jar (required for SOAP mode) 
    * 14. mail.jar (required for SOAP mode) 
    * 15. saaj.jar (required for SOAP mode) 
    * 16. wsdl4j.jar (required for SOAP mode) 
    * 17. xalan.jar (required for SOAP mode) 
    * 18. xbean.jar (required for SOAP mode) 
    * 19. xercesImpl.jar (required for SOAP mode) 
    *  
    *  (Because Forms quick starts are implemented as Java servlets, it is  
    *  not necessary to include J2EE specific JAR files - the Java project 
    *  that contains this quick start is exported as a WAR file which 
    *  is deployed to the J2EE application server) 
    *   
    *  These JAR files are located in the following path: 
    * <install directory>/sdk/client-libs/common 
    *  
    * For complete details about the location of these JAR files,  
    * see "Including AEM Forms library files" in Programming with AEM forms 
    */ 
import java.io.IOException; 
import javax.servlet.Servlet; 
import javax.servlet.ServletException; 
import javax.servlet.ServletOutputStream; 
import javax.servlet.http.HttpServlet; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
import com.adobe.livecycle.formsservice.client.*; 
import java.util.*; 
import java.io.InputStream; 
import com.adobe.idp.Document; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties; 
 
 
public class RenderUsageRightsForms extends HttpServlet implements Servlet { 
 
    public void doGet(HttpServletRequest req, HttpServletResponse resp) 
        throws ServletException, IOException { 
            doPost(req,resp); 
    } 
 
    public void doPost(HttpServletRequest req, HttpServletResponse resp) 
        throws ServletException, IOException { 
             
    try{ 
        //Set connection properties required to invoke AEM Forms                                 
        Properties connectionProps = new Properties(); 
        connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "jnp://[server]:[port]"); 
        connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);           
        connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss"); 
        connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator"); 
        connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password"); 
             
        //Create a FormsServiceClient object 
        ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps); 
        FormsServiceClient formsClient = new FormsServiceClient(myFactory);  
         
        //Set parameter values for the renderPDFFormWithUsageRights method 
        String formName = "Applications/FormsApplication/1.0/FormsFolder/Loan.xdp";  
        byte[]    cData = "".getBytes(); 
        Document oInputData = new Document(cData); 
         
        //Set run-time options 
        PDFFormRenderSpec pdfFormRenderSpec = new PDFFormRenderSpec(); 
        pdfFormRenderSpec.setCacheEnabled(new Boolean(true)); 
         
        //Set usage-rights run-time options 
        ReaderExtensionSpec reOptions = new ReaderExtensionSpec(); 
        reOptions.setReCredentialAlias("RE2"); 
        reOptions.setReCommenting(true); 
        reOptions.setReFillIn(true); 
         
        //Specify URI values required to render the form 
        URLSpec uriValues = new URLSpec();  
        uriValues.setApplicationWebRoot("http://[server]:[port]/FormsQS"); 
        uriValues.setContentRootURI("repository:///"); 
        uriValues.setTargetURL("http://[server]:[port]/FormsQS/HandleData"); 
         
        //Render a rights-enabled PDF form 
        FormsResult formOut = formsClient.renderPDFFormWithUsageRights( 
            formName,            //formQuery 
            oInputData,          //inDataDoc  
            pdfFormRenderSpec,   //renderFormOptionsSpec 
            reOptions,              //applicationWebRoot 
            uriValues            //targetURL 
            ); 
         
        //Create a Document object that stores form data 
        Document myData = formOut.getOutputContent(); 
         
        //Get the content type of the response and 
        //set the HttpServletResponse objects content type 
        String contentType = myData.getContentType();  
        resp.setContentType(contentType); 
         
        //Create a ServletOutputStream object 
        ServletOutputStream oOutput = resp.getOutputStream(); 
         
        //Create an InputStream object 
        InputStream inputStream = myData.getInputStream(); 
         
        //Write the data stream to the web browser 
        byte[] data = new byte[4096]; 
        int bytesRead = 0; 
        while ((bytesRead = inputStream.read(data)) > 0) 
        { 
            oOutput.write(data, 0, bytesRead); 
        } 
         
    }catch (Exception e) { 
         System.out.println("The following exception occurred: "+e.getMessage()); 
      } 
    } 
} 
 

// Ethnio survey code removed