Package org.eclipse.rdf4j.common.lang

Class FileFormat

java.lang.Object
org.eclipse.rdf4j.common.lang.FileFormat
Direct Known Subclasses:
QueryResultFormat, RDFFormat
public class FileFormat extends Object
Abstract representation of a file format. File formats are identified by a name and can have one or more associated MIME types, zero or more associated file extensions and can specify a (default) character encoding.
Author:
Arjohn Kampman

  • Constructor Details

    • FileFormat

      public FileFormat(String name, String mimeType, Charset charset, String fileExtension)
      Creates a new FileFormat object.
      Parameters:
      name - The name of the file format, e.g. "PLAIN TEXT".
      mimeType - The (default) MIME type of the file format, e.g. text/plain for plain text files.
      charset - The default character encoding of the file format. Specify null if not applicable.
      fileExtension - The (default) file extension for the file format, e.g. txt for plain text files.

    • FileFormat

      public FileFormat(String name, String mimeType, Charset charset, Collection<String> fileExtensions)
      Creates a new FileFormat object.
      Parameters:
      name - The name of the file format, e.g. "PLAIN TEXT".
      mimeType - The (default) MIME type of the file format, e.g. text/plain for plain text files.
      charset - The default character encoding of the file format. Specify null if not applicable.
      fileExtensions - The file format's file extension(s), e.g. txt for plain text files. The first item in the list is interpreted as the default file extension for the format.

    • FileFormat

      public FileFormat(String name, Collection<String> mimeTypes, Charset charset, Collection<String> fileExtensions)
      Creates a new FileFormat object.
      Parameters:
      name - The name of the file format, e.g. "PLAIN TEXT".
      mimeTypes - The MIME type(s) of the file format, e.g. text/plain for theplain text files. The first item in the list is interpreted as the default MIME type for the format. The supplied list should contain at least one MIME type.
      charset - The default character encoding of the file format. Specify null if not applicable.
      fileExtensions - The file format's file extension(s), e.g. txt for plain text files. The first item in the list is interpreted as the default file extension for the format.

  • Method Details

    • getName

      public String getName()
      Gets the name of this file format.
      Returns:
      A human-readable format name, e.g. "PLAIN TEXT".

    • getDefaultMIMEType

      public String getDefaultMIMEType()
      Gets the default MIME type for this file format.
      Returns:
      A MIME type string, e.g. "text/plain".

    • hasDefaultMIMEType

      public boolean hasDefaultMIMEType(String mimeType)
      Checks if the specified MIME type matches the FileFormat's default MIME type. The MIME types are compared ignoring upper/lower-case differences.
      Parameters:
      mimeType - The MIME type to compare to the FileFormat's default MIME type.
      Returns:
      true if the specified MIME type matches the FileFormat's default MIME type.

    • getMIMETypes

      public List<String> getMIMETypes()
      Gets the file format's MIME types.
      Returns:
      An unmodifiable list of MIME type strings, e.g. "text/plain".

    • hasMIMEType

      public boolean hasMIMEType(String mimeType)
      Checks if specified MIME type matches one of the FileFormat's MIME types. The MIME types are compared ignoring upper/lower-case differences.
      Parameters:
      mimeType - The MIME type to compare to the FileFormat's MIME types.
      Returns:
      true if the specified MIME type matches one of the FileFormat's MIME types.

    • getDefaultFileExtension

      public String getDefaultFileExtension()
      Gets the default file name extension for this file format.
      Returns:
      A file name extension (excluding the dot), e.g. "txt", or null if there is no common file extension for the format.

    • hasDefaultFileExtension

      public boolean hasDefaultFileExtension(String extension)
      Checks if the specified file name extension matches the FileFormat's default file name extension. The file name extension MIME types are compared ignoring upper/lower-case differences.
      Parameters:
      extension - The file extension to compare to the FileFormat's file extension.
      Returns:
      true if the file format has a default file name extension and if it matches the specified extension, false otherwise.

    • getFileExtensions

      public List<String> getFileExtensions()
      Gets the file format's file extensions.
      Returns:
      An unmodifiable list of file extension strings, e.g. "txt".

    • hasFileExtension

      public boolean hasFileExtension(String extension)
      Checks if the FileFormat's file extension is equal to the specified file extension. The file extensions are compared ignoring upper/lower-case differences.
      Parameters:
      extension - The file extension to compare to the FileFormat's file extension.
      Returns:
      true if the specified file extension is equal to the FileFormat's file extension.

    • getCharset

      public Charset getCharset()
      Get the (default) charset for this file format.
      Returns:
      the (default) charset for this file format, or null if this format does not have a default charset.

    • hasCharset

      public boolean hasCharset()
      Checks if the FileFormat has a (default) charset.
      Returns:
      true if the FileFormat has a (default) charset.

    • equals

      public boolean equals(Object other)
      Compares FileFormat objects based on their name, ignoring case.
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • matchMIMEType

      public static <FF extends FileFormat> Optional<FF> matchMIMEType(String mimeType, Iterable<FF> fileFormats)
      Tries to match the specified MIME type with the MIME types of the supplied file formats.
      Parameters:
      mimeType - A MIME type, e.g. "text/plain".
      fileFormats - The file formats to match the MIME type against.
      Returns:
      A FileFormat object if the MIME type was recognized, or Optional.empty() otherwise.

    • matchFileName

      public static <FF extends FileFormat> Optional<FF> matchFileName(String fileName, Iterable<FF> fileFormats)
      Tries to match the specified file name with the file extensions of the supplied file formats.
      Parameters:
      fileName - A file name.
      fileFormats - The file formats to match the file name extension against.
      Returns:
      A FileFormat that matches the file name extension, or Optional.empty() otherwise.