Class DataStoreContentException

  • All Implemented Interfaces:
    Serializable, Localized­Exception

    public class DataStoreContentException
    extends DataStoreException
    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 Data­Store­Exception, 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:
    Serialized Form

    Defined in the sis-storage module

    • Constructor Detail

      • DataStoreContentException

        public DataStoreContentException​(String message)
        Creates an exception with the specified details message.
        Parameters:
        message - the detail message.
      • DataStoreContentException

        public DataStoreContentException​(Throwable cause)
        Creates an exception with the specified cause and no details message.
        Parameters:
        cause - the cause for this exception.
      • DataStoreContentException

        public DataStoreContentException​(String message,
                                         Throwable cause)
        Creates an exception with the specified details message and cause.
        Parameters:
        message - the detail message.
        cause - the cause for this exception.
      • DataStoreContentException

        public 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. Location in the file where the error occurred while be fetched from the given store 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 by Data­Store­Exception​.get­Localized­Message(), or null.
        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, or null if none. This can be a Line­Number­Reader or XMLStream­Reader for example.