Class LocalizationGridException
Object
Throwable
Exception
FactoryException
FactoryDataException
LocalizationGridException
- All Implemented Interfaces:
- Serializable
Thrown when a localization grid cannot be computed, presumably because of a problem with grid data.
 It may be because some grid coordinates are out of CRS domain of validity, causing either
 
MathTransform to be thrown or Double.NaN
 coordinate values to be computed.
 Additional information on exception cause
It is sometimes difficult to determine the root cause of this exception. For example, grid points slightly outside the CRS domain of validity will not necessarily cause a failure. A strategy can be to try to build the grid anyway, and in case of failure declare that the grid was maybe too far from CRS domain of validity. Because the potential causes are better known by the code that wants a localization grid instead of theLocalizationGridBuilder class, LocalizationGridException
 provides a setPotentialCause(CharSequence) method for allowing top-level code to attach additional
 information to this exception.- Since:
- 1.2
- See Also:
- 
Constructor SummaryConstructorsConstructorDescriptionConstruct an exception with no detail message.LocalizationGridException(String message) Constructs an exception with the specified detail message.LocalizationGridException(String message, Throwable cause) Constructs an exception with the specified detail message and cause.Constructs an exception with the specified cause.
- 
Method SummaryModifier and TypeMethodDescriptionReturns the value given to the last call ofsetPotentialCause(CharSequence).voidsetPotentialCause(CharSequence details) Specifies additional information about what may be the cause of this exception.Methods inherited from class ThrowableaddSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
- 
Constructor Details- 
LocalizationGridExceptionpublic LocalizationGridException()Construct an exception with no detail message.
- 
LocalizationGridExceptionConstructs an exception with the specified detail message.- Parameters:
- message- the detail message, saved for later retrieval by the- Throwable.getMessage()method.
 
- 
LocalizationGridExceptionConstructs an exception with the specified cause.- Parameters:
- cause- the cause, saved for later retrieval by the- Throwable.getCause()method.
 
- 
LocalizationGridExceptionConstructs an exception with the specified detail message and cause. The cause is the exception thrown in the underlying database (e.g.IOExceptionorSQLException).- Parameters:
- message- the detail message, saved for later retrieval by the- Throwable.getMessage()method.
- cause- the cause, saved for later retrieval by the- Throwable.getCause()method.
 
 
- 
- 
Method Details- 
setPotentialCauseSpecifies additional information about what may be the cause of this exception. Example: "The grid spans more than 180° of longitude", which may be a cause of map projection failures.- Parameters:
- details- a potential cause, or- nullif none. The type should be- Stringor- InternationalString.
 
- 
getPotentialCauseReturns the value given to the last call ofsetPotentialCause(CharSequence).- Returns:
- potential cause, or nullif none. The type should beStringorInternationalString.
 
 
-