org.cyclos.utils

Class CustomFieldHelper

java.lang.Object

org.cyclos.utils.CustomFieldHelper

public class CustomFieldHelper
extends java.lang.Object

Helper class for handling custom fields and their values

Author:

luis

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	VALUE_SEPARATOR Separator used when multiple values are parsed from a String

Constructor Summary

Constructors

Constructor and Description
CustomFieldHelper()

Method Summary

Modifier and Type	Method and Description
static void	fillNewFieldValue(CustomFieldDetailedVO field, CustomFieldValueDTO customValue) Fills-in a new custom field value instance for a new value on the given field.
static UserProfileFieldActions	findActions(ProfileField profileField, java.lang.Iterable<UserProfileFieldActions> actions) Returns the actions collection for the given profile field
static <PV extends ICustomFieldPossibleValue<?>> PV	findPossibleValue(java.lang.String value, java.util.List<PV> possibleValues) Finds the possible value with a given value, or returns null if not found
static <V extends ICustomFieldValue<?,?>> V	findValue(ICustomField field, java.util.Collection<? extends V> values) Finds a custom field value inside a collection
static CustomFieldValueDTO	findValueOrNew(CustomFieldDetailedVO field, java.util.Collection<CustomFieldValueDTO> customValues) Finds a custom field value inside a collection.
static java.util.List<CustomFieldDetailedVO>	getCustomFields(java.lang.Iterable<UserProfileFieldActions> actions) Returns the custom fields in the given collection of actions
static java.lang.Object	getCustomFieldValue(CustomFieldType type, ICustomFieldValue value) Returns the property used to retrieve the value of a field given it's type
static java.lang.Object	getCustomFieldValue(ICustomFieldValue<?,?> value) Returns the property used to retrieve the value of a field given it's type
static java.lang.Object	getDefaultValue(CustomFieldDetailedVO field) Returns the default value for the given field
static java.util.Collection<CustomFieldPossibleValueVO>	getEnumeratedValues(ICustomFieldValue<?,?> fieldValue)
static ProfileField	getProfileField(UserProfileFieldActions actions) Returns the profile field for the given actions collection
static java.lang.String	getReferenceValue(ICustomFieldValue<?,?> fieldValue)
static java.lang.Object	getValue(java.lang.Long customFieldId, java.util.Collection<? extends ICustomFieldValue<?,?>> customValues) Returns the value of a custom field from a collection, finding the value by internal name.
static java.lang.Object	getValue(java.lang.String internalName, java.util.Collection<? extends ICustomFieldValue<?,?>> customValues) Returns the value of a custom field from a collection, finding the value by internal name.
static java.lang.Object	getValue(UserWithFieldsVO user, ProfileField profileField) Returns a profile field value for a given UserWithFieldsVO
static boolean	hasAnyFieldWithInformation(java.util.Collection<UserProfileFieldActions> profileFieldActions) Returns whether at least one of the given fields have information text
static CustomFieldValueDTO	newFieldValue(CustomFieldDetailedVO field) Creates a new custom field value for the given field
static void	qualifyInternalName(java.lang.String customFieldInternalName, CustomFieldPossibleValueVO possibleValue) Qualifies the internal name of the given possible value with the custom field internal name.
static void	setCustomFieldValue(ICustomFieldValue<?,?> fieldValue, java.lang.Object value) Returns the property used to retrieve the value of a field given it's type
static boolean	setValue(java.lang.String internalName, java.util.Collection<? extends ICustomFieldValue<?,?>> customValues, java.lang.Object value) Sets the value of a custom field given the values collection, finding by field internal name
static java.util.Map<java.lang.String,ICustomField>	toFieldsMap(java.util.Collection<? extends ICustomField> fields) Returns a Map, keyed by the custom field's unqualified internal name , whose value is the custom field of the received collection.
static java.util.Map<ICustomField,ICustomFieldValue>	toMap(java.util.Collection<? extends ICustomFieldValue> customValues) Returns a Map, keyed by the custom field , whose values are the custom field values of the received collection.
static java.lang.String	toReference(ICustomFieldValue<CustomFieldValueFileVO,CustomFieldValueImageVO> fieldValue) Converts a ICustomFieldValue to a reference, that is, a string representation

Methods inherited from class java.lang.Object

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

Field Detail

VALUE_SEPARATOR

public static java.lang.String VALUE_SEPARATOR

Separator used when multiple values are parsed from a String

Constructor Detail

CustomFieldHelper

public CustomFieldHelper()

Method Detail

fillNewFieldValue

public static void fillNewFieldValue(CustomFieldDetailedVO field,
                                     CustomFieldValueDTO customValue)

Fills-in a new custom field value instance for a new value on the given field. Should be used when there are custom subclasses of CustomFieldValueDTO and newFieldValue(CustomFieldDetailedVO) is not enough. Sets the field reference and the default value.

findActions

public static UserProfileFieldActions findActions(ProfileField profileField,
                                                  java.lang.Iterable<UserProfileFieldActions> actions)

Returns the actions collection for the given profile field

findPossibleValue

public static <PV extends ICustomFieldPossibleValue<?>> PV findPossibleValue(java.lang.String value,
                                                                             java.util.List<PV> possibleValues)

Finds the possible value with a given value, or returns null if not found

findValue

public static <V extends ICustomFieldValue<?,?>> V findValue(ICustomField field,
                                                             java.util.Collection<? extends V> values)

Finds a custom field value inside a collection

findValueOrNew

public static CustomFieldValueDTO findValueOrNew(CustomFieldDetailedVO field,
                                                 java.util.Collection<CustomFieldValueDTO> customValues)

Finds a custom field value inside a collection. If none found, creates a new one and adds to the collection before returning

getCustomFields

public static java.util.List<CustomFieldDetailedVO> getCustomFields(java.lang.Iterable<UserProfileFieldActions> actions)

Returns the custom fields in the given collection of actions

getCustomFieldValue

public static java.lang.Object getCustomFieldValue(CustomFieldType type,
                                                   ICustomFieldValue value)

Returns the property used to retrieve the value of a field given it's type

getCustomFieldValue

public static java.lang.Object getCustomFieldValue(ICustomFieldValue<?,?> value)

Returns the property used to retrieve the value of a field given it's type

getDefaultValue

public static java.lang.Object getDefaultValue(CustomFieldDetailedVO field)

Returns the default value for the given field

getEnumeratedValues

public static java.util.Collection<CustomFieldPossibleValueVO> getEnumeratedValues(ICustomFieldValue<?,?> fieldValue)

getProfileField

public static ProfileField getProfileField(UserProfileFieldActions actions)

Returns the profile field for the given actions collection

getReferenceValue

public static java.lang.String getReferenceValue(ICustomFieldValue<?,?> fieldValue)

getValue

public static java.lang.Object getValue(java.lang.Long customFieldId,
                                        java.util.Collection<? extends ICustomFieldValue<?,?>> customValues)

Returns the value of a custom field from a collection, finding the value by internal name.

getValue

public static java.lang.Object getValue(java.lang.String internalName,
                                        java.util.Collection<? extends ICustomFieldValue<?,?>> customValues)

Returns the value of a custom field from a collection, finding the value by internal name.

getValue

public static java.lang.Object getValue(UserWithFieldsVO user,
                                        ProfileField profileField)

Returns a profile field value for a given UserWithFieldsVO

hasAnyFieldWithInformation

public static boolean hasAnyFieldWithInformation(java.util.Collection<UserProfileFieldActions> profileFieldActions)

Returns whether at least one of the given fields have information text

newFieldValue

public static CustomFieldValueDTO newFieldValue(CustomFieldDetailedVO field)

Creates a new custom field value for the given field

qualifyInternalName

public static void qualifyInternalName(java.lang.String customFieldInternalName,
                                       CustomFieldPossibleValueVO possibleValue)

Qualifies the internal name of the given possible value with the custom field internal name. For example if the custom field internal name is "a" and the internal name of tej possible value is "b" then it returns "a.b"

setCustomFieldValue

public static void setCustomFieldValue(ICustomFieldValue<?,?> fieldValue,
                                       java.lang.Object value)

Returns the property used to retrieve the value of a field given it's type

setValue

public static boolean setValue(java.lang.String internalName,
                               java.util.Collection<? extends ICustomFieldValue<?,?>> customValues,
                               java.lang.Object value)

Sets the value of a custom field given the values collection, finding by field internal name

toFieldsMap

public static java.util.Map<java.lang.String,ICustomField> toFieldsMap(java.util.Collection<? extends ICustomField> fields)

Returns a Map, keyed by the custom field's unqualified internal name , whose value is the custom field of the received collection.

toMap

public static java.util.Map<ICustomField,ICustomFieldValue> toMap(java.util.Collection<? extends ICustomFieldValue> customValues)

Returns a Map, keyed by the custom field , whose values are the custom field values of the received collection.

toReference

public static java.lang.String toReference(ICustomFieldValue<CustomFieldValueFileVO,CustomFieldValueImageVO> fieldValue)

Converts a ICustomFieldValue to a reference, that is, a string representation