Package org.kiwiproject.beta.net

Class KiwiMediaTypes

java.lang.Object
org.kiwiproject.beta.net.KiwiMediaTypes
@Beta public final class KiwiMediaTypes extends Object
Some utilities for working with media types.

Google Guava contains the MediaType class which represents an Internet Media Type. It contains some useful methods, but not some (what we think are) basic utilities such as the ability to check if a media type is XML. Both text/xml and application/xml represent XML documents, so checking whether a media type is XML should take this into account. But the Guava MediaType#is method doesn't permit comparing like this when the type is different but the subtype is the same.

The Jakarta RS MediaType is also useful, but its equals method unfortunately compares type, subtype, and parameters so you cannot use it to check if a media type such as "text/xml; charset=utf-8" equals the "text/xml" media type, since it will include the charset parameter in the comparison and return false.

Implementation Note:
Internally this uses Guava's MediaType to parse String media types.

  • Method Summary

    Modifier and Type
    Method
    Description
    static boolean
    isJson(jakarta.ws.rs.core.MediaType mediaType)
    Checks if the media type is "application/json", ignoring parameters such that "application/json; charset=utf-8" is considered JSON.
    static boolean
    isJson(String mediaType)
    Checks if the media type is "application/json", ignoring parameters such that "application/json; charset=utf-8" is considered JSON.
    static boolean
    isXml(jakarta.ws.rs.core.MediaType mediaType)
    Checks if the media type is "application/xml" or "text/xml", ignoring parameters such that "text/xml; charset=utf-8" is considered XML.
    static boolean
    isXml(String mediaType)
    Checks if the media type is "application/xml" or "text/xml", ignoring parameters such that "text/xml; charset=utf-8" is considered XML.
    static boolean
    matchesSubtype(String mediaType, String subtypeToMatch)
    Checks if the given media type has a type that matches the given value.
    static boolean
    matchesType(String mediaType, String typeToMatch)
    Checks if the given media type has a type that matches the given value.
    static String
    toStringWithoutParameters(jakarta.ws.rs.core.MediaType mediaType)
    Get the string value of the given MediaType with only the type/subtype.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Method Details

    • isXml

      public static boolean isXml(jakarta.ws.rs.core.MediaType mediaType)
      Checks if the media type is "application/xml" or "text/xml", ignoring parameters such that "text/xml; charset=utf-8" is considered XML.

      To use this method, the jakarta.ws.rs:jakarta.ws.rs-api dependency must be present.

      Parameters:
      mediaType - the media type to check
      Returns:
      true if the media type is an XML type ignoring any parameters, otherwise false

    • isXml

      public static boolean isXml(String mediaType)
      Checks if the media type is "application/xml" or "text/xml", ignoring parameters such that "text/xml; charset=utf-8" is considered XML.
      Parameters:
      mediaType - the media type to check
      Returns:
      true if the media type is an XML type ignoring any parameters, otherwise false

    • isJson

      public static boolean isJson(jakarta.ws.rs.core.MediaType mediaType)
      Checks if the media type is "application/json", ignoring parameters such that "application/json; charset=utf-8" is considered JSON.

      To use this method, the jakarta.ws.rs:jakarta.ws.rs-api dependency must be present.

      Parameters:
      mediaType - the media type to check
      Returns:
      true if the media type is JSON ignoring any parameters, otherwise false

    • toStringWithoutParameters

      public static String toStringWithoutParameters(jakarta.ws.rs.core.MediaType mediaType)
      Get the string value of the given MediaType with only the type/subtype.
      Implementation Note:
      This method concatenates the type and subtype of the MediaType because the MediaType#toString requires a Jakarta RS implementation to create a RuntimeDelegate which is then used to convert to a String. Presumably if this method is used, the implementation is available. However, just in case it isn't, this method manually creates the media type string using the type and subtype, since they are just fields in MediaType and don't need a Jakarta RS implementation to be available.

    • isJson

      public static boolean isJson(String mediaType)
      Checks if the media type is "application/json", ignoring parameters such that "application/json; charset=utf-8" is considered JSON.
      Parameters:
      mediaType - the media type to check
      Returns:
      true if the media type is JSON ignoring any parameters, otherwise false

    • matchesType

      public static boolean matchesType(String mediaType, String typeToMatch)
      Checks if the given media type has a type that matches the given value.
      Parameters:
      mediaType - the media type to check
      typeToMatch - the type to match
      Returns:
      true if the types match, otherwise false

    • matchesSubtype

      public static boolean matchesSubtype(String mediaType, String subtypeToMatch)
      Checks if the given media type has a type that matches the given value.
      Parameters:
      mediaType - the media type to check
      subtypeToMatch - the subtype to match
      Returns:
      true if the subtypes match, otherwise false