Class Joiner.MapJoiner

  • Enclosing class:
    Joiner

    public static final class Joiner.MapJoiner
    extends Object
    An object that joins map entries in the same manner as Joiner joins iterables and arrays. Like Joiner, it is thread-safe and immutable.

    In addition to operating on Map instances, MapJoiner can operate on Multimap entries in two distinct modes:

    • To output a separate entry for each key-value pair, pass multimap.entries() to a MapJoiner method that accepts entries as input, and receive output of the form key1=A&key1=B&key2=C.
    • To output a single entry for each key, pass multimap.asMap() to a MapJoiner method that accepts a map as input, and receive output of the form key1=[A, B]&key2=C.
    Since:
    2.0
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      <A extends Appendable>
      A
      appendTo​(A appendable, Iterable<? extends Map.Entry<?,​?>> entries)
      Appends the string representation of each entry in entries, using the previously configured separator and key-value separator, to appendable.
      <A extends Appendable>
      A
      appendTo​(A appendable, Iterator<? extends Map.Entry<?,​?>> parts)
      Appends the string representation of each entry in entries, using the previously configured separator and key-value separator, to appendable.
      <A extends Appendable>
      A
      appendTo​(A appendable, Map<?,​?> map)
      Appends the string representation of each entry of map, using the previously configured separator and key-value separator, to appendable.
      StringBuilder appendTo​(StringBuilder builder, Iterable<? extends Map.Entry<?,​?>> entries)
      Appends the string representation of each entry in entries, using the previously configured separator and key-value separator, to builder.
      StringBuilder appendTo​(StringBuilder builder, Iterator<? extends Map.Entry<?,​?>> entries)
      Appends the string representation of each entry in entries, using the previously configured separator and key-value separator, to builder.
      StringBuilder appendTo​(StringBuilder builder, Map<?,​?> map)
      Appends the string representation of each entry of map, using the previously configured separator and key-value separator, to builder.
      String join​(Iterable<? extends Map.Entry<?,​?>> entries)
      Returns a string containing the string representation of each entry in entries, using the previously configured separator and key-value separator.
      String join​(Iterator<? extends Map.Entry<?,​?>> entries)
      Returns a string containing the string representation of each entry in entries, using the previously configured separator and key-value separator.
      String join​(Map<?,​?> map)
      Returns a string containing the string representation of each entry of map, using the previously configured separator and key-value separator.
      Joiner.MapJoiner useForNull​(String nullText)
      Returns a map joiner with the same behavior as this one, except automatically substituting nullText for any provided null keys or values.