Package io.micrometer.core.instrument
Class Tags
java.lang.Object
io.micrometer.core.instrument.Tags
- All Implemented Interfaces:
java.lang.Iterable<Tag>
public final class Tags extends java.lang.Object implements java.lang.Iterable<Tag>
An immutable collection of
Tags
that are guaranteed to be sorted and deduplicated by tag key.-
Method Summary
Modifier and Type Method Description Tags
and(Tag... tags)
Return a newTags
instance by merging this collection and the specified tags.Tags
and(java.lang.Iterable<? extends Tag> tags)
Return a newTags
instance by merging this collection and the specified tags.Tags
and(java.lang.String... keyValues)
Return a newTags
instance by merging this collection and the specified key/value pairs.Tags
and(java.lang.String key, java.lang.String value)
Return a newTags
instance by merging this collection and the specified key/value pair.static Tags
concat(java.lang.Iterable<? extends Tag> tags, java.lang.Iterable<Tag> otherTags)
Return a newTags
instance by concatenating the specified collections of tags.static Tags
concat(java.lang.Iterable<? extends Tag> tags, java.lang.String... keyValues)
Return a newTags
instance by concatenating the specified tags and key/value pairs.static Tags
empty()
Return aTags
instance that contains no elements.boolean
equals(java.lang.Object obj)
int
hashCode()
java.util.Iterator<Tag>
iterator()
static Tags
of(Tag... tags)
Return a newTags
instance containing tags constructed from the specified tags.static Tags
of(java.lang.Iterable<? extends Tag> tags)
Return a newTags
instance containing tags constructed from the specified source tags.static Tags
of(java.lang.String... keyValues)
Return a newTags
instance containing tags constructed from the specified key/value pairs.static Tags
of(java.lang.String key, java.lang.String value)
Return a newTags
instance containing tags constructed from the specified key/value pair.java.util.stream.Stream<Tag>
stream()
Return a stream of the contained tags.java.lang.String
toString()
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface java.lang.Iterable
forEach, spliterator
-
Method Details
-
and
Return a newTags
instance by merging this collection and the specified key/value pair.- Parameters:
key
- the tag key to addvalue
- the tag value to add- Returns:
- a new
Tags
instance
-
and
Return a newTags
instance by merging this collection and the specified key/value pairs.- Parameters:
keyValues
- the key/value pairs to add- Returns:
- a new
Tags
instance
-
and
Return a newTags
instance by merging this collection and the specified tags.- Parameters:
tags
- the tags to add- Returns:
- a new
Tags
instance
-
and
Return a newTags
instance by merging this collection and the specified tags.- Parameters:
tags
- the tags to add- Returns:
- a new
Tags
instance
-
iterator
- Specified by:
iterator
in interfacejava.lang.Iterable<Tag>
-
stream
Return a stream of the contained tags.- Returns:
- a tags stream
-
hashCode
public int hashCode()- Overrides:
hashCode
in classjava.lang.Object
-
equals
- Overrides:
equals
in classjava.lang.Object
-
concat
public static Tags concat(@Nullable java.lang.Iterable<? extends Tag> tags, @Nullable java.lang.Iterable<Tag> otherTags)Return a newTags
instance by concatenating the specified collections of tags.- Parameters:
tags
- the first set of tagsotherTags
- the second set of tags- Returns:
- the merged tags
-
concat
public static Tags concat(@Nullable java.lang.Iterable<? extends Tag> tags, @Nullable java.lang.String... keyValues)Return a newTags
instance by concatenating the specified tags and key/value pairs.- Parameters:
tags
- the first set of tagskeyValues
- the additional key/value pairs to add- Returns:
- the merged tags
-
of
Return a newTags
instance containing tags constructed from the specified source tags.- Parameters:
tags
- the tags to add- Returns:
- a new
Tags
instance
-
of
Return a newTags
instance containing tags constructed from the specified key/value pair.- Parameters:
key
- the tag key to addvalue
- the tag value to add- Returns:
- a new
Tags
instance
-
of
Return a newTags
instance containing tags constructed from the specified key/value pairs.- Parameters:
keyValues
- the key/value pairs to add- Returns:
- a new
Tags
instance
-
of
Return a newTags
instance containing tags constructed from the specified tags.- Parameters:
tags
- the tags to add- Returns:
- a new
Tags
instance
-
empty
Return aTags
instance that contains no elements.- Returns:
- an empty
Tags
instance
-
toString
public java.lang.String toString()- Overrides:
toString
in classjava.lang.Object
-