org.exolab.jms.net.connector
Interface ManagedConnectionFactory

All Known Implementing Classes:
AbstractHTTPManagedConnectionFactory, HTTPManagedConnectionFactory, HTTPSManagedConnectionFactory, RMIManagedConnectionFactory, SocketManagedConnectionFactory, TCPManagedConnectionFactory, TCPSManagedConnectionFactory, 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

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

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

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

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

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


Copyright © 1999-2012 The OpenJMS Group. All Rights Reserved.