Package org.opengis.referencing.operation

Class TransformException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.opengis.referencing.operation.TransformException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

NoninvertibleTransformException

public class TransformException
extends java.lang.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:

1.0

Version:

3.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private MathTransform	lastCompletedTransform	The last transform that either transformed successfully all coordinates, or filled the untransformable coordinates with NaN values.
private static long	serialVersionUID	Serial number for inter-operability with different versions.

Constructor Summary

Constructors

Constructor	Description
TransformException()	Constructs an exception with no detail message.
TransformException(java.lang.String message)	Constructs an exception with the specified detail message.
TransformException(java.lang.String message, java.lang.Throwable cause)	Constructs an exception with the specified detail message and cause.

Method Summary

Modifier and Type	Method	Description
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 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

Field Detail

serialVersionUID

private static final long serialVersionUID

Serial number for inter-operability with different versions.

See Also:

Constant Field Values

lastCompletedTransform

private MathTransform lastCompletedTransform

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.

Since:

2.2

See Also:

getLastCompletedTransform(), setLastCompletedTransform(MathTransform)

Constructor Detail

TransformException

public TransformException()

Constructs an exception with no detail message.

TransformException

public TransformException(java.lang.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(java.lang.String message,
                          java.lang.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:

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:

2.2