com.google.common.base
public static final class Joiner.MapJoiner extends java.lang.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 java.lang.Appendable,I extends java.lang.Object & java.lang.Iterable<? extends java.util.Map.Entry<?,?>> & java.util.Iterator<? extends java.util.Map.Entry<?,?>>> |
appendTo(A appendable,
I entries)
Deprecated.
use
appendTo(Appendable, Iterator) by casting entries to
Iterator<? extends Entry<?, ?>> , or better yet, by implementing only
Iterator and not Iterable . This method is scheduled for deletion
in June 2013. |
<A extends java.lang.Appendable> |
appendTo(A appendable,
java.lang.Iterable<? extends java.util.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 java.lang.Appendable> |
appendTo(A appendable,
java.util.Iterator<? extends java.util.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 java.lang.Appendable> |
appendTo(A appendable,
java.util.Map<?,?> map)
Appends the string representation of each entry of
map , using the previously
configured separator and key-value separator, to appendable . |
<I extends java.lang.Object & java.lang.Iterable<? extends java.util.Map.Entry<?,?>> & java.util.Iterator<? extends java.util.Map.Entry<?,?>>> |
appendTo(java.lang.StringBuilder builder,
I entries)
Deprecated.
use
appendTo(StringBuilder, Iterator) by casting entries to
Iterator<? extends Entry<?, ?>> , or better yet, by implementing only
Iterator and not Iterable . This method is scheduled for deletion
in June 2013. |
java.lang.StringBuilder |
appendTo(java.lang.StringBuilder builder,
java.lang.Iterable<? extends java.util.Map.Entry<?,?>> entries)
Appends the string representation of each entry in
entries , using the previously
configured separator and key-value separator, to builder . |
java.lang.StringBuilder |
appendTo(java.lang.StringBuilder builder,
java.util.Iterator<? extends java.util.Map.Entry<?,?>> entries)
Appends the string representation of each entry in
entries , using the previously
configured separator and key-value separator, to builder . |
java.lang.StringBuilder |
appendTo(java.lang.StringBuilder builder,
java.util.Map<?,?> map)
Appends the string representation of each entry of
map , using the previously
configured separator and key-value separator, to builder . |
<I extends java.lang.Object & java.lang.Iterable<? extends java.util.Map.Entry<?,?>> & java.util.Iterator<? extends java.util.Map.Entry<?,?>>> |
join(I entries)
Deprecated.
use
join(Iterator) by casting entries to
Iterator<? extends Entry<?, ?>> , or better yet, by implementing only
Iterator and not Iterable . This method is scheduled for deletion
in June 2013. |
java.lang.String |
join(java.lang.Iterable<? extends java.util.Map.Entry<?,?>> entries)
Returns a string containing the string representation of each entry in
entries , using
the previously configured separator and key-value separator. |
java.lang.String |
join(java.util.Iterator<? extends java.util.Map.Entry<?,?>> entries)
Returns a string containing the string representation of each entry in
entries , using
the previously configured separator and key-value separator. |
java.lang.String |
join(java.util.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(java.lang.String nullText)
Returns a map joiner with the same behavior as this one, except automatically substituting
nullText for any provided null keys or values. |
public <A extends java.lang.Appendable> A appendTo(A appendable, java.util.Map<?,?> map) throws java.io.IOException
map
, using the previously
configured separator and key-value separator, to appendable
.java.io.IOException
public java.lang.StringBuilder appendTo(java.lang.StringBuilder builder, java.util.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
.public java.lang.String join(java.util.Map<?,?> map)
map
, using the
previously configured separator and key-value separator.@Beta @Deprecated public <A extends java.lang.Appendable,I extends java.lang.Object & java.lang.Iterable<? extends java.util.Map.Entry<?,?>> & java.util.Iterator<? extends java.util.Map.Entry<?,?>>> A appendTo(A appendable, I entries) throws java.io.IOException
appendTo(Appendable, Iterator)
by casting entries
to
Iterator<? extends Entry<?, ?>>
, or better yet, by implementing only
Iterator
and not Iterable
. This method is scheduled for deletion
in June 2013.java.io.IOException
@Beta public <A extends java.lang.Appendable> A appendTo(A appendable, java.lang.Iterable<? extends java.util.Map.Entry<?,?>> entries) throws java.io.IOException
entries
, using the previously
configured separator and key-value separator, to appendable
.java.io.IOException
@Beta public <A extends java.lang.Appendable> A appendTo(A appendable, java.util.Iterator<? extends java.util.Map.Entry<?,?>> parts) throws java.io.IOException
entries
, using the previously
configured separator and key-value separator, to appendable
.java.io.IOException
@Beta @Deprecated public <I extends java.lang.Object & java.lang.Iterable<? extends java.util.Map.Entry<?,?>> & java.util.Iterator<? extends java.util.Map.Entry<?,?>>> java.lang.StringBuilder appendTo(java.lang.StringBuilder builder, I entries) throws java.io.IOException
appendTo(StringBuilder, Iterator)
by casting entries
to
Iterator<? extends Entry<?, ?>>
, or better yet, by implementing only
Iterator
and not Iterable
. This method is scheduled for deletion
in June 2013.java.io.IOException
@Beta public java.lang.StringBuilder appendTo(java.lang.StringBuilder builder, java.lang.Iterable<? extends java.util.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 public java.lang.StringBuilder appendTo(java.lang.StringBuilder builder, java.util.Iterator<? extends java.util.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 @Deprecated public <I extends java.lang.Object & java.lang.Iterable<? extends java.util.Map.Entry<?,?>> & java.util.Iterator<? extends java.util.Map.Entry<?,?>>> java.lang.String join(I entries) throws java.io.IOException
join(Iterator)
by casting entries
to
Iterator<? extends Entry<?, ?>>
, or better yet, by implementing only
Iterator
and not Iterable
. This method is scheduled for deletion
in June 2013.java.io.IOException
@Beta public java.lang.String join(java.lang.Iterable<? extends java.util.Map.Entry<?,?>> entries)
entries
, using
the previously configured separator and key-value separator.@Beta public java.lang.String join(java.util.Iterator<? extends java.util.Map.Entry<?,?>> entries)
entries
, using
the previously configured separator and key-value separator.@CheckReturnValue public Joiner.MapJoiner useForNull(java.lang.String nullText)
nullText
for any provided null keys or values.