weborb.handler
Interface IInvocationHandler

All Known Implementing Classes:

AxisWebServiceHandler, EjbHandler, JavaObjectHandler, SpringBeanHandler, WebServiceHandler

public interface IInvocationHandler

IInvocationHandler IInvocationHandler must be implemented by all service invokers. A service invoker is an object capable of performing service method invocations. A service invoker can be registered using Handlers.addInvocationHandler(). When an invocation request arrives, each invocation handler is given a chance to process the request. Upon the first successful invocation, request processing stops and result (or exception) is sent back to the client.

Author:

Midnight Coders, LLC

Method Summary

java.lang.String	getName()
Value	invoke(java.lang.String targetObject, java.lang.String function, java.lang.Object[] arguments) Handle service invocation and return Value object containing the actual response.

Method Detail

invoke

Value invoke(java.lang.String targetObject,
             java.lang.String function,
             java.lang.Object[] arguments)
             throws java.lang.Exception

Handle service invocation and return Value object containing the actual response.

Parameters:

targetObject - service address

function - name of the method to invoke

arguments - array of arguments

Returns:

Value object containing the response or null if the invoker cannot handle the invocation

Throws:

java.lang.Exception - if exception is an instance of ServiceException, the exception is returned as the result of invocation. Otherwise the invocation request is passed to the next invocation handler in the chain

getName

java.lang.String getName()

Returns:

name of the invocation handler for logging or debugging purposes