Module io.helidon.common.media.type
Package io.helidon.common.media.type

Class MediaTypes

java.lang.Object
io.helidon.common.media.type.MediaTypes
public final class MediaTypes extends Object
Media type detection based on a resource.

The media type detection uses the following algorithm:

  • Queries MediaTypeDetector services in priority order
  • Checks all META-INF/media-types.properties files on classpath for a mapping (suffix=media type)
  • Checks built-in mapping provided by Helidon (with the usual the web relevant media types)

  • Field Details

    • WILDCARD

      public static final MediaType WILDCARD
      Wildcard media type.

    • APPLICATION_XML

      public static final MediaType APPLICATION_XML
      application/xml media type.

    • APPLICATION_ATOM_XML

      public static final MediaType APPLICATION_ATOM_XML
      application/atom+xml media type.

    • APPLICATION_XHTML_XML

      public static final MediaType APPLICATION_XHTML_XML
      application/xhtml+xml media type.

    • APPLICATION_SVG_XML

      public static final MediaType APPLICATION_SVG_XML
      application/svg+xml media type.

    • APPLICATION_JSON

      public static final MediaType APPLICATION_JSON
      application/json media type.

    • APPLICATION_JSON_PATCH_JSON

      public static final MediaType APPLICATION_JSON_PATCH_JSON
      application/json-patch+json media type.

    • APPLICATION_STREAM_JSON

      public static final MediaType APPLICATION_STREAM_JSON
      application/stream+json media type.

    • APPLICATION_FORM_URLENCODED

      public static final MediaType APPLICATION_FORM_URLENCODED
      application/x-www-form-urlencoded media type.

    • MULTIPART_FORM_DATA

      public static final MediaType MULTIPART_FORM_DATA
      multipart/form-data media type.

    • MULTIPART_BYTERANGES

      public static final MediaType MULTIPART_BYTERANGES
      multipart/byte-ranges media type.

    • APPLICATION_OCTET_STREAM

      public static final MediaType APPLICATION_OCTET_STREAM
      application/octet-stream media type.

    • TEXT_PLAIN

      public static final MediaType TEXT_PLAIN
      tet/plain media type.

    • TEXT_XML

      public static final MediaType TEXT_XML
      text/xml media type.

    • TEXT_HTML

      public static final MediaType TEXT_HTML
      text/html media type.

    • APPLICATION_OPENAPI_YAML

      public static final MediaType APPLICATION_OPENAPI_YAML
      application/vnd.oai.openapi media type.

    • APPLICATION_OPENAPI_JSON

      public static final MediaType APPLICATION_OPENAPI_JSON
      application/vnd.oai.openapi+json media type.

    • APPLICATION_OPENMETRICS_TEXT

      public static final MediaType APPLICATION_OPENMETRICS_TEXT
      application/openmetrics-text media type.

    • APPLICATION_X_YAML

      public static final MediaType APPLICATION_X_YAML
      application/x-yaml media type.

    • APPLICATION_YAML

      public static final MediaType APPLICATION_YAML
      application/yaml media type.

    • TEXT_X_YAML

      public static final MediaType TEXT_X_YAML
      text/x-yaml media type.

    • TEXT_YAML

      public static final MediaType TEXT_YAML
      text/yaml media type.

    • APPLICATION_JAVASCRIPT

      public static final MediaType APPLICATION_JAVASCRIPT
      application/javascript media type.

    • TEXT_EVENT_STREAM

      public static final MediaType TEXT_EVENT_STREAM
      text/event-stream media type.

    • APPLICATION_X_NDJSON

      public static final MediaType APPLICATION_X_NDJSON
      application/x-ndjson media type.

    • APPLICATION_HOCON

      public static final MediaType APPLICATION_HOCON
      application/hocon media type.

    • WILDCARD_VALUE

      public static final String WILDCARD_VALUE
      String value of media type: "*/*".
      See Also:

    • APPLICATION_XML_VALUE

      public static final String APPLICATION_XML_VALUE
      String value of media type: "application/xml".
      See Also:

    • APPLICATION_ATOM_XML_VALUE

      public static final String APPLICATION_ATOM_XML_VALUE
      String value of media type: "application/atom+xml".
      See Also:

    • APPLICATION_XHTML_XML_VALUE

      public static final String APPLICATION_XHTML_XML_VALUE
      String value of media type: "application/xhtml+xml".
      See Also:

    • APPLICATION_SVG_XML_VALUE

      public static final String APPLICATION_SVG_XML_VALUE
      String value of media type: "application/svg+xml".
      See Also:

    • APPLICATION_JSON_VALUE

      public static final String APPLICATION_JSON_VALUE
      String value of media type: "application/json".
      See Also:

    • APPLICATION_JSON_PATCH_JSON_VALUE

      public static final String APPLICATION_JSON_PATCH_JSON_VALUE
      String value of media type: "application/json-patch+json".
      See Also:

    • APPLICATION_STREAM_JSON_VALUE

      public static final String APPLICATION_STREAM_JSON_VALUE
      String value of media type: "application/stream+json".
      See Also:

    • APPLICATION_FORM_URLENCODED_VALUE

      public static final String APPLICATION_FORM_URLENCODED_VALUE
      String value of media type: "application/x-www-form-urlencoded".
      See Also:

    • MULTIPART_FORM_DATA_VALUE

      public static final String MULTIPART_FORM_DATA_VALUE
      String value of media type: "multipart/form-data".
      See Also:

    • MULTIPART_BYTERANGES_VALUE

      public static final String MULTIPART_BYTERANGES_VALUE
      String value of media type: "multipart/byteranges".
      See Also:

    • APPLICATION_OCTET_STREAM_VALUE

      public static final String APPLICATION_OCTET_STREAM_VALUE
      String value of media type: "application/octet-stream".
      See Also:

    • TEXT_PLAIN_VALUE

      public static final String TEXT_PLAIN_VALUE
      String value of media type: "text/plain".
      See Also:

    • TEXT_XML_VALUE

      public static final String TEXT_XML_VALUE
      String value of media type: "text/xml".
      See Also:

    • TEXT_HTML_VALUE

      public static final String TEXT_HTML_VALUE
      String value of media type: "text/html".
      See Also:

    • APPLICATION_OPENMETRICS_TEXT_VALUE

      public static final String APPLICATION_OPENMETRICS_TEXT_VALUE
      String value of media type: "application/openmetrics-text".
      See Also:

    • APPLICATION_OPENAPI_YAML_VALUE

      public static final String APPLICATION_OPENAPI_YAML_VALUE
      String value of media type: "application/vnd.oai.openapi".
      See Also:

    • APPLICATION_OPENAPI_JSON_VALUE

      public static final String APPLICATION_OPENAPI_JSON_VALUE
      String value of media type: "application/vnd.oai.openapi+json".
      See Also:

    • APPLICATION_X_YAML_VALUE

      public static final String APPLICATION_X_YAML_VALUE
      String value of media type: "application/x-yaml".
      See Also:

    • APPLICATION_YAML_VALUE

      public static final String APPLICATION_YAML_VALUE
      String value of media type: "application/yaml".
      See Also:

    • TEXT_X_YAML_VALUE

      public static final String TEXT_X_YAML_VALUE
      String value of media type: "text/x-yaml".
      See Also:

    • TEXT_YAML_VALUE

      public static final String TEXT_YAML_VALUE
      String value of media type: "text/yaml".
      See Also:

    • APPLICATION_JAVASCRIPT_VALUE

      public static final String APPLICATION_JAVASCRIPT_VALUE
      String value of media type: "application/javascript".
      See Also:

    • TEXT_EVENT_STREAM_VALUE

      public static final String TEXT_EVENT_STREAM_VALUE
      String value of media type: "text/event-stream".
      See Also:

    • APPLICATION_X_NDJSON_VALUE

      public static final String APPLICATION_X_NDJSON_VALUE
      String value of media type: "application/x-ndjson".
      See Also:

    • APPLICATION_HOCON_VALUE

      public static final String APPLICATION_HOCON_VALUE
      String value of media type: "application/hocon".
      See Also:

  • Method Details

    • create

      public static MediaType create(String type, String subtype)
      Create media type from the type and subtype.
      Parameters:
      type - type
      subtype - subtype
      Returns:
      media type for the instance

    • create

      public static MediaType create(String fullType)
      Create a new media type from the full media type string. Strict media type parsing mode is used.
      Parameters:
      fullType - media type string, such as application/json
      Returns:
      media type for the string

    • create

      public static MediaType create(String fullType, ParserMode parserMode)
      Create a new media type from the full media type string.
      Parameters:
      fullType - media type string, such as application/json
      parserMode - media type parsing mode
      Returns:
      media type for the string

    • detectType

      public static Optional<MediaType> detectType(URL url)
      Detect media type based on URL. As there may be an infinite number of urls used in a system, the results are NOT cached.
      Parameters:
      url - to determine media type for
      Returns:
      media type or empty if none found

    • detectType

      public static Optional<MediaType> detectType(URI uri)
      Detect media type based on URI. Results may not be cached.
      Parameters:
      uri - to determine media type for
      Returns:
      media type or empty if none found

    • detectType

      public static Optional<MediaType> detectType(Path file)
      Detect media type for a file on file system. Results may not be cached.
      Parameters:
      file - file on a file system
      Returns:
      media type or empty if none found

    • detectType

      public static Optional<MediaType> detectType(String fileName)
      Detect media type for a path (may be URL, URI, path on a file system). Results may not be cached. If you have URL, URI, or Path please use the other methods on this class.
      Parameters:
      fileName - any string that has a file name as its last element
      Returns:
      media type or empty if none found
      See Also:

    • detectExtensionType

      public static Optional<MediaType> detectExtensionType(String fileSuffix)
      Detecd media type for a specific file extension. Results are cached.
      Parameters:
      fileSuffix - suffix of a file, such as txt, properties, or jpeg. Without the leading dot.
      Returns:
      media type for the file suffix or empty if none found