Class TransformException
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
NoninvertibleTransformException
,ProjectionException
,TransformPathNotFoundException
Common superclass for a number of transformation-related exceptions.
TransformException
are thrown by
MathTransform
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 when CoordinateOperationFactory
fails to find a path between two
coordinate reference systems.- Since:
- GeoAPI 1.0
- Author:
- Martin Desruisseaux (IRD)
- See Also:
-
Constructor Summary
ConstructorsConstructorDescriptionConstructs 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
Modifier and TypeMethodDescriptionReturns 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 Details
-
TransformException
public TransformException()Constructs an exception with no detail message. -
TransformException
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
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 Details
-
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
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
- Overrides:
fillInStackTrace
in classThrowable
-
runWithoutStackTraces
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.
-