org.exolab.jms.net.connector
Interface ManagedConnectionFactory

All Known Implementing Classes:

AbstractHTTPManagedConnectionFactory, RMIManagedConnectionFactory, SocketManagedConnectionFactory, VMManagedConnectionFactory

public interface ManagedConnectionFactory

A factory for ConnectionFactory, ManagedConnection and ManagedConnectionAcceptor instances

Version:

$Revision: 1.1 $ $Date: 2004/11/26 01:51:03 $

Author:

Tim Anderson

Method Summary

ConnectionFactory	createConnectionFactory(ConnectionManager manager) Creates a new connection factory
ManagedConnection	createManagedConnection(java.security.Principal principal, ConnectionRequestInfo info) Creates a new connection
ManagedConnectionAcceptor	createManagedConnectionAcceptor(Authenticator authenticator, ConnectionRequestInfo info) Creates an acceptor for connections
ManagedConnectionAcceptor	matchManagedConnectionAcceptors(java.util.List acceptors, ConnectionRequestInfo info) Returns a matched connection acceptor from the candidate set of acceptors
ManagedConnection	matchManagedConnections(java.util.List connections, java.security.Principal principal, ConnectionRequestInfo info) Returns a matched connection from the candidate set of connections

Method Detail

createConnectionFactory

public ConnectionFactory createConnectionFactory(ConnectionManager manager)
                                          throws ResourceException

Creates a new connection factory

Parameters:

manager - the connection manager

Returns:

a new connection factory

Throws:

ResourceException - if the factory cannot be created

createManagedConnection

public ManagedConnection createManagedConnection(java.security.Principal principal,
                                                 ConnectionRequestInfo info)
                                          throws ResourceException

Creates a new connection

Parameters:

principal - the security principal

info - the connection request info. May be null

Returns:

a new connection

Throws:

ResourceException - if a connection cannot be established

createManagedConnectionAcceptor

public ManagedConnectionAcceptor createManagedConnectionAcceptor(Authenticator authenticator,
                                                                 ConnectionRequestInfo info)
                                                          throws ResourceException

Creates an acceptor for connections

Parameters:

authenticator - authenticates incoming connections

info - the connection request info. May be null

Returns:

a new connection acceptor

Throws:

ResourceException - if an acceptor cannot be created

matchManagedConnections

public ManagedConnection matchManagedConnections(java.util.List connections,
                                                 java.security.Principal principal,
                                                 ConnectionRequestInfo info)
                                          throws ResourceException

Returns a matched connection from the candidate set of connections

Parameters:

connections - the candidate connections

principal - the security principal

info - the connection request info. May be null

Returns:

the first acceptable match, or null if none is found

Throws:

ResourceException - for any error

matchManagedConnectionAcceptors

public ManagedConnectionAcceptor matchManagedConnectionAcceptors(java.util.List acceptors,
                                                                 ConnectionRequestInfo info)
                                                          throws ResourceException

Returns a matched connection acceptor from the candidate set of acceptors

Parameters:

acceptors - the candidate connection acceptors

info - the connection request info. May be null

Returns:

the first acceptable match, or null if none is found

Throws:

ResourceException - for any error