Quick Start (EJB mode): Revoking a document using the Java API

The following Java code example revokes a policy-protected document named PolicyProtectedLoanDoc.pdf. A revised PDF document is located at the following URL location http://localhost:8080/RightsManagement/UpdatedLoan.pdf. (See Revoking Access to Documents.)

/* 
    * This Java Quick Start uses the EJB mode and contains the following JAR files 
    * in the class path: 
    * 1. adobe-rightsmanagement-client.jar 
    * 2. namespace.jar (if the LiveCycle server is deployed on JBoss) 
    * 3. jaxb-api.jar (if the LiveCycle server is deployed on JBoss) 
    * 4. jaxb-impl.jar (if the LiveCycle server is deployed on JBoss) 
    * 5. jaxb-libs.jar (if the LiveCycle server is deployed on JBoss) 
    * 6. jaxb-xjc.jar (if the LiveCycle server is deployed on JBoss) 
    * 7. relaxngDatatype.jar (if the LiveCycle serverS is deployed on JBoss) 
    * 8. xsdlib.jar (if the LiveCycle server is deployed on JBoss) 
    * 9. adobe-livecycle-client.jar 
    * 10. adobe-usermanager-client.jar 
    * 11. adobe-utilities.jar 
    * 12. jbossall-client.jar (use a different JAR file if the LiveCycle server is not deployed on JBoss) 
    * 13. jacorb.jar (use a different JAR file if the LiveCycle server is not deployed on JBoss) 
    * 14. jnp-client.jar (use a different JAR file if the LiveCycle server is not deployed on JBoss) 
    *  
    *  The JBoss files must be kept in the jboss\client folder. You can copy the client folder to  
    *  your local development environment and then include the 3 JBoss JAR files in your class path 
    *   
    *  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 
    *  
    * 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 additional JAR files located in the following  
    * path 
    * <install directory>/sdk/client-libs/thirdparty 
    *  
    * For information about the SOAP  
    * mode and the additional JAR files that need to be included,  
    * see "Setting connection properties" in Programming  
    * with LiveCycle 
    *  
    * For complete details about the location of the LiveCycle JAR files,  
    * see "Including LiveCycle Java library files" in Programming  
    * with LiveCycle 
    */ 
import java.io.FileInputStream; 
import java.util.*; 
 
import com.adobe.idp.Document; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties; 
 
import java.net.URL; 
 
import com.adobe.livecycle.rightsmanagement.client.*; 
import com.adobe.livecycle.rightsmanagement.client.infomodel.*; 
 
 
public class RevokeDocument { 
 
    public static void main(String[] args) { 
         
        try 
        { 
        //Set connection properties required to invoke LiveCycle                                 
        Properties connectionProps = new Properties(); 
        connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://hiro-xp:1099"); 
        connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_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 instance 
        ServiceClientFactory factory = ServiceClientFactory.createInstance(connectionProps); 
         
        //Create a RightsManagementClient object 
        RightsManagementClient rightsClient = new RightsManagementClient(factory);  
         
        //Reference a policy-protected PDF document to revoke 
        FileInputStream is = new FileInputStream("C:\\Adobe\PolicyProtectedLoanDoc.pdf"); 
        Document inPDF = new Document(is); 
         
        //Create a Document Manager object  
        DocumentManager  documentManager = rightsClient.getDocumentManager(); 
                 
        //Obtain the license identifier value of the policy-protected document  
        String revokeLic = documentManager.getLicenseId(inPDF); 
                 
        //Create a LicenseManager object 
        LicenseManager licManager = rightsClient.getLicenseManager(); 
                 
        //Specify the URL to where an updated document is located 
        URL myURL = new URL("http://localhost:8080/RightsManagement/UpdatedLoan.pdf"); 
                 
        //Revoke the policy-protected PDF document 
        licManager.revokeLicense(revokeLic, License.DOCUMENT_REVISED, myURL);  
        } 
     catch (Exception ee) 
       { 
            ee.printStackTrace();  
       } 
    } 
} 

// Ethnio survey code removed