org.jcoderz.commons.connector
Interface ConnectionHandle

All Known Implementing Classes:

ConnectionBase

public interface ConnectionHandle

The base connection handle interface.

Method Summary

void	changeAssociation(ConnectionNotificationListener listener) The underlying managed connection calls this method to force this handle change the managed connection's association.
void	cleanUp() The underlying managed connection calls this method to force any cleanup on this connection handle.

Method Detail

cleanUp

void cleanUp()
             throws ResourceException

The underlying managed connection calls this method to force any cleanup on this connection handle. All futher calls on the public methods of this connection will throw a ResourceException.

Throws:

ResourceException - thrown in error cases.

changeAssociation

void changeAssociation(ConnectionNotificationListener listener)
                       throws ResourceException

The underlying managed connection calls this method to force this handle change the managed connection's association. In other words, this handle should migrate to another managed connection.

Parameters:

listener - The new listener to be used for this handle.

Throws:

ResourceException - thrown in error cases.