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