Package ptolemy.kernel.util

Class InvalidStateException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

ptolemy.kernel.util.KernelRuntimeException

ptolemy.kernel.util.InvalidStateException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

GraphInvalidStateException, NotSchedulableException

public class InvalidStateException
extends KernelRuntimeException

Some object or set of objects has a state that is not permitted. E.g., a NamedObj has a null name. Or a topology has inconsistent or contradictory information in it, e.g. an entity contains a port that has a different entity as it container. Our design should make it impossible for this exception to ever occur, so occurrence is a bug.

Since:

Ptolemy II 0.2

Version:

$Id$

Author:

Edward A. Lee, Jie Liu

See Also:

Serialized Form

Pt.AcceptedRating:

Green (cxh)

Pt.ProposedRating:

Green (cxh)

Constructor Summary

Constructors

Constructor	Description
InvalidStateException(java.lang.String detail)	Construct an exception with only a detail message.
InvalidStateException(java.util.Collection objects, java.lang.String detail)	Constructs an exception with a detail message that includes the names of a collection of nameable objects plus the argument string.
InvalidStateException(java.util.Collection objects, java.lang.Throwable cause, java.lang.String detail)	Constructs an exception with a detail message that includes the names of a collection of nameable objects plus the argument string.
InvalidStateException(java.util.Enumeration objects, java.lang.String detail)	Deprecated. Use InvalidStateException(Collection, String) instead.
InvalidStateException(Nameable object, java.lang.String detail)	Construct an exception with a detail message that includes the name of the first argument and the second argument string.
InvalidStateException(Nameable object, java.lang.Throwable cause, java.lang.String detail)	Construct an exception with a detail message that includes the name of the first argument, the cause and the third argument string.
InvalidStateException(Nameable object1, Nameable object2, java.lang.String detail)	Construct an exception with a detail message that includes the names of the first two arguments plus the third argument string.
InvalidStateException(Nameable object1, Nameable object2, java.lang.Throwable cause, java.lang.String detail)	Construct an exception with a detail message that includes the names of the first two arguments plus the third argument string.

Method Summary

Methods inherited from class ptolemy.kernel.util.KernelRuntimeException

_setCause, _setMessage, getCause, getMessage, getNameables, printStackTrace, printStackTrace, printStackTrace

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getStackTrace, getSuppressed, initCause, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

InvalidStateException

public InvalidStateException(java.lang.String detail)

Construct an exception with only a detail message.

Parameters:

detail - The message.

InvalidStateException

public InvalidStateException(Nameable object,
                             java.lang.Throwable cause,
                             java.lang.String detail)

Construct an exception with a detail message that includes the name of the first argument, the cause and the third argument string.

Parameters:

object - The nameable object involved in the exception

cause - The cause of this exception.

detail - The message.

InvalidStateException

public InvalidStateException(Nameable object,
                             java.lang.String detail)

Construct an exception with a detail message that includes the name of the first argument and the second argument string.

Parameters:

object - The object.

detail - The message.

InvalidStateException

public InvalidStateException(Nameable object1,
                             Nameable object2,
                             java.lang.String detail)

Construct an exception with a detail message that includes the names of the first two arguments plus the third argument string.

Parameters:

object1 - The first object.

object2 - The second object.

detail - The message.

InvalidStateException

public InvalidStateException(Nameable object1,
                             Nameable object2,
                             java.lang.Throwable cause,
                             java.lang.String detail)

Construct an exception with a detail message that includes the names of the first two arguments plus the third argument string.

Parameters:

object1 - The first object.

object2 - The second object.

cause - The cause of this exception.

detail - The message.

InvalidStateException

@Deprecated
public InvalidStateException(java.util.Enumeration objects,
                             java.lang.String detail)

Deprecated.

Use InvalidStateException(Collection, String) instead.

Construct an exception with a detail message that includes the names of an enumeration of nameable object plus the argument string.

Parameters:

objects - The enumeration of Nameable objects

detail - The message.

InvalidStateException

public InvalidStateException(java.util.Collection objects,
                             java.lang.String detail)

Constructs an exception with a detail message that includes the names of a collection of nameable objects plus the argument string.

Parameters:

objects - The Collection of Nameable objects

detail - The message.

InvalidStateException

public InvalidStateException(java.util.Collection objects,
                             java.lang.Throwable cause,
                             java.lang.String detail)

Constructs an exception with a detail message that includes the names of a collection of nameable objects plus the argument string.

Parameters:

objects - The Collection of Nameable objects

cause - The cause of this exception.

detail - The message.