Quick Start (SOAP mode):Applying usage rights using the Java API

The following Java code example applies usage rights to a PDF document named Loan.pdf. The rights-enabled PDF document is saved as a PDF file named LoanUsageRights.pdf. The following usage rights are applied to this PDF document: enabledComments, enabledFormFillIn, and enabledDigitalSignatures. (See Applying Usage Rights to PDF Documents.)

/* 
    * This Java Quick Start uses the SOAP mode and contains the following JAR files 
    * in the class path: 
    * 1. adobe-reader-extensions-client.jar 
    * 2. adobe-livecycle-client.jar 
    * 3. adobe-usermanager-client.jar 
    * 4. adobe-utilities.jar 
    * 5. jbossall-client.jar (use a different JAR file if the LiveCycle server is not deployed 
    * on JBoss) 
    * 6. activation.jar (required for SOAP mode) 
    * 7. axis.jar (required for SOAP mode) 
    * 8. commons-codec-1.3.jar (required for SOAP mode) 
    * 9.  commons-collections-3.1.jar  (required for SOAP mode) 
    * 10. commons-discovery.jar (required for SOAP mode) 
    * 11. commons-logging.jar (required for SOAP mode) 
    * 12. dom3-xml-apis-2.5.0.jar (required for SOAP mode) 
    * 13. jaxen-1.1-beta-9.jar (required for SOAP mode) 
    * 14. jaxrpc.jar (required for SOAP mode) 
    * 15. log4j.jar (required for SOAP mode) 
    * 16. mail.jar (required for SOAP mode) 
    * 17. saaj.jar (required for SOAP mode) 
    * 18. wsdl4j.jar (required for SOAP mode) 
    * 19. xalan.jar (required for SOAP mode) 
    * 20. xbean.jar (required for SOAP mode) 
    * 21. xercesImpl.jar (required for SOAP mode) 
    *  
    *  These JAR files are located in the following path: 
    * <install directory>/sdk/client-libs/common 
    *  
    * The adobe-utilities.jar file is located in the following path: 
    * <install directory>/sdk/client-libs/jboss 
    *  
    * The jbossall-client.jar file is located in the following path: 
    * <install directory>/jboss/client 
    *  
    * SOAP required JAR files are located in the following path: 
    * <install directory>/sdk/client-libs/thirdparty 
    *  
    * If you want to invoke a remote LiveCycle server instance and there is a 
    * firewall between the client application and the server, then it is  
    * recommended that you use the SOAP mode. When using the SOAP mode,  
    * you have to include these additional JAR files 
    *  
    * For information about the SOAP  
    * mode, see "Setting connection properties" in Programming  
    * with LiveCycle 
    */ 
import com.adobe.livecycle.readerextensions.client.*; 
import java.util.*; 
import java.io.File; 
import java.io.FileInputStream; 
import com.adobe.idp.Document; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties; 
 
public class ApplyUsageRightsSOAP{ 
 
    public static void main(String[] args) { 
      try{ 
                  
          //Set connection properties required to invoke LiveCycle using SOAP mode                                 
          Properties connectionProps = new Properties(); 
          connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "http://hiro-xp:8080"); 
         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 ServiceClientFactory object 
          ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps); 
         
          //Create a ReaderExtensionsServiceClient object 
          ReaderExtensionsServiceClient reClient = new ReaderExtensionsServiceClient(myFactory);  
         
          //Retrieve the PDF document to which to apply usage rights 
          FileInputStream fileInputStream = new FileInputStream("C:\\Adobe\Loan.pdf");  
          Document inputPDF = new Document(fileInputStream); 
                  
          //Create a UsageRight object and specify specific usage rights 
          UsageRights useRight = new UsageRights();  
          useRight.setEnabledDynamicFormFields(true); 
          useRight.setEnabledComments(true); 
          useRight.setEnabledFormFillIn(true); 
          useRight.setEnabledDigitalSignatures(true); 
         
          //Create a ReaderExtensionsOptions object 
          ReaderExtensionsOptionSpec reOptions = new ReaderExtensionsOptionSpec();  
                  
          //Set the usage rights  
          reOptions.setUsageRights(useRight);  
          reOptions.setMessage("This is a Rights-Enabled PDF Document"); 
         
          //Apply usage rights to a PDF document 
          Document rightsEnabledPDF = reClient.applyUsageRights( 
             inputPDF, 
             "RE2", 
            null, 
            reOptions);  
         
          //Create a new PDF file that represents the rights-enabled PDF document 
          File resultFile = new File("C:\\Adobe\LoanUsageRights.pdf");  
          rightsEnabledPDF.copyToFile(resultFile); 
                         
        }catch (Exception e) { 
             e.printStackTrace(); 
        }     
    } 
}