org.springframework.remoting.support

Class RemoteInvocation

java.lang.Object

org.springframework.remoting.support.RemoteInvocation

All Implemented Interfaces:

java.io.Serializable

public class RemoteInvocation
extends java.lang.Object
implements java.io.Serializable

Encapsulates a remote invocation, providing core method invocation properties in a serializable fashion. Used for RMI and HTTP-based serialization invokers.

This is an SPI class, typically not used directly by applications. Can be subclassed for additional invocation parameters.

Since:

25.02.2004

Author:

Juergen Hoeller

See Also:

RemoteInvocationResult, RemoteInvocationFactory, RemoteInvocationExecutor, RmiProxyFactoryBean, RmiServiceExporter, HttpInvokerProxyFactoryBean, HttpInvokerServiceExporter, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.Object[]	arguments
private java.util.Map<java.lang.String,java.io.Serializable>	attributes
private java.lang.String	methodName
private java.lang.Class[]	parameterTypes
private static long	serialVersionUID use serialVersionUID from Spring 1.1 for interoperability

Constructor Summary

Constructors

Constructor and Description
RemoteInvocation() Create a new RemoteInvocation for use as JavaBean.
RemoteInvocation(MethodInvocation methodInvocation) Create a new RemoteInvocation for the given AOP method invocation.
RemoteInvocation(java.lang.String methodName, java.lang.Class[] parameterTypes, java.lang.Object[] arguments) Create a new RemoteInvocation for the given parameters.

Method Summary

Methods

Modifier and Type	Method and Description
void	addAttribute(java.lang.String key, java.io.Serializable value) Add an additional invocation attribute.
java.lang.Object[]	getArguments() Return the arguments for the target method call.
java.io.Serializable	getAttribute(java.lang.String key) Retrieve the attribute for the given key, if any.
java.util.Map<java.lang.String,java.io.Serializable>	getAttributes() Return the attributes Map.
java.lang.String	getMethodName() Return the name of the target method.
java.lang.Class[]	getParameterTypes() Return the parameter types of the target method.
java.lang.Object	invoke(java.lang.Object targetObject) Perform this invocation on the given target object.
void	setArguments(java.lang.Object[] arguments) Set the arguments for the target method call.
void	setAttributes(java.util.Map<java.lang.String,java.io.Serializable> attributes) Set the attributes Map.
void	setMethodName(java.lang.String methodName) Set the name of the target method.
void	setParameterTypes(java.lang.Class[] parameterTypes) Set the parameter types of the target method.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

use serialVersionUID from Spring 1.1 for interoperability

See Also:

Constant Field Values

methodName

private java.lang.String methodName

parameterTypes

private java.lang.Class[] parameterTypes

arguments

private java.lang.Object[] arguments

attributes

private java.util.Map<java.lang.String,java.io.Serializable> attributes

Constructor Detail

RemoteInvocation

public RemoteInvocation()

Create a new RemoteInvocation for use as JavaBean.

RemoteInvocation

public RemoteInvocation(java.lang.String methodName,
                java.lang.Class[] parameterTypes,
                java.lang.Object[] arguments)

Create a new RemoteInvocation for the given parameters.

Parameters:

methodName - the name of the method to invoke

parameterTypes - the parameter types of the method

arguments - the arguments for the invocation

RemoteInvocation

public RemoteInvocation(MethodInvocation methodInvocation)

Create a new RemoteInvocation for the given AOP method invocation.

Parameters:

methodInvocation - the AOP invocation to convert

Method Detail

setMethodName

public void setMethodName(java.lang.String methodName)

Set the name of the target method.

getMethodName

public java.lang.String getMethodName()

Return the name of the target method.

setParameterTypes

public void setParameterTypes(java.lang.Class[] parameterTypes)

Set the parameter types of the target method.

getParameterTypes

public java.lang.Class[] getParameterTypes()

Return the parameter types of the target method.

setArguments

public void setArguments(java.lang.Object[] arguments)

Set the arguments for the target method call.

getArguments

public java.lang.Object[] getArguments()

Return the arguments for the target method call.

addAttribute

public void addAttribute(java.lang.String key,
                java.io.Serializable value)
                  throws java.lang.IllegalStateException

Add an additional invocation attribute. Useful to add additional invocation context without having to subclass RemoteInvocation.

Attribute keys have to be unique, and no overriding of existing attributes is allowed.

The implementation avoids to unnecessarily create the attributes Map, to minimize serialization size.

Parameters:

key - the attribute key

value - the attribute value

Throws:

java.lang.IllegalStateException - if the key is already bound

getAttribute

public java.io.Serializable getAttribute(java.lang.String key)

Retrieve the attribute for the given key, if any.

The implementation avoids to unnecessarily create the attributes Map, to minimize serialization size.

Parameters:

key - the attribute key

Returns:

the attribute value, or null if not defined

setAttributes

public void setAttributes(java.util.Map<java.lang.String,java.io.Serializable> attributes)

Set the attributes Map. Only here for special purposes: Preferably, use addAttribute(java.lang.String, java.io.Serializable) and getAttribute(java.lang.String).

Parameters:

attributes - the attributes Map

See Also:

addAttribute(java.lang.String, java.io.Serializable), getAttribute(java.lang.String)

getAttributes

public java.util.Map<java.lang.String,java.io.Serializable> getAttributes()

Return the attributes Map. Mainly here for debugging purposes: Preferably, use addAttribute(java.lang.String, java.io.Serializable) and getAttribute(java.lang.String).

Returns:

the attributes Map, or null if none created

See Also:

addAttribute(java.lang.String, java.io.Serializable), getAttribute(java.lang.String)

invoke

public java.lang.Object invoke(java.lang.Object targetObject)
                        throws java.lang.NoSuchMethodException,
                               java.lang.IllegalAccessException,
                               java.lang.reflect.InvocationTargetException

Perform this invocation on the given target object. Typically called when a RemoteInvocation is received on the server.

Parameters:

targetObject - the target object to apply the invocation to

Returns:

the invocation result

Throws:

java.lang.NoSuchMethodException - if the method name could not be resolved

java.lang.IllegalAccessException - if the method could not be accessed

java.lang.reflect.InvocationTargetException - if the method invocation resulted in an exception

See Also:

Method.invoke(java.lang.Object, java.lang.Object...)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object