Module jakarta.resource

Package jakarta.resource.spi

Interface ValidatingManagedConnectionFactory

public interface ValidatingManagedConnectionFactory

This interface is implemented by a ManagedConnectionFactory instance that supports the ability to validate ManagedConnection objects.

This may be used by the application server to prune invalid ManagedConnection objects from its connection pool.

The application server may use this functionality to test the validity of a ManagedConnection by passing in a Set of size one( with the ManagedConnection that has to be tested for validity as the only member of the Set.

Version:

1.0

Method Summary

Modifier and Type	Method	Description
Set	getInvalidConnections(Set connectionSet)	This method returns a set of invalid ManagedConnection objects chosen from a specified set of ManagedConnection objects.

Method Details

getInvalidConnections

Set getInvalidConnections(Set connectionSet)
                   throws ResourceException

This method returns a set of invalid ManagedConnection objects chosen from a specified set of ManagedConnection objects.

Parameters:

connectionSet - a set of ManagedConnection objects that need to be validated.

Returns:

a set of invalid ManagedConnection objects.

Throws:

ResourceException - generic exception.