public static final class Joiner.MapJoiner extends Object
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:
multimap.entries()
to a
MapJoiner
method that accepts entries as input, and receive output of the form
key1=A&key1=B&key2=C
.
multimap.asMap()
to a MapJoiner
method that accepts a map as input, and receive output of the form key1=[A, B]&key2=C
.
Modifier and Type | Method and Description |
---|---|
<A extends Appendable> |
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> |
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> |
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. |
@CanIgnoreReturnValue public <A extends Appendable> A appendTo(A appendable, Map<?,?> map) throws IOException
map
, using the previously
configured separator and key-value separator, to appendable
.IOException
@CanIgnoreReturnValue public StringBuilder appendTo(StringBuilder builder, Map<?,?> map)
map
, using the previously
configured separator and key-value separator, to builder
. Identical to appendTo(Appendable, Map)
, except that it does not throw IOException
.@Beta @CanIgnoreReturnValue public <A extends Appendable> A appendTo(A appendable, Iterable<? extends Map.Entry<?,?>> entries) throws IOException
entries
, using the previously
configured separator and key-value separator, to appendable
.IOException
@Beta @CanIgnoreReturnValue public <A extends Appendable> A appendTo(A appendable, Iterator<? extends Map.Entry<?,?>> parts) throws IOException
entries
, using the previously
configured separator and key-value separator, to appendable
.IOException
@Beta @CanIgnoreReturnValue public StringBuilder appendTo(StringBuilder builder, Iterable<? extends Map.Entry<?,?>> entries)
entries
, using the previously
configured separator and key-value separator, to builder
. Identical to appendTo(Appendable, Iterable)
, except that it does not throw IOException
.@Beta @CanIgnoreReturnValue public StringBuilder appendTo(StringBuilder builder, Iterator<? extends Map.Entry<?,?>> entries)
entries
, using the previously
configured separator and key-value separator, to builder
. Identical to appendTo(Appendable, Iterable)
, except that it does not throw IOException
.public String join(Map<?,?> map)
map
, using the
previously configured separator and key-value separator.@Beta public String join(Iterable<? extends Map.Entry<?,?>> entries)
entries
, using
the previously configured separator and key-value separator.@Beta public String join(Iterator<? extends Map.Entry<?,?>> entries)
entries
, using
the previously configured separator and key-value separator.public Joiner.MapJoiner useForNull(String nullText)
nullText
for any provided null keys or values.Copyright © 2010–2019. All rights reserved.