com.ibm.itim.apps
Class InitialPlatformContext

java.lang.Object
  |
  +--com.ibm.itim.apps.InitialPlatformContext
All Implemented Interfaces:
PlatformContext

public class InitialPlatformContext
extends java.lang.Object
implements PlatformContext

Provides a starting point for establishing a platform context. This class will establish the context using the PlatformContextFactory class provided in the context environment parameter.


Field Summary
static java.lang.String CONTEXT_FACTORY
          PlatformContextFactory class property name.
 
Fields inherited from interface com.ibm.itim.apps.PlatformContext
PLATFORM_CREDENTIALS, PLATFORM_PRINCIPAL, PLATFORM_URL
 
Constructor Summary
InitialPlatformContext(java.util.Hashtable env)
          Constructs a platform context with the given environment.
 
Method Summary
 void close()
          Closes the platform context, freeing up any system resources that may have been allocated for the context.
 java.util.Hashtable getEnvironment()
          Returns the environment the client used to define the context.
 java.lang.Object getEnvProperty(java.lang.Object propertyName)
          Returns the environment property with the given name.
 java.lang.Long getID()
          Returns the unique identifier of the platform context.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

CONTEXT_FACTORY

public static final java.lang.String CONTEXT_FACTORY
PlatformContextFactory class property name. The value of the constant is enrole.platform.contextFactory. This string must be present in the enRole.properties file if creating the context using the properties file environment option.

See Also:
Constant Field Values
Constructor Detail

InitialPlatformContext

public InitialPlatformContext(java.util.Hashtable env)
                       throws java.rmi.RemoteException,
                              ApplicationException
Constructs a platform context with the given environment. The environment must hold the PlatformContextFactory class name and all other required parameters as specified in the PlatformContext interface.

Parameters:
env - the environment used to create the InitialPlatformContext.
Throws:
java.rmi.RemoteException - if unable to establish the context.
ApplicationException - if unable to establish the context.
Method Detail

getEnvironment

public java.util.Hashtable getEnvironment()
Returns the environment the client used to define the context.

Specified by:
getEnvironment in interface PlatformContext
Returns:
Hashtable holding the environment parameters.

getEnvProperty

public java.lang.Object getEnvProperty(java.lang.Object propertyName)
Returns the environment property with the given name.

Specified by:
getEnvProperty in interface PlatformContext
Parameters:
propertyName - Name of the property to retrieve.
Returns:
Object representing the property value.

getID

public java.lang.Long getID()
Returns the unique identifier of the platform context. This identitifer is generated and used by the identity platform itself.

Specified by:
getID in interface PlatformContext
Returns:
Long - Unique ID of the context.

close

public void close()
Closes the platform context, freeing up any system resources that may have been allocated for the context. Failure to close platform contexts may result in the resource unavailability and the degredation of performance over time.

Specified by:
close in interface PlatformContext


IBM Tivoli Identity Manager 4.6
© Copyright International Business Machines Corporation 2005. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.