org.exolab.jms.net.rmi
Class RMIManagedConnectionFactory

java.lang.Object
  |
  +--org.exolab.jms.net.rmi.RMIManagedConnectionFactory

All Implemented Interfaces:

ManagedConnectionFactory

public class RMIManagedConnectionFactory

extends java.lang.Object

implements ManagedConnectionFactory

A factory for RMIConnectionFactory, RMIManagedConnection and RMIManagedConnectionAcceptor instances.

Version:

$Revision: 1.3 $ $Date: 2005/05/27 13:58:02 $

Author:

Tim Anderson

Constructor Summary

RMIManagedConnectionFactory()

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.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RMIManagedConnectionFactory

public RMIManagedConnectionFactory()

Method Detail

createConnectionFactory

public ConnectionFactory createConnectionFactory(ConnectionManager manager)
                                          throws ResourceException

Creates a new connection factory

Specified by:

createConnectionFactory in interface ManagedConnectionFactory

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.

Specified by:

createManagedConnection in interface ManagedConnectionFactory

Parameters:

principal - the security principal

info - the connection request info

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.

Specified by:

createManagedConnectionAcceptor in interface ManagedConnectionFactory

Parameters:

authenticator - authenticates incoming connections

info - the connection request info

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.

Specified by:

matchManagedConnections in interface ManagedConnectionFactory

Parameters:

connections - the candidate connections

principal - the security principal

info - the connection request info

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.

Specified by:

matchManagedConnectionAcceptors in interface ManagedConnectionFactory

Parameters:

acceptors - the candidate connection acceptors

info - the connection request info

Returns:

the first acceptable match, or null if none is found

Throws:

ResourceException - for any error