Quick Start (EJB mode): Adding users using the Java API

The following code example adds a user named Wendy Blue to LiveCycle. (See Adding Users.)

/* 
    * This Java Quick Start uses the EJB mode and contains the following JAR files 
    * in the class path: 
    * 1. adobe-livecycle-client.jar 
    * 2. adobe-usermanager-client.jar 
    * 3. adobe-utilities.jar 
    * 4. jbossall-client.jar (use a different JAR file if the LiveCycle server is not deployed 
    * on JBoss) 
    * 5. jacorb.jar (use a different JAR file if the LiveCycle server is not deployed on JBoss) 
    * 6. 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.util.*; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory; 
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties; 
import com.adobe.livecycle.usermanager.client.DirectoryManagerServiceClient; 
import com.adobe.idp.um.api.infomodel.impl.*; 
import com.adobe.idp.um.api.infomodel.*; 
 
public class AddUser { 
 
    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 object 
            ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps); 
 
            //Create an DirectoryManagerServiceClient object 
            DirectoryManagerServiceClient dmClient = new DirectoryManagerServiceClient(myFactory); 
             
            //Create a User object and populate its attributes  
            UserImpl u = new UserImpl(); 
            u.setDomainName("DefaultDom");  
            u.setUserid("wblue");  
            u.setCanonicalName("wblue");  
            u.setPrincipalType("USER");  
            u.setGivenName("Wendy");  
            u.setFamilyName("Blue");  
            u.setLocale(Locale.CANADA); 
            u.setTimezone(TimeZone.getDefault()); 
            u.setDisabled(false); 
             
            //Add the User to the system using the DirectoryManagerServiceClient 
            dmClient.createLocalUser(u,"password"); 
             
            //Ensure that the user was added  
            //Create a PrincipalSearchFilter to find the user by ID 
            PrincipalSearchFilter psf = new PrincipalSearchFilter(); 
            psf.setUserId("wblue"); 
            List<User> principalList = dmClient.findPrincipals(psf); 
            Iterator<User> pit = principalList.iterator(); 
            if(pit.hasNext()){ 
                User theUser = pit.next(); 
                System.out.println("User ID: " + theUser.getUserid()); 
                System.out.println("User name: " + theUser.getGivenName() +" "+ theUser.getFamilyName()); 
                System.out.println("User Domain: " + theUser.getDomainName()); 
                System.out.println("is user disabled?: " + theUser.isDisabled()); 
            } 
             
        }catch (Exception e) { 
            e.printStackTrace(); 
        } 
; 
    } 
 
}