org.jboss.ejb.client

Class EJBClientContext

java.lang.Object

org.jboss.ejb.client.Attachable

org.jboss.ejb.client.EJBClientContext

public final class EJBClientContext
extends Attachable

The public API for an EJB client context. An EJB client context may be associated with (and used by) one or more threads concurrently.

Author:

David M. Lloyd

Method Summary

Methods

Modifier and Type	Method and Description
static EJBClientContext	create() Creates and returns a new client context.
static EJBClientContext	create(ClassLoader classLoader) Creates and returns a new client context, using the given class loader to look for initializers.
static EJBClientContext	create(EJBClientConfiguration ejbClientConfiguration) Creates and returns a new client context.
static EJBClientContext	create(EJBClientConfiguration ejbClientConfiguration, ClassLoader classLoader) Creates and returns a new client context, using the given class loader to look for initializers.
ClusterContext	getClusterContext(String clusterName) Returns a ClusterContext corresponding to the passed clusterName.
static EJBClientContext	getCurrent() Get the current client context for this thread.
EJBClientConfiguration	getEJBClientConfiguration() Returns the EJBClientConfiguration applicable to this EJB client context.
ClusterContext	getOrCreateClusterContext(String clusterName) Returns a ClusterContext corresponding to the passed clusterName.
static void	lockSelector() Prevent the selector from being changed again.
void	registerConnection(Connection connection) Register a Remoting connection with this client context.
boolean	registerEJBReceiver(EJBReceiver receiver) Register an EJB receiver with this client context.
EJBClientInterceptor.Registration	registerInterceptor(int priority, EJBClientInterceptor clientInterceptor) Register a client interceptor with this client context.
void	registerReconnectHandler(ReconnectHandler reconnectHandler) Registers a ReconnectHandler in this EJBClientContext
void	removeCluster(String clusterName) Removes the cluster identified by the clusterName from this client context
static EJBClientContext	requireCurrent() Get the current client context for this thread, throwing an exception if none is set.
static ContextSelector<EJBClientContext>	setConstantContext(EJBClientContext context) Set a constant EJB client context.
static ContextSelector<EJBClientContext>	setSelector(ContextSelector<EJBClientContext> newSelector) Sets the EJB client context selector.
void	unregisterEJBReceiver(EJBReceiver receiver) Unregister (a previously registered) EJB receiver from this client context.
void	unregisterReconnectHandler(ReconnectHandler reconnectHandler) Unregisters a ReconnectHandler from this EJBClientContext

Methods inherited from class org.jboss.ejb.client.Attachable

getAttachment, putAttachment, putAttachmentIfAbsent, removeAttachment, removeAttachment, replaceAttachment, replaceAttachment

Methods inherited from class java.lang.Object

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

Method Detail

create

public static EJBClientContext create()

Creates and returns a new client context.

Returns:

the newly created context

create

public static EJBClientContext create(ClassLoader classLoader)

Creates and returns a new client context, using the given class loader to look for initializers.

Parameters:

classLoader - the class loader. Cannot be null

Returns:

the newly created context

create

public static EJBClientContext create(EJBClientConfiguration ejbClientConfiguration)

Creates and returns a new client context. The passed ejbClientConfiguration will be used by this client context during any of the context management activities (like auto-creation of remoting EJB receivers)

Parameters:

ejbClientConfiguration - The EJB client configuration. Can be null.

Returns:

create

public static EJBClientContext create(EJBClientConfiguration ejbClientConfiguration,
                      ClassLoader classLoader)

Creates and returns a new client context, using the given class loader to look for initializers. The passed ejbClientConfiguration will be used by this client context during any of the context management activities (like auto-creation of remoting EJB receivers)

Parameters:

ejbClientConfiguration - The EJB client configuration. Can be null.

classLoader - The class loader. Cannot be null

Returns:

setSelector

public static ContextSelector<EJBClientContext> setSelector(ContextSelector<EJBClientContext> newSelector)

Sets the EJB client context selector. Replaces the existing selector, which is then returned by this method

Parameters:

newSelector - The selector to set. Cannot be null

Returns:

Returns the previously set EJB client context selector.

Throws:

SecurityException - if a security manager is installed and you do not have the setEJBClientContextSelector RuntimePermission

setConstantContext

public static ContextSelector<EJBClientContext> setConstantContext(EJBClientContext context)

Set a constant EJB client context. Replaces the existing selector, which is then returned by this method

Parameters:

context - the context to set

Returns:

Returns the previously set EJB client context selector.

Throws:

SecurityException - if a security manager is installed and you do not have the setEJBClientContextSelector RuntimePermission

lockSelector

public static void lockSelector()

Prevent the selector from being changed again. Attempts to do so will result in a SecurityException.

Throws:

SecurityException - if a security manager is installed and you do not have the setEJBClientContextSelector RuntimePermission

getCurrent

public static EJBClientContext getCurrent()

Get the current client context for this thread.

Returns:

the current client context

requireCurrent

public static EJBClientContext requireCurrent()
                                       throws IllegalStateException

Get the current client context for this thread, throwing an exception if none is set.

Returns:

the current client context

Throws:

IllegalStateException - if the current client context is not set

registerEJBReceiver

public boolean registerEJBReceiver(EJBReceiver receiver)

Register an EJB receiver with this client context.

If the same EJBReceiver has already been associated in this client context or if a receiver with the same node name has already been associated in this client context, then this method does not register the passed receiver and returns false.

Parameters:

receiver - the receiver to register

Returns:

Returns true if the receiver was registered in this client context. Else returns false.

Throws:

IllegalArgumentException - If the passed receiver is null

unregisterEJBReceiver

public void unregisterEJBReceiver(EJBReceiver receiver)

Unregister (a previously registered) EJB receiver from this client context.

This EJB client context will not use this unregistered receiver for any subsequent invocations

Parameters:

receiver - The EJB receiver to unregister

Throws:

IllegalArgumentException - If the passed receiver is null

registerConnection

public void registerConnection(Connection connection)

Register a Remoting connection with this client context.

Parameters:

connection - the connection to register

registerInterceptor

public EJBClientInterceptor.Registration registerInterceptor(int priority,
                                                    EJBClientInterceptor clientInterceptor)
                                                      throws IllegalArgumentException

Register a client interceptor with this client context.

If the passed clientInterceptor is already added to this context with the same priority then this method just returns the old EJBClientInterceptor.Registration. If however, the clientInterceptor is already registered in this context with a different priority then this method throws an IllegalArgumentException

Parameters:

priority - the absolute priority of this interceptor (lower runs earlier; higher runs later)

clientInterceptor - the interceptor to register

Returns:

a handle which may be used to later remove this registration

Throws:

IllegalArgumentException - if the given interceptor is null, the priority is less than 0, or the given interceptor is already registered with a different priority

getEJBClientConfiguration

public EJBClientConfiguration getEJBClientConfiguration()

Returns the EJBClientConfiguration applicable to this EJB client context. Returns null if this EJB client context isn't configured with a EJBClientConfiguration

Returns:

registerReconnectHandler

public void registerReconnectHandler(ReconnectHandler reconnectHandler)

Registers a ReconnectHandler in this EJBClientContext

Parameters:

reconnectHandler - The reconnect handler. Cannot be null

unregisterReconnectHandler

public void unregisterReconnectHandler(ReconnectHandler reconnectHandler)

Unregisters a ReconnectHandler from this EJBClientContext

Parameters:

reconnectHandler - The reconnect handler to unregister

getOrCreateClusterContext

public ClusterContext getOrCreateClusterContext(String clusterName)

Returns a ClusterContext corresponding to the passed clusterName. If no such cluster context exists, a new one is created and returned. Subsequent invocations on this EJBClientContext for the same cluster name will return this same ClusterContext, unless the cluster has been removed from this client context.

Parameters:

clusterName - The name of the cluster

Returns:

getClusterContext

public ClusterContext getClusterContext(String clusterName)

Returns a ClusterContext corresponding to the passed clusterName. If no such cluster context exists, then this method returns null.

Parameters:

clusterName - The name of the cluster

Returns:

removeCluster

public void removeCluster(String clusterName)

Removes the cluster identified by the clusterName from this client context

Parameters:

clusterName - The name of the cluster