com.luciad.util

LuciadLightspeedClass TLcdNoBoundsException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.luciad.util.TLcdNoBoundsException

All Implemented Interfaces:

Serializable

public class TLcdNoBoundsException
extends Exception

TLcdNoBoundsException is an Exception that is thrown when it is impossible to compute valid bounds. This may happen when the geometry is empty, or when the geometry has no valid coordinates in the coordinate space that is considered, for instance.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TLcdNoBoundsException()
TLcdNoBoundsException(String aMessage)
TLcdNoBoundsException(String aMessage, Throwable aCause)

Method Summary

Modifier and Type	Method and Description
static TLcdNoBoundsException	getSharedInstance() Utility method that returns a shared no bounds exception.
static void	setStackTraceOn(boolean aStackTraceOn) When set to true this ensures that the correct stack trace is built for the shared instance.

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

TLcdNoBoundsException

public TLcdNoBoundsException()

TLcdNoBoundsException

public TLcdNoBoundsException(String aMessage)

TLcdNoBoundsException

public TLcdNoBoundsException(String aMessage,
                             Throwable aCause)

Method Detail

getSharedInstance

public static TLcdNoBoundsException getSharedInstance()

Utility method that returns a shared no bounds exception. This method exists solely for performance reasons: classes that throw many no bounds exceptions should use the exception generated by this method. The stack trace of the exception will not contain the actual location the exception is thrown.

If a correct stack trace is required set the stackTraceOn property to true. This method then creates a new no bounds exception for every call to this method. This can lead to a severe performance penalty when many exceptions are thrown so use it only for debugging.

See Also:

setStackTraceOn(boolean)

setStackTraceOn

public static void setStackTraceOn(boolean aStackTraceOn)

When set to true this ensures that the correct stack trace is built for the shared instance. Use only for debugging, since this can lead to a severe performance penalty.

Parameters:

aStackTraceOn - whether or not the correct stack trace should be constructed for the shared instance.

See Also:

getSharedInstance()