InvocationResult

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> org >> apache >> geronimo >> core >> [ service overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

Sourc code of org.apache.geronimo.core.service.InvocationResult

SOURCE |

Download org.apache.geronimo.core.service.InvocationResult

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.geronimo.core.service
Interface InvocationResult

All Known Implementing Classes:: SimpleInvocationResult

public interface InvocationResult

The result of an Invocation. There are two types of result:

normal - indicating the operation completed normally (e.g. the method returned)
exception - indicating the operation completed abnormally (e.g. the method threw a checked exception)

Note that these should both be considered a normal completion of the operation by the container. Abnormal completions, such as a RuntimeException or Error from the invocation, or any problem in the interceptor chain itself, should result in a Throwable being thrown up the chain rather than being contained in this result.

This distinction mirrors the semantics for EJB invocations, where a business method is considered to have completed successfuly even if it throws declared Exception - the Exception there is indicating a business level issue and not a system problem.

Version:: $Rev: 46019 $ $Date: 2004-09-14 02:56:06 -0700 (Tue, 14 Sep 2004) $

Method Summary

java.lang.Exception getException()
          Get the application exception raised by the invocation.

java.lang.Object getResult()
          Get the return value from the invocation.

boolean isException()
          Was an application exception raised by the invocation? Note, this indicates a checked application exception was thrown; this will never contain a system exception

boolean isNormal()
          Was this a normal completion (return)?

Method Detail

isNormal

public boolean isNormal()

Was this a normal completion (return)?

getResult

public java.lang.Object getResult()

Get the return value from the invocation. It is an error to call this method if the invocation is not complete normally.

isException

public boolean isException()

Was an application exception raised by the invocation? Note, this indicates a checked application exception was thrown; this will never contain a system exception

getException

public java.lang.Exception getException()

Get the application exception raised by the invocation. It is an error to call this method if the invocation did not raise an exception