Example - Examples for Obtaining a Login Environment

//login with minimum required information
final String AIS_SERVER = "http://ais.example.com:7777";
final String USER_NAME = "jde";
final String PASSWORD = "jde";
final String DEVICE = "Java";
LoginEnvironment  loginEnv = new LoginEnvironment(AIS_SERVER, USER_NAME, PASSWORD, DEVICE);
 
//login overrides default environment and role
final String ENVIRONMENT = "PROD";
final String ROLE = "PROLE";
LoginEnvironment  loginEnv2 = new LoginEnvironment(AIS_SERVER, USER_NAME, PASSWORD, ENVIRONMENT, ROLE, DEVICE);
 
//login with required capabilities
//A CapabilityException will be thrown if AIS doesn't have those in the list
final String REQ_CAPABILITIES = "grid, processingOption";
LoginEnvironment  loginEnv3 = new LoginEnvironment(AIS_SERVER, USER_NAME, PASSWORD, DEVICE, REQ_CAPABILITIES);
 
//login with token
String PS_TOKEN = "a ps token string";
LoginEnvironment  loginEnv4 = new LoginEnvironment(AIS_SERVER, USER_NAME, null, null, null, DEVICE, null, null, PS_TOKEN) 

All calls to the AIS Server include the LoginEnvironment object. From this point forward in this guide, references to the loginEnv variable assume that this step has been performed and that the variable is available.