public final class AccessClient
extends java.lang.Object
Implements methods that allow applications to initialize the Access Server API Client.
The initialization functions are used to:
The AccessClient class includes class methods to indicate the location of a properties configuration file, to initialize the Access Server API from the XML configuration file and to retrieve a value of a configuration item.
Modifier and Type | Class and Description |
---|---|
static class |
AccessClient.CompatibilityMode |
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
CFG_DEBUG_VALUE |
static java.lang.String |
CFG_ENCRYPTED_PASSWORD |
static java.lang.String |
CFG_KEYSTORE |
static java.lang.String |
CFG_PASSPHRASE |
static java.lang.String |
CFG_POOL_TIMEOUT |
static java.lang.String |
CFG_PRIMARY_SERVER_LIST |
static java.lang.String |
CFG_SEC_SERVER_LIST |
static java.lang.String |
CFG_SERVER_CONNECTION_READ_TIMEOUT |
static java.lang.String |
CFG_SERVER_HOST |
static java.lang.String |
CFG_SERVER_MAX_CONNS |
static java.lang.String |
CFG_SERVER_PORT |
static java.lang.String |
CFG_TCP_CONNECT_TIMEOUT |
static java.lang.String |
CFG_TRANSPORT_SECURITY |
static java.lang.String |
CFG_TRUSTSTORE |
static java.lang.String |
CFG_USER_DEF_VALS |
static java.lang.String |
CFG_WEBGATE_ID |
Modifier and Type | Method and Description |
---|---|
static AccessClient |
createDefaultInstance()
Returns a reference to a Singleton object of AccessClient.
|
static AccessClient |
createDefaultInstance(AccessClient.CompatibilityMode mode)
Returns a reference to a Singleton object of AccessClient.
|
static AccessClient |
createDefaultInstance(java.util.Hashtable bootstrapConfig,
AccessClient.CompatibilityMode mode,
ConfigUpdateCallback confupdtcallbk)
Returns a reference to a Singleton object of AccessClient.
|
static AccessClient |
createDefaultInstance(java.util.Hashtable bootstrapConfig,
ConfigUpdateCallback confupdtcallbk)
Returns a reference to a Singleton object of AccessClient.
|
static AccessClient |
createDefaultInstance(java.lang.String configLocation)
Returns a reference to a Singleton object of AccessClient.
|
static AccessClient |
createDefaultInstance(java.lang.String configLocation,
AccessClient.CompatibilityMode mode)
Returns a reference to a Singleton object of AccessClient.
|
static AccessClient |
createInstance(java.util.Hashtable bootstrapConfig,
java.lang.String loggerName,
AccessClient.CompatibilityMode mode,
ConfigUpdateCallback confupdtcallbk)
Creates a new instance of AccessClient.
|
static AccessClient |
createInstance(java.util.Hashtable bootstrapConfig,
java.lang.String loggerName,
ConfigUpdateCallback confupdtcallbk)
Returns a reference to a new object of AccessClient (using default
OAM_11G compatibility mode).
|
static AccessClient |
createInstance(java.lang.String loggerName)
Returns a reference to a new object of AccessClient (using default
OAM_11G compatibility mode).
|
static AccessClient |
createInstance(java.lang.String loggerName,
AccessClient.CompatibilityMode mode)
Returns a reference to a new object of AccessClient.
|
static AccessClient |
createInstance(java.lang.String configLocation,
java.lang.String loggerName)
Returns a reference to a new object of AccessClient (using default
OAM_11G compatibility mode).
|
static AccessClient |
createInstance(java.lang.String configLocation,
java.lang.String loggerName,
AccessClient.CompatibilityMode mode)
Returns a reference to a new object of AccessClient.
|
protected oracle.security.am.asdk.impl.AccessCacheManagerImpl |
getCacheManager()
Returns cache manager instance
|
protected ObAAAServiceClient |
getClient() |
java.util.Hashtable |
getClientDiagnosticInfo()
Returns the diagnostic information about the connectivity to OAM 10g
servers including host, port, time since when the connection is established
and the server state.
|
protected oracle.security.am.asdk.impl.Configuration |
getConfig() |
java.util.Hashtable |
getConfigDifference()
Returns the difference or changes occurred in configurations after
configuration update.
|
java.util.Hashtable |
getConfigurations()
Returns all the configuration settings from the configuration file before
connecting to the server, or the configuration fetched from the server
|
static AccessClient |
getDefaultInstance()
Returns a reference to the Singleton object of AccessClient;
if already created.
|
java.util.Hashtable |
getDirectoryDiagnosticInfo()
Returns the directory diagnostic information from the OAM 10g servers
about the Directory Servers used to store User, Policy, Config information.
|
java.lang.String |
getInstanceNAPVersion()
Returns Oracle Access Protocol version of the current AccessClient
instance.
|
protected java.lang.String |
getLocation() |
protected java.util.logging.Logger |
getLogger()
Returns logger instance
|
ObKeyValMap |
getMapFromUserDefinedParamMapStr(java.lang.String usingKey)
This method can be used to get Map of parameters defined in
"UserDefinedvals" Map which is here serialized as String.
|
static java.lang.String |
getNAPVersion()
Returns Oracle Access Protocol version of the default singleton object
instance.
|
protected ObAAAServiceClient |
getObClient() |
static java.lang.String |
getSDKVersion()
Returns the OAM Access SDK version number.
|
java.util.Hashtable |
getServerDiagnosticInfo()
Returns the diagnostic information from the OAM 10g server containing server
health, host, port, number of connections.
|
boolean |
isInitialized()
Checks if AccessClient is initialized or not.
|
void |
shutdown()
It disconnects client from the OAM server.
|
protected void |
updateLastAccessTime() |
public static final java.lang.String CFG_WEBGATE_ID
public static final java.lang.String CFG_DEBUG_VALUE
public static final java.lang.String CFG_TRANSPORT_SECURITY
public static final java.lang.String CFG_ENCRYPTED_PASSWORD
public static final java.lang.String CFG_PRIMARY_SERVER_LIST
public static final java.lang.String CFG_SEC_SERVER_LIST
public static final java.lang.String CFG_USER_DEF_VALS
public static final java.lang.String CFG_PASSPHRASE
public static final java.lang.String CFG_KEYSTORE
public static final java.lang.String CFG_TRUSTSTORE
public static final java.lang.String CFG_SERVER_HOST
public static final java.lang.String CFG_SERVER_PORT
public static final java.lang.String CFG_SERVER_MAX_CONNS
public static final java.lang.String CFG_POOL_TIMEOUT
public static final java.lang.String CFG_SERVER_CONNECTION_READ_TIMEOUT
public static final java.lang.String CFG_TCP_CONNECT_TIMEOUT
public boolean isInitialized()
public static AccessClient createDefaultInstance(AccessClient.CompatibilityMode mode) throws AccessException
mode
- indicates the compatibility mode to be used by the
AccessClient object.AccessException
- In case of initialization failure.public static AccessClient createDefaultInstance() throws AccessException
AccessException
- In case of initialization failure.public static AccessClient createDefaultInstance(java.lang.String configLocation, AccessClient.CompatibilityMode mode) throws AccessException
configLocation
- indicates the directory location of configuration
file used for initializing the singleton AccessClient object.mode
- indicates the compatibility mode to be used by the
AccessClient object.AccessException
- In case of initialization failure OR there is an
reinitialization attempt detected by invoking with different
configLocation.public static AccessClient createDefaultInstance(java.lang.String configLocation) throws AccessException
configLocation
- indicates the directory location of configuration
file used for initializing the singleton AccessClient object.AccessException
- In case of initialization failure OR there is an
reinitialization attempt detected by invoking with different
configLocation.public static AccessClient createDefaultInstance(java.util.Hashtable bootstrapConfig, AccessClient.CompatibilityMode mode, ConfigUpdateCallback confupdtcallbk) throws AccessException
bootstrapConfig
- hashtable containing configuration variables in
form of key value pairs of String type.
The possible key values are defined as constants in this class.mode
- indicates the compatibility mode to be used by the
AccessClient object.confupdtcallbk
- object implementing the callback interfaceAccessException
- In case of initialization failure OR there is an
reinitialization attempt.public static AccessClient createDefaultInstance(java.util.Hashtable bootstrapConfig, ConfigUpdateCallback confupdtcallbk) throws AccessException
bootstrapConfig
- hashtable containing configuration variables in
form of key value pairs of String type.
The possible key values are defined as constants in this class.confupdtcallbk
- object implementing the callback interfaceAccessException
- In case of initialization failure OR there is an
reinitialization attempt.public final java.util.Hashtable getServerDiagnosticInfo() throws AccessException
AccessException
- If OAM server fails to return the informationpublic final java.util.Hashtable getDirectoryDiagnosticInfo() throws AccessException
AccessException
- If OAM server fails to return the informationpublic final java.util.Hashtable getClientDiagnosticInfo() throws AccessException
AccessException
- If diagnostic information cannot be fetchedpublic static AccessClient createInstance(java.lang.String loggerName, AccessClient.CompatibilityMode mode) throws AccessException
loggerName
- indicates the name with which the Java Logger
object would be created.mode
- indicates the compatibility mode to be used by the
AccessClient object.AccessException
- In case of initialization failure.public static AccessClient createInstance(java.lang.String loggerName) throws AccessException
loggerName
- indicates the name with which the Java Logger
object would be created.AccessException
- In case of initialization failure.public static AccessClient createInstance(java.lang.String configLocation, java.lang.String loggerName, AccessClient.CompatibilityMode mode) throws AccessException
configLocation
- indicates the directory location of configuration
file to be used while initializing the AccessClient object.loggerName
- indicates the name with which the Java Logger
object would be created.mode
- indicates the compatibility mode to be used by the
AccessClient object.AccessException
- In case of initialization failure.public static AccessClient createInstance(java.lang.String configLocation, java.lang.String loggerName) throws AccessException
configLocation
- indicates the directory location of configuration
file to be used while initializing the AccessClient object.loggerName
- indicates the name with which the Java Logger
object would be created.AccessException
- In case of initialization failure.public static AccessClient createInstance(java.util.Hashtable bootstrapConfig, java.lang.String loggerName, AccessClient.CompatibilityMode mode, ConfigUpdateCallback confupdtcallbk) throws AccessException
bootstrapConfig
- Hashtable containing configuration variables in
form of key value pairs of String type.
The possible key values are defined as constants in this class.mode
- indicates the compatibility mode to be used by the
AccessClient object.loggerName
- indicates the name with which the Java Logger
object would be created.confupdtcallbk
- object implementing the callback interfaceAccessException
- In case if bootstrapConfig is null or
provided bootstrapConfig is incompletepublic static AccessClient createInstance(java.util.Hashtable bootstrapConfig, java.lang.String loggerName, ConfigUpdateCallback confupdtcallbk) throws AccessException
bootstrapConfig
- Hashtable containing configuration variables in
form of key value pairs of String type.
The possible key values are defined as constants in this class.loggerName
- indicates the name with which the Java Logger
object would be created.confupdtcallbk
- object implementing the callback interfaceAccessException
- In case if bootstrapConfig is null or
provided bootstrapConfig is incompletepublic java.util.Hashtable getConfigurations() throws AccessException
AccessException
- If method is invoked before successful
initializationpublic ObKeyValMap getMapFromUserDefinedParamMapStr(java.lang.String usingKey) throws AccessException
usingKey
- AccessException
public void shutdown()
public static java.lang.String getNAPVersion()
public java.lang.String getInstanceNAPVersion()
public static java.lang.String getSDKVersion()
public java.util.Hashtable getConfigDifference()
protected ObAAAServiceClient getClient() throws AccessException
AccessException
protected oracle.security.am.asdk.impl.Configuration getConfig() throws AccessException
AccessException
protected java.lang.String getLocation()
protected void updateLastAccessTime()
public static AccessClient getDefaultInstance() throws AccessException
AccessException
- In case if Singleton object of AccessClient is not
created or Singleton AccessClient object initialization fails.protected ObAAAServiceClient getObClient() throws AccessException
AccessException
protected oracle.security.am.asdk.impl.AccessCacheManagerImpl getCacheManager() throws AccessException
AccessException
protected java.util.logging.Logger getLogger()