org.opengis.referencing.operation
Class TransformException

Object
  extended by Throwable
      extended by Exception
          extended by TransformException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
NoninvertibleTransformException

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
See Also:
Serialized Form
Departure from OGC/ISO specification:
This exception is not part of the OGC specification.

Constructor Summary
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
 MathTransform getLastCompletedTransform()
          Returns the last transform that either transformed successfully all coordinates, or filled the untransformable coordinates with NaN values.
 void setLastCompletedTransform(MathTransform transform)
          Sets the last transform that either transformed successfully all coordinates, or filled the untransformable coordinates with NaN values.
 
Methods inherited from class Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

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 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 Detail

getLastCompletedTransform

public MathTransform getLastCompletedTransform()
Returns the last transform that either transformed successfully 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 successfully all coordinates, or filled the untransformable coordinates with NaN values.

Parameters:
transform - The last reliable transform.
Since:
GeoAPI 2.2


Copyright © 1994-2011 Open Geospatial Consortium. All Rights Reserved.