Package org.apache.sis.storage
Class DataStoreContentException
Object
Throwable
Exception
DataStoreException
DataStoreContentException
- All Implemented Interfaces:
Serializable
,LocalizedException
- Direct Known Subclasses:
UnsupportedEncodingException
Thrown when a store can not be read because the stream contains invalid data.
It may be for example a logical inconsistency, or a reference not found,
or an unsupported file format version, etc.
Note:
exceptions that are caused by
IOException
or SQLException
should generally be wrapped by another type of DataStoreException
, unless the data
store can determine that the error was caused by a problem with the stream content rather
than some I/O problems.- Since:
- 0.8
- See Also:
Defined in the sis-storage
module
-
Constructor Summary
ConstructorsConstructorDescriptionDataStoreContentException
(String message) Creates an exception with the specified details message.DataStoreContentException
(String message, Throwable cause) Creates an exception with the specified details message and cause.Creates an exception with the specified cause and no details message.DataStoreContentException
(Locale locale, String format, String filename, Object store) Creates a localized exception with a message saying that the given store can not be read. -
Method Summary
Methods inherited from class DataStoreException
getInternationalMessage, getLocalizedMessage, getMessage, initCause
Methods inherited from class Throwable
addSuppressed, fillInStackTrace, getCause, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Constructor Details
-
DataStoreContentException
Creates an exception with the specified details message.- Parameters:
message
- the detail message.
-
DataStoreContentException
Creates an exception with the specified cause and no details message.- Parameters:
cause
- the cause for this exception.
-
DataStoreContentException
Creates an exception with the specified details message and cause.- Parameters:
message
- the detail message.cause
- the cause for this exception.
-
DataStoreContentException
Creates a localized exception with a message saying that the given store can not be read. Location in the file where the error occurred while be fetched from the givenstore
argument if possible. If the given store is not recognized, then it will be ignored.Examples of messages created by this constructor:
- Can not read “Foo” as a file in the Bar format.
- Can not read after column 10 or line 100 of “Foo” as part of a file in the Bar format.
- Parameters:
locale
- the locale of the message to be returned byDataStoreException.getLocalizedMessage()
, ornull
.format
- short name or abbreviation of the data format (e.g. "CSV", "GML", "WKT", etc).filename
- name of the file or data store where the error occurred.store
- the input or output object from which to get the current position, ornull
if none. This can be aLineNumberReader
orXMLStreamReader
for example.
-