org.identityconnectors.framework.api
Class ConnectorInfoManagerFactory

java.lang.Object
  org.identityconnectors.framework.api.ConnectorInfoManagerFactory

public abstract class ConnectorInfoManagerFactory
extends Object

An application's primary entry point into connectors. Allows an application to load the connector classes from a set of bundles.

Constructor Summary

ConnectorInfoManagerFactory()

Method Summary

abstract void	clearLocalCache() Clears the local bundle manager cache.
abstract void	clearRemoteCache() Clears the remote cache.
static ConnectorInfoManagerFactory	getInstance() Returns the instance of this factory.
abstract ConnectorInfoManager	getLocalManager(URL... urls) Creates the ConnectorInfoManager from a list of bundle URLs.
abstract ConnectorInfoManager	getRemoteManager(RemoteFrameworkConnectionInfo info) Creates the ConnectorInfoManager for a remote framework.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConnectorInfoManagerFactory

public ConnectorInfoManagerFactory()

Method Detail

getInstance

public static ConnectorInfoManagerFactory getInstance()

Returns the instance of this factory.

Returns:

The instance of this factory

getLocalManager

public abstract ConnectorInfoManager getLocalManager(URL... urls)
                                              throws ConfigurationException

Creates the ConnectorInfoManager from a list of bundle URLs.

NOTE: The results from this call are automatically cached and keyed by the list of URLs passed in. To clear the cache, call clearLocalCache().

Parameters:

urls - The list of bundle URLs. This list may consist of directories consisting of un-jarred bundles and/or bundle jars.

Returns:

The manager

Throws:

ConfigurationException - If there was any problem with any of the bundles.

getRemoteManager

public abstract ConnectorInfoManager getRemoteManager(RemoteFrameworkConnectionInfo info)
                                               throws RuntimeException

Creates the ConnectorInfoManager for a remote framework.

NOTE: The results from this call are automatically cached and keyed by the RemoteFrameworkConnectionInfo passed in. To clear the cache, call clearRemoteCache().

Parameters:

info - The connection information.

Returns:

The manager

Throws:

RuntimeException - If there was any problem connecting

clearLocalCache

public abstract void clearLocalCache()

Clears the local bundle manager cache. NOTE: Avoid using this method outside of unit testing.

clearRemoteCache

public abstract void clearRemoteCache()

Clears the remote cache. There should be an admin page function which exposes this method for the case where you drop in a new connector in the connector server and reset it.