org.identityconnectors.framework.spi

Interface PoolableConnector

All Superinterfaces:

Connector

All Known Implementing Classes:

TstConnector, TstStatefulPoolableConnector

public interface PoolableConnector
extends Connector

To be implemented by connectors that wish to be pooled.

Method Summary

Methods

Modifier and Type	Method and Description
void	checkAlive() Checks if the connector is still alive.

Methods inherited from interface org.identityconnectors.framework.spi.Connector

dispose, getConfiguration, init

Method Detail

checkAlive

void checkAlive()

Checks if the connector is still alive.

A connector can spend a large amount of time in the pool before being used. This method is intended to check if the connector is alive and operations can be invoked on it (for instance, an implementation would check that the connector's physical connection to the resource has not timed out).

The major difference between this method and TestOp.test() is that this method must do only the minimum that is necessary to check that the connector is still alive. TestOp.test() does a more thorough check of the environment specified in the Configuration, and can therefore be much slower.

This method can be called often. Implementations should do their best to keep this method fast.

Throws:

RuntimeException - if the connector is no longer alive.