org.apache.reef.exception.evaluator

Class ServiceException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.apache.reef.exception.evaluator.ServiceException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

NetworkException, StorageException

public class ServiceException
extends Exception

The base class for exceptions thrown by REEF libraries and services.

Rules of thumb for exception handling in REEF:

• When possible, throw a subclass of ServiceException, with the following exceptions (no pun intended)
• Iterator and other standard Java interfaces neglect to declare throws clauses. Use ServiceRuntimeException when implementing such interfaces.
• If there is no good way for Task code to recover from the exception, throw (and document) a subclass of ServiceRuntimeException
• Applications with generic, catch-all error handling should catch ServiceRuntimeException and ServiceException.
• Applications with specific error handling logic (eg: ignoring/coping with a failed remote task) should catch the subclass of ServiceRuntimeException / ServiceException thrown by the library they are using.

See Also:

ServiceRuntimeException, Serialized Form

Constructor Summary

Constructors

Constructor and Description
ServiceException(String s)
ServiceException(String s, Throwable e)
ServiceException(Throwable e)

Method Summary

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

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ServiceException

public ServiceException(String s,
                Throwable e)

ServiceException

public ServiceException(String s)

ServiceException

public ServiceException(Throwable e)