Package org.kiwiproject.jaxrs

Class KiwiMultivaluedMaps

  • public class KiwiMultivaluedMaps
extends Object
    Static utilities for working with MultivaluedMap instances.

    • Constructor Detail

      • KiwiMultivaluedMaps

        public KiwiMultivaluedMaps()

    • Method Detail

      • newMultivaluedMap

        public static javax.ws.rs.core.MultivaluedMap<String,​String> newMultivaluedMap​(String... items)
        Create a new MultivaluedMap from the given items, which are expected to be in alternating key/value pairs. This allows for keys to be repeated, i.e. so that a single key can have multiple values.
        Parameters:
        items - the keys and values, e.g. key1, value1, key2, value2, ...
        Returns:
        a new MultivaluedMap
        Implementation Note:
        the actual type returned is currently a MultivaluedHashMap

      • newSingleValuedParameterMap

        public static javax.ws.rs.core.MultivaluedMap<String,​String> newSingleValuedParameterMap​(String... items)
        Create a new MultivaluedMap from the given items, which are expected to be in alternating key/value pairs.

        NOTE: Unlike newMultivaluedMap(String...), this method assumes you want only one value per key, even if items contains multiple values per key. In that case, the last value in items associated with a given key is the one that "wins" and stays in the returned map.

        Parameters:
        items - the keys and values, e.g. key1, value1, key2, value2, ...
        Returns:
        a new MultivaluedMap
        Implementation Note:
        the actual type returned is currently a MultivaluedHashMap

      • toSingleValuedParameterMap

        public static Map<String,​String> toSingleValuedParameterMap​(javax.ws.rs.core.MultivaluedMap<String,​String> original)
        Converts the given MultivaluedMap to a single-valued JDK Map by getting only the first element for each key in the multi-valued map. This means that if there are keys having multiple values, elements past the first one are ignored.
        Parameters:
        original - the original multi-valued map to convert
        Returns:
        the single-valued JDK map

      • toMultimap

        public static com.google.common.collect.Multimap<String,​String> toMultimap​(javax.ws.rs.core.MultivaluedMap<String,​String> original)
        Convert the given MultivaluedMap into a Guava Multimap.
        Parameters:
        original - the original multi-valued map to convert
        Returns:
        the Guava multimap