com.emc.vipr.client.core.util

Class ResourceUtils

java.lang.Object

com.emc.vipr.client.core.util.ResourceUtils

public class ResourceUtils
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.net.URI	NULL_URI Null URI to use to unassign certain values.

Constructor Summary

Constructors

Constructor and Description
ResourceUtils()

Method Summary

Modifier and Type	Method and Description
static <T extends DataObjectRestRep> void	applyFilter(java.util.Collection<T> resources, ResourceFilter<T> filter) Applies a resource filter to the collection of resources.
static java.lang.String	asString(java.net.URI value) Gets the value of the URI as a string, returns null if the URI is null.
static NamedRelatedResourceRep	createNamedRef(DataObjectRestRep resource) Creates a named reference to the resource.
static <T> java.util.List<T>	defaultList(java.util.List<T> value) Defaults the list to an empty list if null.
static boolean	equals(java.net.URI first, java.net.URI second) Determines if the IDs are equal (and non-null).
static <T extends DataObjectRestRep> T	find(java.util.Collection<T> values, java.net.URI id) Finds a data object within a collection by ID.
static <T extends RelatedResourceRep> T	findRef(java.util.Collection<T> resources, java.net.URI id) Finds a resource reference within a collection by ID.
static java.net.URI	id(DataObjectRestRep value) Gets the ID of a data object, null safe.
static java.net.URI	id(RelatedResourceRep ref) Gets the ID of a reference, null safe.
static boolean	idEquals(DataObjectRestRep first, RelatedResourceRep second) Determines if the IDs of the given values match.
static boolean	idEquals(RelatedResourceRep first, DataObjectRestRep second) Determines if the IDs of the given values match.
static boolean	idEquals(RelatedResourceRep first, RelatedResourceRep second) Determines if the IDs of the given values match.
static java.util.List<java.net.URI>	ids(java.util.Collection<? extends DataObjectRestRep> values) Gets a list of IDs of data objects, null safe.
static boolean	isActive(DataObjectRestRep value) Determines if the item is active.
static boolean	isNotInternal(DataObjectRestRep value) Determines if the item is not internal.
static boolean	isNull(java.net.URI id) Checks if the ID is null (or matches the NULL_URI).
static <T extends DataObjectRestRep> java.util.Map<java.net.URI,T>	mapById(java.util.Collection<T> resources) Maps a collection of resources by their IDs.
static java.util.Map<java.net.URI,java.lang.String>	mapNames(java.util.Collection<? extends NamedRelatedResourceRep> references) Maps a collection of references by their ID to their name.
static java.lang.String	name(DataObjectRestRep value) Gets the name of a data object, null safe
static java.lang.String	name(NamedRelatedResourceRep ref) Gets the name of a named reference, null safe
static java.util.List<java.lang.String>	names(java.util.Collection<? extends DataObjectRestRep> values) Gets the names of the data objects, null safe
static java.util.List<java.net.URI>	refIds(java.util.Collection<? extends RelatedResourceRep> refs) Gets a list of IDs of data objects, null safe.
static java.util.List<java.lang.String>	refNames(java.util.Collection<? extends NamedRelatedResourceRep> refs) Gets the name of the references, null safe
static java.lang.String	stringId(DataObjectRestRep value) Gets the ID of the resource, as a string.
static java.lang.String	stringId(RelatedResourceRep ref) Gets the ID of the reference, as a string.
static java.util.List<java.lang.String>	stringIds(java.util.Collection<? extends DataObjectRestRep> values) Gets the IDs of the resources, as a list of strings.
static java.util.List<java.lang.String>	stringRefIds(java.util.Collection<? extends RelatedResourceRep> refs) Gets the IDs of the references, as a list of strings.
static java.net.URI	uri(java.lang.String value) Converts a string to a URI, null safe.
static java.util.List<java.net.URI>	uris(java.util.Collection<java.lang.String> values) Converts a collection of strings to a list of URIs, null safe.
static java.util.List<java.net.URI>	uris(java.lang.String... values) Converts an array of strings to a list of URIs, null safe.

Methods inherited from class java.lang.Object

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

Field Detail

NULL_URI

public static final java.net.URI NULL_URI

Null URI to use to unassign certain values.

Constructor Detail

ResourceUtils

public ResourceUtils()

Method Detail

id

public static java.net.URI id(DataObjectRestRep value)

Gets the ID of a data object, null safe.

Parameters:

value - the data object.

Returns:

the ID.

id

public static java.net.URI id(RelatedResourceRep ref)

Gets the ID of a reference, null safe.

Parameters:

ref - the resource reference.

Returns:

the ID.

ids

public static java.util.List<java.net.URI> ids(java.util.Collection<? extends DataObjectRestRep> values)

Gets a list of IDs of data objects, null safe.

Parameters:

values - list of data objects.

Returns:

List of IDs.

refIds

public static java.util.List<java.net.URI> refIds(java.util.Collection<? extends RelatedResourceRep> refs)

Gets a list of IDs of data objects, null safe.

Parameters:

refs - list of resource references.

Returns:

List of IDs.

stringId

public static java.lang.String stringId(DataObjectRestRep value)

Gets the ID of the resource, as a string.

Parameters:

value - the resource.

Returns:

the string ID.

stringId

public static java.lang.String stringId(RelatedResourceRep ref)

Gets the ID of the reference, as a string.

Parameters:

ref - the resource reference.

Returns:

the string ID.

stringIds

public static java.util.List<java.lang.String> stringIds(java.util.Collection<? extends DataObjectRestRep> values)

Gets the IDs of the resources, as a list of strings.

Parameters:

values - the resources.

Returns:

the string ID.

stringRefIds

public static java.util.List<java.lang.String> stringRefIds(java.util.Collection<? extends RelatedResourceRep> refs)

Gets the IDs of the references, as a list of strings.

Parameters:

refs - the resource references.

Returns:

the list of string IDs.

name

public static java.lang.String name(DataObjectRestRep value)

Gets the name of a data object, null safe

Parameters:

value - the data object.

Returns:

the name of the data object.

name

public static java.lang.String name(NamedRelatedResourceRep ref)

Gets the name of a named reference, null safe

Parameters:

ref - the named reference.

Returns:

the name of the reference.

names

public static java.util.List<java.lang.String> names(java.util.Collection<? extends DataObjectRestRep> values)

Gets the names of the data objects, null safe

Parameters:

values - the data objects.

Returns:

the names of the data objects.

refNames

public static java.util.List<java.lang.String> refNames(java.util.Collection<? extends NamedRelatedResourceRep> refs)

Gets the name of the references, null safe

Parameters:

refs - the named references.

Returns:

the names of the references.

find

public static <T extends DataObjectRestRep> T find(java.util.Collection<T> values,
                                                   java.net.URI id)

Finds a data object within a collection by ID.

Parameters:

values - the data objects.

id - the ID of the value to find.

Returns:

the value, or null if not found.

findRef

public static <T extends RelatedResourceRep> T findRef(java.util.Collection<T> resources,
                                                       java.net.URI id)

Finds a resource reference within a collection by ID.

Parameters:

resources - the resource references.

id - the ID of the reference to find.

Returns:

the resource reference, or null if not found.

defaultList

public static <T> java.util.List<T> defaultList(java.util.List<T> value)

Defaults the list to an empty list if null.

Parameters:

value - the list value.

Returns:

the original list if non-null, otherwise it creates a new list.

isActive

public static boolean isActive(DataObjectRestRep value)

Determines if the item is active.

Parameters:

value - the item.

Returns:

true if the item is active (inactive is not set, or is set to FALSE)

isNotInternal

public static boolean isNotInternal(DataObjectRestRep value)

Determines if the item is not internal.

Parameters:

value - the item.

Returns:

true if the item is active (inactive is not set, or is set to FALSE)

mapById

public static <T extends DataObjectRestRep> java.util.Map<java.net.URI,T> mapById(java.util.Collection<T> resources)

Maps a collection of resources by their IDs.

Parameters:

resources - the resources to map.

Returns:

the map of ID resource.

mapNames

public static java.util.Map<java.net.URI,java.lang.String> mapNames(java.util.Collection<? extends NamedRelatedResourceRep> references)

Maps a collection of references by their ID to their name.

Parameters:

references - the references to map.

Returns:

the map of ID name.

asString

public static java.lang.String asString(java.net.URI value)

Gets the value of the URI as a string, returns null if the URI is null.

Parameters:

value - the URI.

Returns:

the string value of the URI.

uri

public static java.net.URI uri(java.lang.String value)

Converts a string to a URI, null safe.

Parameters:

value - the string value.

Returns:

the URI or null if the value does not represent a valid URI.

uris

public static java.util.List<java.net.URI> uris(java.util.Collection<java.lang.String> values)

Converts a collection of strings to a list of URIs, null safe.

Parameters:

values - the string values.

Returns:

the URIs.

uris

public static java.util.List<java.net.URI> uris(java.lang.String... values)

Converts an array of strings to a list of URIs, null safe.

Parameters:

values - the string values.

Returns:

the URIs.

idEquals

public static boolean idEquals(RelatedResourceRep first,
                               RelatedResourceRep second)

Determines if the IDs of the given values match.

Parameters:

first - the first reference.

second - the second reference.

Returns:

true if the values point to the same ID.

idEquals

public static boolean idEquals(RelatedResourceRep first,
                               DataObjectRestRep second)

Determines if the IDs of the given values match.

Parameters:

first - the resource reference.

second - the resource object.

Returns:

true if the values point to the same ID.

idEquals

public static boolean idEquals(DataObjectRestRep first,
                               RelatedResourceRep second)

Determines if the IDs of the given values match.

Parameters:

first - the resource object.

second - the resource reference.

Returns:

true if the values point to the same ID.

equals

public static boolean equals(java.net.URI first,
                             java.net.URI second)

Determines if the IDs are equal (and non-null).

Parameters:

first - the first ID.

second - the second ID.

Returns:

true if and only if the IDs are non-null and equal.

isNull

public static boolean isNull(java.net.URI id)

Checks if the ID is null (or matches the NULL_URI).

Parameters:

id - the ID.

Returns:

true if the ID is null.

createNamedRef

public static NamedRelatedResourceRep createNamedRef(DataObjectRestRep resource)

Creates a named reference to the resource. The reference will have no selfLink set.

Parameters:

resource - the resource.

Returns:

the named reference to the resource.

applyFilter

public static <T extends DataObjectRestRep> void applyFilter(java.util.Collection<T> resources,
                                                             ResourceFilter<T> filter)

Applies a resource filter to the collection of resources.

Parameters:

resources - the resources to filter.

filter - the filter to apply.