com.sharkysoft.fig.extra.dev

Class NotImplementedException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.sharkysoft.fig.extra.dev.NotImplementedException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

UnderConstructionException

public class NotImplementedException
extends RuntimeException

Indicates an unfinished execution path.

Details: A NotImplementedException is thrown when a method is called, a case invoked, or a feature is requested that has not been implemented.

Since:

1997

Version:

1999.04.19

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
NotImplementedException() Initializes without detail.
NotImplementedException(String iDetail) Initializes with detail.
NotImplementedException(String iMessage, Throwable iCause)
NotImplementedException(Throwable iCause)

Method Summary

Methods

Modifier and Type	Method and Description
static void	trace() Prints stack trace of unimplemented execution path.
static void	trace(String iDetail) Prints stack trace of unimplemented execution path.

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

NotImplementedException

public NotImplementedException()

Initializes without detail.

Details: This default constructor initializes a new instance without a detail message.

NotImplementedException

public NotImplementedException(String iDetail)

Initializes with detail.

Details: This constructor initializes a new instance with the given detail message.

Parameters:

iDetail - the messsage

NotImplementedException

public NotImplementedException(String iMessage,
                       Throwable iCause)

NotImplementedException

public NotImplementedException(Throwable iCause)

Method Detail

trace

public static void trace(String iDetail)

Prints stack trace of unimplemented execution path.

Details: trace instantiates a new NotImplementedException without throwing it, and then outputs its stack trace to System.err. This is useful for tracking unfinished code paths which must be allowed to operate, albeit temporarily, in their unfinished state. The provided detail message is included in the stack trace.

Parameters:

iDetail - detail message

Since:

1999.06.04

See Also:

trace()

trace

public static void trace()

Prints stack trace of unimplemented execution path.

Details: trace() is the same as trace(String), except that no detail message is used.

Since:

1999.06.04

See Also:

trace(String)