Class TransformException

Object
Throwable
Exception
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 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 Details

    • 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 the Throwable.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 the Throwable.getMessage() method.
      cause - The cause for this exception. The cause is saved for later retrieval by the Throwable.getCause() method.
  • Method Details

    • 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 be null 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 class Throwable
    • runWithoutStackTraces

      public static <T> T runWithoutStackTraces(Callable<T> callable)
      This allows executing a callable with TransformException 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.