com.rli.util.identityData

Class IdentityDataUtils

java.lang.Object

com.rli.util.identityData.IdentityDataUtils

public class IdentityDataUtils
extends java.lang.Object

This class provides a set of helper methods that work with IdentityData objects. This includes methods that can check for conditions on IdentityData objects, apply functions on IdentityData objects, and compare IdentityData objects.

Method Summary

Modifier and Type	Method and Description
static boolean	applyFilter(IdentityData identityData, IdentityFilter identityFilter) Indicates whether the specified IdentityData object matches the specified filter.
static boolean	applyFilter(IdentityData identityData, IdentityFilter identityFilter, java.util.Map<java.lang.String,java.lang.String> extraParams) Indicates whether the specified IdentityData object or the extra attributes and values matches the specified filter.
static boolean	applyFilters(IdentityData identityData, java.util.List<IdentityFilter> identityFilters) Indicates whether the specified IdentityData object matches all the specified filters.
static boolean	applyFilters(IdentityData identityData, java.util.List<IdentityFilter> identityFilters, java.util.Map<java.lang.String,java.lang.String> extraParams) Indicates whether the specified IdentityData object or the extra attributes and values match all the specified filters.
static void	applyPatch(IdentityData identityData, IdentityPatch identityPatch) Applies a set of patch operations (modifications to attribute(s) and their value(s)) to the specified identity data object.
static void	applyPatchOperation(IdentityData identityData, IdentityPatchOperation identityPatchOp) Applies a single patch operation to the specified identity data object.
static void	applyValues(IdentityData identityData, IdentityAttributePath attrPath, java.util.List<java.lang.String> values) Sets the specified values on the identity data object for the target of the attribute path.
static IdentityPatch	getDelta(IdentityData first, IdentityData second) Compares two identity data objects and returns the delta between them in the form of an IdentityPatch object.
static IdentityPatch	getDelta(IdentityData first, IdentityData second, IdentityObjectSchema identityObjectSchema) Compares two identity data objects and returns the delta between them in the form of an IdentityPatch object.
static java.util.List<java.lang.String>	getValuesAsString(IdentityData identityData, IdentityAttributePath identityAttributePath) Returns the list of values found inside the identity data object at the specified attribute path.
static boolean	hasSubAttribute(IdentityData identityData, java.lang.String attributeName, java.lang.String subAttrName) Indicates whether the identity data object contains the specified attribute and its associated sub-attribute.
static boolean	isAttributeValuesComplex(IdentityData identityData, IdentityAttributePath identityAttributePath) Indicates whether the values found inside the identity data object at the specified attribute path are complex values.
static boolean	isListEqualIgnoreCaseAndOrder(java.util.List<java.lang.String> values1, java.util.List<java.lang.String> values2) Indicates whether the two lists are equal (same number of elements), ignoring element order, and ignoring case.

Methods inherited from class java.lang.Object

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

Method Detail

applyFilter

public static boolean applyFilter(IdentityData identityData,
                                  IdentityFilter identityFilter)

Indicates whether the specified IdentityData object matches the specified filter.

Parameters:

identityData - An IdentityData object.

identityFilter - An IdentityFilter object (a conditional filter or predicate).

Returns:

true if the specified IdentityData object matches the specified filter. Returns false otherwise.

applyFilters

public static boolean applyFilters(IdentityData identityData,
                                   java.util.List<IdentityFilter> identityFilters)

Indicates whether the specified IdentityData object matches all the specified filters.

Parameters:

identityData - An IdentityData object.

identityFilters - A list of IdentityFilter objects (a conditional filter or predicate).

Returns:

true if the specified IdentityData object matches all the specified filters. Returns false otherwise.

applyFilter

public static boolean applyFilter(IdentityData identityData,
                                  IdentityFilter identityFilter,
                                  java.util.Map<java.lang.String,java.lang.String> extraParams)

Indicates whether the specified IdentityData object or the extra attributes and values matches the specified filter.

Parameters:

identityData - An IdentityData object.

identityFilter - An IdentityFilter object (a conditional filter or predicate).

extraParams - A map of extra attributes and their associated value (key: attribute name, value: attribute value).

Returns:

true if the specified IdentityData object or the extra attributes and values matches the specified filter. Returns false otherwise.

applyFilters

public static boolean applyFilters(IdentityData identityData,
                                   java.util.List<IdentityFilter> identityFilters,
                                   java.util.Map<java.lang.String,java.lang.String> extraParams)

Indicates whether the specified IdentityData object or the extra attributes and values match all the specified filters.

Parameters:

identityData - An IdentityData object.

identityFilters - A list of IdentityFilter objects (a conditional filter or predicate).

extraParams - A map of extra attributes and their associated value (key: attribute name, value: attribute value).

Returns:

true if the specified IdentityData object or the extra attributes and values match all the specified filters. Returns false otherwise.

isAttributeValuesComplex

public static boolean isAttributeValuesComplex(IdentityData identityData,
                                               IdentityAttributePath identityAttributePath)

Indicates whether the values found inside the identity data object at the specified attribute path are complex values.

Parameters:

identityData - The identity data object.

identityAttributePath - An attribute path.

Returns:

true if the values found inside the identity data object at the specified attribute path are complex values, or false otherwise.

getValuesAsString

public static java.util.List<java.lang.String> getValuesAsString(IdentityData identityData,
                                                                 IdentityAttributePath identityAttributePath)

Returns the list of values found inside the identity data object at the specified attribute path. Returns an empty list if no values are found at the specified attribute path, or if the specified attribute path can't be found in the identity data object.

Parameters:

identityData - An identity data object.

identityAttributePath - An attribute path.

Returns:

the list of values found inside the identity data object at the specified attribute path, or an empty list if no values are found.

applyPatch

public static void applyPatch(IdentityData identityData,
                              IdentityPatch identityPatch)

Applies a set of patch operations (modifications to attribute(s) and their value(s)) to the specified identity data object. This method directly alters the state of the specified identity data object.

Parameters:

identityData - An identity data object.

identityPatch - A set of patch operations to apply on the identity data object.

applyPatchOperation

public static void applyPatchOperation(IdentityData identityData,
                                       IdentityPatchOperation identityPatchOp)

Applies a single patch operation to the specified identity data object. This method directly alters the state of the specified identity data object. Note: if the specified patch operation type is DELETE, the entire attribute will be removed from the identity data object.

Parameters:

identityData - An identity data object.

identityPatchOp - A single patch operation to apply on the identity data object.

applyValues

public static void applyValues(IdentityData identityData,
                               IdentityAttributePath attrPath,
                               java.util.List<java.lang.String> values)

Sets the specified values on the identity data object for the target of the attribute path. If the specified values are null, the target of the attribute path will be removed.

Parameters:

identityData - An identity data object.

attrPath - An attribute path.

values - The set of values to set for the target of the attribute path.

hasSubAttribute

public static boolean hasSubAttribute(IdentityData identityData,
                                      java.lang.String attributeName,
                                      java.lang.String subAttrName)

Indicates whether the identity data object contains the specified attribute and its associated sub-attribute. This method will only return true if the attribute contains complex value(s).

Parameters:

identityData - An identity data object.

attributeName - The name of the attribute.

subAttrName - The name of the sub-attribute.

Returns:

true if the identity data object contains the specified attribute and its associated sub-attribute. Returns false otherwise.

getDelta

public static IdentityPatch getDelta(IdentityData first,
                                     IdentityData second)

Compares two identity data objects and returns the delta between them in the form of an IdentityPatch object. The returned object is the minimum set of changes to apply to the second object to transform it into the first object.

Parameters:

first - An identity data object.

second - An identity data object.

Returns:

The delta between the first object and the second object (the minimum set of changes to apply to the second object to transform it into the first object).

getDelta

public static IdentityPatch getDelta(IdentityData first,
                                     IdentityData second,
                                     IdentityObjectSchema identityObjectSchema)

Compares two identity data objects and returns the delta between them in the form of an IdentityPatch object. The returned object is the minimum set of changes to apply to the second object to transform it into the first object.

Parameters:

first - An identity data object.

second - An identity data object.

identityObjectSchema - The schema for the attributes contained in the identity data objects.

Returns:

The delta between the first object and the second object (the minimum set of changes to apply to the second object to transform it into the first object).

isListEqualIgnoreCaseAndOrder

public static boolean isListEqualIgnoreCaseAndOrder(java.util.List<java.lang.String> values1,
                                                    java.util.List<java.lang.String> values2)

Indicates whether the two lists are equal (same number of elements), ignoring element order, and ignoring case.

Parameters:

values1 - A list of values.

values2 - A list of values.

Returns:

true if the two lists are equal, or false otherwise.