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
Author:
Ram Jeyaraman

  • 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.