org.jboss.naming.remote.client.ejb

Interface EJBClientHandler

All Known Implementing Classes:

RemoteNamingStoreEJBClientHandler

public interface EJBClientHandler

A EJBClientHandler is an abstraction to allows the remote naming APIs to support EJB invocations without adding a hard dependency on the EJB client project.

This EJBClientHandler interface is expected to have no references to any of the EJB client APIs. The implementations of this interface can however refer to the EJB client APIs.

Author:

Jaikiran Pai

Method Summary

Modifier and Type	Method and Description
void	associate(org.jboss.remoting3.Connection connection) Associates the passed connection with an appropriate EJBClientContext.
Object	handleLookupReturnInstance(Object instance) This method will be invoked by the remote naming lookup protocol after it has received back the object from the server, during a Context.lookup(String) or Context.lookup(javax.naming.Name) operation.

Method Detail

associate

void associate(org.jboss.remoting3.Connection connection)
        throws Exception

Associates the passed connection with an appropriate EJBClientContext. The passed connection is typically managed by the remote naming APIs

Parameters:

connection - The connection to be associated with the EJB client context

Throws:

Exception

handleLookupReturnInstance

Object handleLookupReturnInstance(Object instance)

This method will be invoked by the remote naming lookup protocol after it has received back the object from the server, during a Context.lookup(String) or Context.lookup(javax.naming.Name) operation. This allows the EJBClientHandler implementations to check if the returned object is an EJB proxy and if it is, then do any relevant processing of that proxy before returning back the processed/updated proxy.

If the passed instance is not an EJB proxy then the implementations of this EJBClientHandler are expected to just return back the passed instance.

Parameters:

instance - The object instance which was returned by the server after a remote naming lookup

Returns: