org.jboss.invocation
Interface Invoker

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

HttpInvokerProxy (src) , HttpInvokerProxyHA (src) , JRMPInvoker (src) , JRMPInvokerProxy (src) , LocalInvoker (src) , PooledInvokerProxy (src)

public interface Invoker

extends java.rmi.Remote

This invoker carries Invocation in the JMX target node.

The interface in the current JBoss can be implemented with Remote/local switches or with clustered invokers, this interface just masks the network details and the topology of the JMX nodes for the client proxies.

ID

public static final GUID (src)  ID

A globaly unique identifier use to determine if an instance is local to the invoker.

getServerHostName

public java.lang.String getServerHostName()
                                   throws java.lang.Exception

A free form String identifier for this delegate invoker, can be clustered or target node This should evolve in a more advanced meta-inf object

Throws:

java.lang.Exception

invoke

public java.lang.Object invoke(Invocation (src)  invocation)
                        throws java.lang.Exception

The invoke with an Invocation Object.

the delegate can handle network protocols on behalf of proxies (proxies delegate to these puppies). We provide default implemenations with JRMP/Local/Clustered invokers. The delegates are not tied to a type of invocation (EJB or generic RMI).

Parameters:

invocation - A pointer to the invocation object

Returns:

Return value of method invocation.

Throws:

java.lang.Exception - Failed to invoke method.