com.prosyst.mprm.backend.rpc

Class RPCException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.prosyst.mbs.services.pmp.PMPException

com.prosyst.mprm.backend.rpc.RPCException

All Implemented Interfaces:

java.io.Serializable

public class RPCException
extends PMPException

This exception is trown by the RPC Service if some system level error occurs or if invoking of service method has resulted with exception. If the exception is caused by the invoked service this exception object hold reference to the real exception. Since during multicast invocation, more than one service can throw an exception this class allows linking them in a list. In addition if during the multicast invocation some of the service instances have been successfully invoked the exception holds the result of the the successfully finished methods.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
RPCException() Constructs RPC exception
RPCException(java.lang.Exception exception) Constucts RPC exception with a suplied nested exception
RPCException(java.lang.String message) Constructs RPC exception with a supplied error message
RPCException(java.lang.String message, java.lang.Exception exception) Constucts RPC exception with a suplied nested exception and error message.
RPCException(java.lang.Throwable exception) Constucts RPC exception with a suplied nested throwable

Method Summary

Modifier and Type	Method and Description
java.lang.Exception	getBasicException() Returns the actual exception caused by the remote application method, or null if the exception is not caused by the application, but by the RPC Service.
java.lang.String	getHostId() Returns the id of the mPRM backend host which was target of the remote call.
RPCException	getNextException() If the exception was caused by multicast method invocation, all excepions that might be thrown while invoking mutiple service instances are linked in a list.
java.lang.Object	getPartialResult() If the exception was caused by multicast method invocation and only some of the distinct invocations has thrown an error, than the final exception holds the result of the successfully finshed methods.
void	setNextException(RPCException exception) Not intended for application use.
void	setPartialResult(java.lang.Object result) Not intended for application use.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

RPCException

public RPCException()

Constructs RPC exception

RPCException

public RPCException(java.lang.String message)

Constructs RPC exception with a supplied error message

Parameters:

message - the error message

RPCException

public RPCException(java.lang.Exception exception)

Constucts RPC exception with a suplied nested exception

Parameters:

exception - the nested exception

RPCException

public RPCException(java.lang.Throwable exception)

Constucts RPC exception with a suplied nested throwable

Parameters:

exception - the nested exception

RPCException

public RPCException(java.lang.String message,
                    java.lang.Exception exception)

Constucts RPC exception with a suplied nested exception and error message.

Parameters:

message - the error message

exception - the nested exception

Method Detail

getBasicException

public java.lang.Exception getBasicException()

Returns the actual exception caused by the remote application method, or null if the exception is not caused by the application, but by the RPC Service.

Overrides:

getBasicException in class PMPException

Returns:

the nested exception.

getNextException

public RPCException getNextException()

If the exception was caused by multicast method invocation, all excepions that might be thrown while invoking mutiple service instances are linked in a list. This method gives access to the next element in this list.

Returns:

the next exception in the list or null if this is the last exception.

getPartialResult

public java.lang.Object getPartialResult()

If the exception was caused by multicast method invocation and only some of the distinct invocations has thrown an error, than the final exception holds the result of the successfully finshed methods. This method provides access to this result.

Returns:

the partial result of multicast method invocation or null if the is no such result.

getHostId

public java.lang.String getHostId()

Returns the id of the mPRM backend host which was target of the remote call. This can be used for determing, which service instances (targeted in a single multicast call) has failed.

Returns:

the backend host id.

setNextException

public void setNextException(RPCException exception)

Not intended for application use.

setPartialResult

public void setPartialResult(java.lang.Object result)

Not intended for application use.