lime
Class LimeException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--lime.LimeException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

AgentCreationException, NoSuchReactionException, TupleSpaceEngineException

public class LimeException

extends java.lang.Exception

The superclass of all exceptions raised by this package. Instances of this class are also used to wrap lower-level exceptions (called internal exceptions) generated by the implementation, e.g., IOExceptionException or ClassNotFoundException.

Version:

1.0 alpha

Author:

Amy L. Murphy, Gian Pietro Picco

See Also:

Serialized Form

Constructor Summary

LimeException()
Creates a new exception with no internal, lower-level exception.

LimeException(java.lang.Exception internal)
Creates an exception that wraps an internal exception.

LimeException(java.lang.Exception internal, java.lang.String s)
Creates an exception that wraps an internal exception.

LimeException(java.lang.String s)
Creates a new exception with no internal, lower-level exception.

Method Summary

java.lang.Exception	getInternal() Returns the internal exception associated with this object.
boolean	hasInternal() Tests whether this exception contains an internal exception.
void	printStackTrace() Prints this exception and its backtrace to the standard error stream.
void	printStackTrace(java.io.PrintStream s) Prints this exception and its backtrace to the specified print stream.
void	printStackTrace(java.io.PrintWriter s) Prints this exception and its backtrace to the specified print writer.
java.lang.String	toString()

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getMessage

Methods inherited from class java.lang.Object

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

Constructor Detail

LimeException

public LimeException(java.lang.Exception internal)

Creates an exception that wraps an internal exception.

Parameters:

internal - the internal exception.

LimeException

public LimeException()

Creates a new exception with no internal, lower-level exception.

LimeException

public LimeException(java.lang.String s)

Creates a new exception with no internal, lower-level exception.

Parameters:

s - an explanatory message for the exception.

LimeException

public LimeException(java.lang.Exception internal,
                     java.lang.String s)

Creates an exception that wraps an internal exception.

Parameters:

internal - the internal exception.

s - an explanatory message for the exception.

Method Detail

hasInternal

public boolean hasInternal()

Tests whether this exception contains an internal exception.

Returns:

true if this exception contains an internal one, false otherwise.

getInternal

public java.lang.Exception getInternal()

Returns the internal exception associated with this object.

Returns:

the internal exception, null if there is none.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Throwable

printStackTrace

public void printStackTrace()

Prints this exception and its backtrace to the standard error stream.

Overrides:

printStackTrace in class java.lang.Throwable

printStackTrace

public void printStackTrace(java.io.PrintStream s)

Prints this exception and its backtrace to the specified print stream.

Overrides:

printStackTrace in class java.lang.Throwable

printStackTrace

public void printStackTrace(java.io.PrintWriter s)

Prints this exception and its backtrace to the specified print writer.

Overrides:

printStackTrace in class java.lang.Throwable