com.netflix.spectator.api

Class Utils

java.lang.Object

com.netflix.spectator.api.Utils

public final class Utils
extends Object

Helper functions for working with a sequence of measurements.

Method Summary

Modifier and Type	Method and Description
static Iterable<Measurement>	filter(Iterable<Measurement> ms, Predicate<Measurement> p) Returns a new iterable restricted to measurements that match the predicate.
static Iterable<Measurement>	filter(Iterable<Measurement> ms, String k, String v) Returns a new iterable restricted to measurements that match the predicate.
static Iterable<Measurement>	filter(Iterable<Measurement> ms, Tag t) Returns a new iterable restricted to measurements that match the predicate.
static Measurement	first(Iterable<Measurement> ms, Predicate<Measurement> p) Returns the first measurement that matches the predicate.
static Measurement	first(Iterable<Measurement> ms, String k, String v) Returns the first measurement with a given tag value.
static Measurement	first(Iterable<Measurement> ms, Tag t) Returns the first measurement with a given tag value.
static String	getTagValue(Id id, String k) Returns the value associated with with a given key or null if no such key is present in the set of tags.
static String	getTagValue(Iterable<Tag> tags, String k) Returns the value associated with with a given key or null if no such key is present in the set of tags.
static Id	normalize(Id id) Returns a new id with the tag list sorted by key and with no duplicate keys.
static <T> List<T>	toList(Iterable<T> iter) Returns a list with a copy of the data from the iterable.
static <T> List<T>	toList(Iterator<T> iter) Returns a list with the data from the iterator.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

normalize

public static Id normalize(Id id)

Returns a new id with the tag list sorted by key and with no duplicate keys.

getTagValue

public static String getTagValue(Id id,
                                 String k)

Returns the value associated with with a given key or null if no such key is present in the set of tags.

Parameters:

id - Identifier with a set of tags to search.

k - Key to search for.

Returns:

Value for the key or null if the key is not present.

getTagValue

public static String getTagValue(Iterable<Tag> tags,
                                 String k)

Returns the value associated with with a given key or null if no such key is present in the set of tags.

Parameters:

tags - Set of tags to search.

k - Key to search for.

Returns:

Value for the key or null if the key is not present.

first

public static Measurement first(Iterable<Measurement> ms,
                                Tag t)

Returns the first measurement with a given tag value.

Parameters:

ms - A set of measurements.

t - The key and value to search for.

Returns:

Measurement or null if no matches are found.

first

public static Measurement first(Iterable<Measurement> ms,
                                String k,
                                String v)

Returns the first measurement with a given tag value.

Parameters:

ms - A set of measurements.

k - Key to search for.

v - Value that should be associated with k on the ids.

Returns:

Measurement or null if no matches are found.

first

public static Measurement first(Iterable<Measurement> ms,
                                Predicate<Measurement> p)

Returns the first measurement that matches the predicate.

Parameters:

ms - A set of measurements.

p - Predicate to use for selecting values.

Returns:

Measurement or null if no matches are found.

filter

public static Iterable<Measurement> filter(Iterable<Measurement> ms,
                                           Tag t)

Returns a new iterable restricted to measurements that match the predicate.

Parameters:

ms - A set of measurements.

t - The key and value to search for.

Returns:

Measurements matching the predicate.

filter

public static Iterable<Measurement> filter(Iterable<Measurement> ms,
                                           String k,
                                           String v)

Returns a new iterable restricted to measurements that match the predicate.

Parameters:

ms - A set of measurements.

k - Key to search for.

v - Value that should be associated with k on the ids.

Returns:

Measurements matching the predicate.

filter

public static Iterable<Measurement> filter(Iterable<Measurement> ms,
                                           Predicate<Measurement> p)

Returns a new iterable restricted to measurements that match the predicate.

Parameters:

ms - A set of measurements.

p - Predicate to use for selecting values.

Returns:

Measurements matching the predicate.

toList

public static <T> List<T> toList(Iterable<T> iter)

Returns a list with a copy of the data from the iterable.

toList

public static <T> List<T> toList(Iterator<T> iter)

Returns a list with the data from the iterator.