Class ProjectionException
java.lang.Object
java.lang.Throwable
java.lang.Exception
org.opengis.referencing.operation.TransformException
org.apache.sis.referencing.operation.projection.ProjectionException
- All Implemented Interfaces:
Serializable
public class ProjectionException
extends org.opengis.referencing.operation.TransformException
Thrown by
NormalizedProjection
when a map projection failed.
When this exception is thrown
Apache SIS implementations of map projections return a finite number under normal conditions, but may also return an infinite number or NaN value, or throw this exception. The behavior depends on the reason why the projection cannot return a finite number:- If the expected mathematical value is infinite (for example the Mercator projection at ±90° of latitude),
then the map projection should return a
Double.POSITIVE_INFINITY
orDouble.NEGATIVE_INFINITY
, depending on the sign of the correct mathematical answer. - If no real number is expected to exist for the input coordinates (for example at a latitude greater than 90°),
then the map projection should return
Double.NaN
. - If a real number is expected to exist but the map projection fails to compute it (for example because an
iterative algorithm does not converge), then the projection should throw
ProjectionException
.
- Since:
- 0.6
- Version:
- 0.6
- See Also:
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final long
Serial number for inter-operability with different versions. -
Constructor Summary
ConstructorsConstructorDescriptionConstructs a new exception with no detail message.ProjectionException
(String message) Constructs a new exception with the specified detail message.ProjectionException
(String message, Throwable cause) Constructs a new exception with the specified detail message and cause.ProjectionException
(Throwable cause) Constructs a new exception with the specified cause. -
Method Summary
Methods inherited from class org.opengis.referencing.operation.TransformException
getLastCompletedTransform, setLastCompletedTransform
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Field Details
-
serialVersionUID
private static final long serialVersionUIDSerial number for inter-operability with different versions.- See Also:
-
-
Constructor Details
-
ProjectionException
public ProjectionException()Constructs a new exception with no detail message. -
ProjectionException
Constructs a new exception with the specified detail message.- Parameters:
message
- the details message, ornull
if none.
-
ProjectionException
Constructs a new exception with the specified cause. The details message is copied from the cause.- Parameters:
cause
- the cause, ornull
if none.
-
ProjectionException
Constructs a new exception with the specified detail message and cause.- Parameters:
message
- the details message, ornull
if none.cause
- the cause, ornull
if none.
-