Quick Start (SOAP mode): Managing users and groups using the Java API

The following code example finds a local user and the local group to which the user belongs. (See Managing Users and Groups.)

/* 
    * This Java Quick Start uses the SOAP mode and contains the following JAR files 
    * in the class path: 
    * 1. adobe-livecycle-client.jar 
    * 2. adobe-usermanager-client.jar 
    * 3. activation.jar (required for SOAP mode) 
    * 4. axis.jar (required for SOAP mode) 
    * 5. commons-codec-1.3.jar (required for SOAP mode) 
    * 6. commons-collections-3.2.jar  (required for SOAP mode) 
    * 7. commons-discovery.jar (required for SOAP mode) 
    * 8. commons-logging.jar (required for SOAP mode) 
    * 9. dom3-xml-apis-2.5.0.jar (required for SOAP mode) 
    * 10. jaxen-1.1-beta-9.jar (required for SOAP mode) 
    * 11. jaxrpc.jar (required for SOAP mode) 
    * 12. log4j.jar (required for SOAP mode) 
    * 13. mail.jar (required for SOAP mode) 
    * 14. saaj.jar (required for SOAP mode) 
    * 15. wsdl4j.jar (required for SOAP mode) 
    * 16. xalan.jar (required for SOAP mode) 
    * 17. xbean.jar (required for SOAP mode) 
    * 18. xercesImpl.jar (required for SOAP mode) 
    *  
    *  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 
    *  
    *  
    * <install directory>/jboss/bin/client 
    *  
    * If you want to invoke a remote forms 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 AEM Forms 
    *  
    * For complete details about the location of the AEM FOrms JAR files,  
    * see "Including LiveCycle Java library files" in Programming  
    * with AEM Forms 
    */ 
import java.util.*; 
 
import com.adobe.idp.um.api.infomodel.*; 
import com.adobe.livecycle.usermanager.client.DirectoryManagerServiceClient; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties; 
 
public class ManageUsersAndGroupsTest 
{ 
    public static void main(String[] args) { 
        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 ServiceClientFactory object 
            ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps); 
 
            // Create an DirectoryManagerServiceClient object 
            DirectoryManagerServiceClient dirClient = new DirectoryManagerServiceClient(myFactory); 
 
            // Find a local user 
            PrincipalSearchFilter psf = new PrincipalSearchFilter(); 
            psf.setUserId("wblue"); 
            List principalList = dirClient.findPrincipals(psf); 
            Iterator pit = principalList.iterator(); 
            String oid = ""; 
            User testUser = null; 
            if (pit.hasNext()) 
            { 
                // Obtain the principal's object identifier 
                testUser = (User)(pit.next()); 
            } 
             
            // Find the local group 
            Set groupMemberships = testUser.getGroupMemberships(); 
            Iterator git = groupMemberships.iterator(); 
            Group localGroup = null; 
            if (git.hasNext()) 
            { 
                // Obtain the group to which the user belongs 
                localGroup = (Group)(git.next()); 
            } 
             
            // Determine the domain and the group to which the local user belongs 
            String verifyCanonicalName = testUser.getCanonicalName(); 
            Domain verifyDomain = dirClient.findDomain(testUser.getDomainName()); 
            String verifyDomainName = verifyDomain.getDomainName(); 
            Group verifyGroup = dirClient.getDomainAsGroup(verifyDomainName); 
            String verifyGroupName = verifyGroup.getCanonicalName(); 
 
            // Print the uniquely identifying information about the user 
            System.out.println("User name: " + verifyCanonicalName); 
            System.out.println("Group name: " + verifyGroupName); 
            System.out.println("Domain names should match: " + verifyDomainName + ", "+ testUser.getDomainName()); 
         
        } 
        catch (Exception e) 
        { 
            System.out.println("Error occurred: " + e.getMessage()); 
        } 
    }  
} 
 
 

// Ethnio survey code removed