com.tivoli.pd.rgy.ldap
Class LdapRgyRegistryFactory

java.lang.Object
  com.tivoli.pd.rgy.ldap.LdapRgyRegistryFactory

public class LdapRgyRegistryFactory
extends java.lang.Object

Creates an instance of RgyRegistry that operates on LDAP registries.

Method Summary

static RgyRegistry	getLdapRgyRegistryInstance(java.util.Properties properties, java.util.Map<java.lang.String,java.lang.Object> enhancements) Creates a unique instance of LdapRgyRegistry each invocation configured using the supplied properties and enhancements.
static RgyRegistry	getLdapRgyRegistryInstance(java.net.URL propertiesUrl, java.util.Map<java.lang.String,java.lang.Object> enhancements) Creates a unique instance of LdapRgyRegistry each invocation configured using the supplied properties file and enhancements.
static RgyRegistry	getRgyRegistryInstance(java.net.URL propertiesUrl, java.util.Map<java.lang.String,java.lang.Object> enhancements) Each invocation of this method creates a unique instance of LdapRgyRegistry, and if authorization or auditing is enabled it will create and wrap it with an AuthzRgyRegistry instance to provide authorization and/or auditing.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getLdapRgyRegistryInstance

public static RgyRegistry getLdapRgyRegistryInstance(java.util.Properties properties,
                                                     java.util.Map<java.lang.String,java.lang.Object> enhancements)
                                              throws RgyException

Creates a unique instance of LdapRgyRegistry each invocation configured using the supplied properties and enhancements. This method ignores any authorization and audit settings.

Parameters:

properties - Contains the properties required to configure an LDAP RgyRegistry instance.

enhancements - Unused, null is acceptable.

Returns:

Instance of an implementation of RgyRegistry. When no longer required, the RgyRegistry.close() method should be invoked.

Throws:

ConfigurationErrorRgyException - if the registry could not be configured.

RgyException

getLdapRgyRegistryInstance

public static RgyRegistry getLdapRgyRegistryInstance(java.net.URL propertiesUrl,
                                                     java.util.Map<java.lang.String,java.lang.Object> enhancements)
                                              throws RgyException

Creates a unique instance of LdapRgyRegistry each invocation configured using the supplied properties file and enhancements. This method ignores any authorization and audit settings.

Parameters:

propertiesUrl - Contains the properties required to configure an LDAP RgyRegistry instance.

enhancements - Unused, null is acceptable.

Returns:

Instance of an implementation of RgyRegistry. When no longer required, the RgyRegistry.close() method should be invoked.

Throws:

ConfigurationErrorRgyException - if the registry could not be configured.

RgyException

getRgyRegistryInstance

public static RgyRegistry getRgyRegistryInstance(java.net.URL propertiesUrl,
                                                 java.util.Map<java.lang.String,java.lang.Object> enhancements)
                                          throws RgyException

Each invocation of this method creates a unique instance of LdapRgyRegistry, and if authorization or auditing is enabled it will create and wrap it with an AuthzRgyRegistry instance to provide authorization and/or auditing. If authorization is enabled, only one instance can be generated at a time due to the limitations of PDAuthorizationContext. RgyRegistry.close() must be called before another instance can be generated.

Parameters:

propertiesUrl - file containing the properties required to configure an LDAP RgyRegistry and Authorization/Audit RgyRegistry instance. If authorization is enabled, it must also contain the required configuration properties for creating a PDAuthorizationContext.

enhancements - Unused, null is acceptable.

Returns:

Instance of an implementation of RgyRegistry. When no longer required, the RgyRegistry.close() method should be invoked.

Throws:

ConfigurationErrorRgyException - if the registry could not be configured.

RgyException