com.ibm.itim.remoteservices.provider
Class ServiceProviderInformation

java.lang.Object
  |
  +--com.ibm.itim.remoteservices.provider.ServiceProviderInformation

All Implemented Interfaces:

java.io.Serializable

public class ServiceProviderInformation

extends java.lang.Object

implements java.io.Serializable

Encapsulates service provider configuration parameters, including properties read from resource definition files. No properties are required, however, several have special meaning in the enrole system. In particular, PROTOCOL_MODE Indicates the mode that the service provider operates in STORE_ACCOUNT_PASSWORD Indicates that the service provider stores the password and uses it for suspending and restoring entities FILTERING_NOT_SUPPORTED indicates whether filtered searches are supported

See Also:

Serialized Form

Field Summary

static java.lang.String	ASYNCHRONOUS Name of a property indicating that the service provider is asynchronous.
static java.lang.String	FILTERING_NOT_SUPPORTED Name for a Property indicates whether filtered searches are supported.
static java.lang.String	PASSWORD_NOT_ALLOWED_ON_RESTORE Name for a property indicating that the password is NOT allowed when the account is restored.
static java.lang.String	PASSWORD_NOT_REQUIRED_ON_RESTORE Name for a property indicating whether the password is required for restoring entities.
static java.lang.String	SERVICE_PROVIDER_FACTORY Deprecated. Use method getServiceProviderFactory().
static java.lang.String	STORE_ACCOUNT_PASSWORD Name for a property indicating that the service provider stores the password and uses it for suspending and restoring entities.
static java.lang.String	SYNCHRONOUS Name of a property indicating that the service provider is synchronous.

Constructor Summary

ServiceProviderInformation(java.lang.String serviceProfileName, java.util.Properties properties)
Creates new ServiceProviderInfo object.

ServiceProviderInformation(java.lang.String serviceProfileName, java.util.Properties properties, java.lang.String serviceProviderFactory)
Creates new ServiceProviderInfo object.

Method Summary

java.lang.String	getCurrentMode() Gets the current communication mode.
java.util.Properties	getProperties() Gets the protocol and behavior properties for the service type
java.lang.String	getServiceProfileName() Gets the name of the service profile
java.lang.String	getServiceProviderFactory() Returns the service provider factory for the service profile: the fully qualified name of the java class.
java.lang.String[]	getSupportedModes() Gets the modes that are supported by this service.
boolean	isFilteringSupported() Property indicates whether filtered searches are supported
boolean	isPasswordAllowedOnRestore() Property indicates that the account password MAY be send when restoring an account.
boolean	isPasswordRequiredOnRestore() Property indicates that the account password is required for restoring accounts.
boolean	isStoreAccountPassword() Deprecated. We not longer ever store the password locally, so the flag should not be used.
void	setCurrentMode(java.lang.String currentMode) Sets the current communication mode.
java.lang.String	toString() Format all of the parameters into a string

Methods inherited from class java.lang.Object

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

Field Detail

SYNCHRONOUS

public static final java.lang.String SYNCHRONOUS

Name of a property indicating that the service provider is synchronous. Actual text used in configuration files should be "com.ibm.itim.remoteservices.ResourceProperties.SYNCHRONOUS_MODE"

See Also:

Constant Field Values

ASYNCHRONOUS

public static final java.lang.String ASYNCHRONOUS

Name of a property indicating that the service provider is asynchronous. Actual text used in configuration files should be "com.ibm.itim.remoteservices.ResourceProperties.ASYNCHRONOUS_MODE"

See Also:

Constant Field Values

STORE_ACCOUNT_PASSWORD

public static final java.lang.String STORE_ACCOUNT_PASSWORD

Name for a property indicating that the service provider stores the password and uses it for suspending and restoring entities. If present indicates that the password is stored and used suspend and restore operations. Actual text used in configuration files should be "com.ibm.itim.remoteservices.ResourceProperties.STORE_ACCOUNT_PASSWORD"

See Also:

Constant Field Values

PASSWORD_NOT_ALLOWED_ON_RESTORE

public static final java.lang.String PASSWORD_NOT_ALLOWED_ON_RESTORE

Name for a property indicating that the password is NOT allowed when the account is restored.

See Also:

Constant Field Values

PASSWORD_NOT_REQUIRED_ON_RESTORE

public static final java.lang.String PASSWORD_NOT_REQUIRED_ON_RESTORE

Name for a property indicating whether the password is required for restoring entities.

If method isPasswordAllowedOnRestore returns FALSE, then it will alway be assumed to be TRUE (password not required).

Actual text used in configuration files should be "com.ibm.itim.remoteservices.ResourceProperties.PASSWORD_NOT_REQUIRED_ON_RESTORE"

See Also:

Constant Field Values

FILTERING_NOT_SUPPORTED

public static final java.lang.String FILTERING_NOT_SUPPORTED

Name for a Property indicates whether filtered searches are supported. If present indicates that filter is not supported. Actual text used in configuration files should be "com.ibm.itim.remoteservices.ResourceProperties.FILTERING_NOT_SUPPORTED"

See Also:

Constant Field Values

SERVICE_PROVIDER_FACTORY

public static final java.lang.String SERVICE_PROVIDER_FACTORY

Deprecated. Use method getServiceProviderFactory().

Name for a Property indicates the class name for the ServiceProviderFactory to use for creating the ServiceProvider. Actual text used in configuration files should be "com.ibm.itim.remoteservices.ResourceProperties.SERVICE_PROVIDER_FACTORY"

See Also:

Constant Field Values

Constructor Detail

ServiceProviderInformation

public ServiceProviderInformation(java.lang.String serviceProfileName,
                                  java.util.Properties properties)

Creates new ServiceProviderInfo object. A default service provider factory for DAML and FTP will be assumed.

Parameters:

serviceProfileName - The name of the service profile which cannot be null or empty.

properties - The Properties read from the resource definition file.

ServiceProviderInformation

public ServiceProviderInformation(java.lang.String serviceProfileName,
                                  java.util.Properties properties,
                                  java.lang.String serviceProviderFactory)

Creates new ServiceProviderInfo object. A default service provider factory for DAML will be assumed.

Parameters:

serviceProfileName - The name of the service profile which cannot be null or empty.

properties - The Properties read from the resource definition file.

serviceProviderFactory - name of the Java class to instantiate the ServiceProvider implementation which cannot be null or empty.

Method Detail

getServiceProfileName

public java.lang.String getServiceProfileName()

Gets the name of the service profile

Returns:

The name of the service profile, not null or empty.

getProperties

public java.util.Properties getProperties()

Gets the protocol and behavior properties for the service type

Returns:

The properties specific the service type, not null.

getCurrentMode

public java.lang.String getCurrentMode()

Gets the current communication mode. Possible values are ResourceProperties.SYNCHRONOUS or ResourceProperties.ASYNCHRONOUS.

Returns:

The currently supported communication mode

setCurrentMode

public void setCurrentMode(java.lang.String currentMode)

Sets the current communication mode. Possible values are ResourceProperties.SYNCHRONOUS or ResourceProperties.ASYNCHRONOUS.

Parameters:

currentMode - The currently supported communication mode (one of ResourceProperties.SYNCHRONOUS, ResourceProperties.ASYNCHRONOUS)

getSupportedModes

public java.lang.String[] getSupportedModes()

Gets the modes that are supported by this service. Possible contents are ResourceProperties.SYNCHRONOUS and ResourceProperties.ASYNCHRONOUS.

Returns:

A non-empty, non-null array of supported modes

getServiceProviderFactory

public java.lang.String getServiceProviderFactory()

Returns the service provider factory for the service profile: the fully qualified name of the java class.

Returns:

Service provider factory service which is not null or empty.

isStoreAccountPassword

public boolean isStoreAccountPassword()

Deprecated. We not longer ever store the password locally, so the flag should not be used.

Property indicates that the account password should be stored and is used for restoring accounts.

This property used to be used to indicate whether we needed to save a copy of the password in the local LDAP directory to be used for restoring accounts.

Returns:

True if change password is stored in local directory.

isPasswordAllowedOnRestore

public boolean isPasswordAllowedOnRestore()

Property indicates that the account password MAY be send when restoring an account. Note: null value or "TRUE" means NOT allowed.

Note: this method is duplicated in class com.ibm.itim.dataservices.model.ServiceProfile

Returns:

True if password can be sent for restoring accounts

isPasswordRequiredOnRestore

public boolean isPasswordRequiredOnRestore()

Property indicates that the account password is required for restoring accounts. Note: null value or "TRUE" means NOT required.

Note: this logic is duplicated in class com.ibm.itim.dataservices.model.ServiceProfile

Returns:

True if password is required for restoring accounts

isFilteringSupported

public boolean isFilteringSupported()

Property indicates whether filtered searches are supported

Returns:

True if filtered searches are supported

toString

public java.lang.String toString()

Format all of the parameters into a string

Overrides:

toString in class java.lang.Object

Returns:

String indicating the serviceProfileName and properties which is not null or empty.