org.springframework.remoting.support

Class RemoteInvocationResult

  • java.lang.Object
    • org.springframework.remoting.support.RemoteInvocationResult
  • All Implemented Interfaces:
    java.io.Serializable


    public class RemoteInvocationResult
    extends java.lang.Object
    implements java.io.Serializable
    Encapsulates a remote invocation result, holding a result value or an exception. Used for HTTP-based serialization invokers.

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

    Both RemoteInvocation and RemoteInvocationResult are designed for use with standard Java serialization as well as JavaBean-style serialization.

    Since:
    1.1
    Author:
    Juergen Hoeller
    See Also:
    RemoteInvocation, Serialized Form
    • Constructor Summary

      Constructors 
      Constructor and Description
      RemoteInvocationResult()
      Create a new RemoteInvocationResult for JavaBean-style deserialization (e.g.
      RemoteInvocationResult(java.lang.Object value)
      Create a new RemoteInvocationResult for the given result value.
      RemoteInvocationResult(java.lang.Throwable exception)
      Create a new RemoteInvocationResult for the given exception.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method and Description
      java.lang.Throwable getException()
      Return the exception thrown by an unsuccessful invocation of the target method, if any.
      java.lang.Object getValue()
      Return the result value returned by a successful invocation of the target method, if any.
      boolean hasException()
      Return whether this invocation result holds an exception.
      boolean hasInvocationTargetException()
      Return whether this invocation result holds an InvocationTargetException, thrown by an invocation of the target method itself.
      java.lang.Object recreate()
      Recreate the invocation result, either returning the result value in case of a successful invocation of the target method, or rethrowing the exception thrown by the target method.
      void setException(java.lang.Throwable exception)
      Set the exception thrown by an unsuccessful invocation of the target method, if any.
      void setValue(java.lang.Object value)
      Set the result value returned by a successful invocation of the target method, if any.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • RemoteInvocationResult

        public RemoteInvocationResult(@Nullable
                                      java.lang.Object value)
        Create a new RemoteInvocationResult for the given result value.
        Parameters:
        value - the result value returned by a successful invocation of the target method
      • RemoteInvocationResult

        public RemoteInvocationResult(@Nullable
                                      java.lang.Throwable exception)
        Create a new RemoteInvocationResult for the given exception.
        Parameters:
        exception - the exception thrown by an unsuccessful invocation of the target method
    • Method Detail

      • getValue

        @Nullable
        public java.lang.Object getValue()
        Return the result value returned by a successful invocation of the target method, if any.
        See Also:
        hasException()
      • getException

        @Nullable
        public java.lang.Throwable getException()
        Return the exception thrown by an unsuccessful invocation of the target method, if any.
        See Also:
        hasException()
      • hasException

        public boolean hasException()
        Return whether this invocation result holds an exception. If this returns false, the result value applies (even if it is null).
        See Also:
        getValue(), getException()
      • hasInvocationTargetException

        public boolean hasInvocationTargetException()
        Return whether this invocation result holds an InvocationTargetException, thrown by an invocation of the target method itself.
        See Also:
        hasException()
      • recreate

        @Nullable
        public java.lang.Object recreate()
                                            throws java.lang.Throwable
        Recreate the invocation result, either returning the result value in case of a successful invocation of the target method, or rethrowing the exception thrown by the target method.
        Returns:
        the result value, if any
        Throws:
        java.lang.Throwable - the exception, if any