CA eTrust SiteMinder Developer's Guide for Java

Java API FlowThere are two types of connection handles in this class:■A default connection handle. A default connection handle:■■■Represents a single instance of an Agent API object.Is static across the process.Allows connections to the Agent API object from both PolicyManagement and DMS clients.You can establish multiple connections to the Policy Server through thesingle Agent API object instance.■A user-defined connection handle. You can create multiple user-definedconnection objects; each one can support multiple connections to thePolicy Server.Establish a Default ConnectionIf you have not already established a connection to the Policy Server, you canrequest an automatic connection. If SiteMinder establishes a connection foryou automatically, it creates a default Java Agent API object and handle.However, if a valid user-defined handle already exists, SiteMinder does notcreate a default object and handle. A user-defined handle takes precedenceover a default handle.To establish a default connection to the Policy Server automatically1. Use the following constructor to create an API connection object:SmApiConnection (boolean bDefaultAgentConnectionboolean disableLoadBalancing)2. In the constructor, set bDefaultAgentConnection to true—for example:SmApiConnection m_defaultConnection =new SmApiConnection(true,false);3. If bDefaultAgentConnection is false, you must explicitly establish theconnection in your client code.18 Developer's Guide for Java