Package org.apache.manifoldcf.authorities.interfaces

Interface IAuthorityConnectorPool

All Known Implementing Classes:

AuthorityConnectorPool

public interface IAuthorityConnectorPool

An object implementing this interface functions as a pool of authority connectors. Coordination and allocation among cluster members is managed within. These objects are thread-local, so do not share them among threads.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	_rcsid

Method Summary

Modifier and Type	Method	Description
void	closeAllConnectors()	Clean up all open authority connector handles.
void	flushUnusedConnectors()	Flush only those connector handles that are currently unused.
IAuthorityConnector	grab(IAuthorityConnection authorityConnection)	Get an authority connector.
IAuthorityConnector[]	grabMultiple(java.lang.String[] orderingKeys, IAuthorityConnection[] authorityConnections)	Get multiple authority connectors, all at once.
void	pollAllConnectors()	Idle notification for inactive authority connector handles.
void	release(IAuthorityConnection connection, IAuthorityConnector connector)	Release an authority connector.
void	releaseMultiple(IAuthorityConnection[] connections, IAuthorityConnector[] connectors)	Release multiple authority connectors.

Field Detail

_rcsid

static final java.lang.String _rcsid

See Also:

Constant Field Values

Method Detail

grabMultiple

IAuthorityConnector[] grabMultiple(java.lang.String[] orderingKeys,
                                   IAuthorityConnection[] authorityConnections)
                            throws ManifoldCFException

Get multiple authority connectors, all at once. Do this in a particular order so that any connector exhaustion will not cause a deadlock.

Parameters:

orderingKeys - are the keys which determine in what order the connectors are obtained.

authorityConnections - are the connections to use the build the connector instances.

Throws:

ManifoldCFException

grab

IAuthorityConnector grab(IAuthorityConnection authorityConnection)
                  throws ManifoldCFException

Get an authority connector. The connector is specified by an authority connection object.

Parameters:

authorityConnection - is the authority connection to base the connector instance on.

Throws:

ManifoldCFException

releaseMultiple

void releaseMultiple(IAuthorityConnection[] connections,
                     IAuthorityConnector[] connectors)
              throws ManifoldCFException

Release multiple authority connectors.

Parameters:

connections - are the connections describing the instances to release.

connectors - are the connector instances to release.

Throws:

ManifoldCFException

release

void release(IAuthorityConnection connection,
             IAuthorityConnector connector)
      throws ManifoldCFException

Release an authority connector.

Parameters:

connection - is the connection describing the instance to release.

connector - is the connector to release.

Throws:

ManifoldCFException

pollAllConnectors

void pollAllConnectors()
                throws ManifoldCFException

Idle notification for inactive authority connector handles. This method polls all inactive handles.

Throws:

ManifoldCFException

flushUnusedConnectors

void flushUnusedConnectors()
                    throws ManifoldCFException

Flush only those connector handles that are currently unused.

Throws:

ManifoldCFException

closeAllConnectors

void closeAllConnectors()
                 throws ManifoldCFException

Clean up all open authority connector handles. This method is called when the connector pool needs to be flushed, to free resources.

Throws:

ManifoldCFException