Class TransformException
-
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
NoninvertibleTransformException
,ProjectionException
,TransformPathNotFoundException
public class TransformException extends Exception
Common superclass for a number of transformation-related exceptions.TransformException
are thrown byMathTransform
when a coordinate transformation can't be inverted (NoninvertibleTransformException
), when the derivative can't be computed or when a coordinate can't be transformed. It is also thrown whenCoordinateOperationFactory
fails to find a path between two coordinate reference systems.- Since:
- GeoAPI 1.0
- Author:
- Martin Desruisseaux (IRD)
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description TransformException()
Constructs an exception with no detail message.TransformException(String message)
Constructs an exception with the specified detail message.TransformException(String message, Throwable cause)
Constructs an exception with the specified detail message and cause.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description Throwable
fillInStackTrace()
MathTransform
getLastCompletedTransform()
Returns the last transform that either transformed successfuly all coordinates, or filled the untransformable coordinates with NaN values.static <T> T
runWithoutStackTraces(Callable<T> callable)
This allows executing a callable withTransformException
not filling its stack trace while being thrown.void
setLastCompletedTransform(MathTransform transform)
Sets the last transform that either transformed successfuly all coordinates, or filled the untransformable coordinates with NaN values.-
Methods inherited from class Throwable
addSuppressed, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
TransformException
public TransformException()
Constructs an exception with no detail message.
-
TransformException
public TransformException(String message)
Constructs an exception with the specified detail message.- Parameters:
message
- The detail message. The detail message is saved for later retrieval by theThrowable.getMessage()
method.
-
TransformException
public TransformException(String message, Throwable cause)
Constructs an exception with the specified detail message and cause.- Parameters:
message
- The detail message. The detail message is saved for later retrieval by theThrowable.getMessage()
method.cause
- The cause for this exception. The cause is saved for later retrieval by theThrowable.getCause()
method.
-
-
Method Detail
-
getLastCompletedTransform
public MathTransform getLastCompletedTransform()
Returns the last transform that either transformed successfuly all coordinates, or filled the untransformable coordinates with NaN values. This information is useful in the context of concatenated transforms. May benull
if unknown.- Returns:
- The last reliable transform.
- Since:
- GeoAPI 2.2
-
setLastCompletedTransform
public void setLastCompletedTransform(MathTransform transform)
Sets the last transform that either transformed successfuly all coordinates, or filled the untransformable coordinates with NaN values.- Parameters:
transform
- The last reliable transform.- Since:
- GeoAPI 2.2
-
fillInStackTrace
public Throwable fillInStackTrace()
- Overrides:
fillInStackTrace
in classThrowable
-
runWithoutStackTraces
public static <T> T runWithoutStackTraces(Callable<T> callable)
This allows executing a callable withTransformException
not filling its stack trace while being thrown. This is useful when the exception is expected to be caught and handled without the need to fill the stack trace (which can be quite expensive, if done many times in a tight loop).An eventual exception thrown by the callable will be wrapped in a
RuntimeException
and rethrown.
-
-