Package org.ametys.plugins.repository.data.holder.impl

Class DataHolderHelper

java.lang.Object

org.ametys.plugins.repository.data.holder.impl.DataHolderHelper

All Implemented Interfaces:

Disposable, Component, Serviceable

public final class DataHolderHelper
extends Object
implements Component, Serviceable, Disposable

Helper for implementations of data holder

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	DataHolderHelper.SynchronizableValuesStatusInfos	Stores informations needed to choose status of created SynchronizableValue

Field Summary

Fields

Modifier and Type	Field	Description
static final Pattern	REPEATER_ENTRY_PATTERN	Pattern for repeater entry : entryName[i]

Constructor Summary

Constructors

Constructor	Description
DataHolderHelper()

Method Summary

Modifier and Type	Method	Description
static <T> T	aggregateMultipleValues(List<? extends ModelAwareDataHolder> dataHolders, String dataPath, Class managedClass)	Aggregates multiple values of the data holders at the given path
static Object	appendValuesInArray(Object originalValues, Object valuesToAppend, ElementType elementType)	Append some values to the given original ones
static void	commentsToSAX(ModelAwareDataHolder dataHolder, ContentHandler contentHandler, ViewItemAccessor viewItemAccessor, String dataPath)	Generates SAX events for the data comments in the given view
static Object	convertValue(ElementDefinition definition, Object value)	Converts the given value according to the given definition If the value is multiple, an array is retrieved with each value converted to the right type
static Object	convertValueIgnoringIncompatibleOnes(ElementDefinition definition, Object value)	Converts the given value according to the given definition If the value is multiple, an array is retrieved with each value converted to the right type If the value is not compatible whit the data type, no exception is thrown and the value is converted to an UntouchedValue in order to be ignored
static Map<String,Object>	convertValues(ViewItemAccessor viewItemAccessor, Map<String,Object> values)	Converts the given values according to the definitions in the given ViewItemAccessor
static Map<String,Object>	convertValues(ViewItemAccessor viewItemAccessor, Map<String,Object> values, BiFunction<ElementDefinition,Object,Object> convertValueFunction)	Converts the given values according to the definitions in the given ViewItemAccessor
static Map<String,Object>	convertValuesWithSynchronizableValues(ViewItemAccessor viewItemAccessor, Map<String,Object> values, BiFunction<ElementDefinition,Object,Object> convertValueFunction, Optional<DataHolderHelper.SynchronizableValuesStatusInfos> synchronizableValuesStatusInfos)	Converts the given values according to the definitions in the given ViewItemAccessor
static void	copyTo(DataHolder source, ModifiableDataHolder destination, String name, DataContext context)	Copy the data name of the source DataHolder to the given ModifiableDataHolder destination.
static void	copyTo(DataHolder source, ModifiableDataHolder destination, DataContext context)	Copies the source DataHolder to the given ModifiableDataHolder destination.
static ValueContext	createValueContextFromSynchronizationContext(ModelAwareDataHolder dataHolder, String dataPath, SynchronizationContext synchronizationContext)	Creates a value context from the given SynchronizationContext
static ViewItemAccessor	createViewItemAccessorFromValues(Collection<? extends ModelItemAccessor> modelItemAccessors, Map<String,Object> values)	Create a ViewItemAccessor for the items corresponding to the given values
static Object	dataToJSON(ModelLessDataHolder dataHolder, String relativeDataPath, DataContext context)	Convert the data at the given relative path into a JSON object
static Map<String,Object>	dataToJSON(ModelLessDataHolder dataHolder, DataContext context)	Convert the data contained in the given DataHolder
static void	dataToSAX(ModelLessDataHolder dataHolder, ContentHandler contentHandler, String relativeDataPath, DataContext context)	Generates SAX events for data at the given relative path in this DataHolder
static void	dataToSAX(ModelLessDataHolder dataHolder, ContentHandler contentHandler, DataContext context)	Generates SAX events for data contained in this DataHolder
void	dispose()
static <T> Map<String,T>	findEditableItemsByType(ModelAwareDataHolder dataHolder, String type)	Find all modifiable data of the given type on a ModelAwareDataHolder, including in composite or repeater entries.
static <T> Map<String,T>	findItemsByType(ModelAwareDataHolder dataHolder, String type)	Find all data of the given type on a ModelAwareDataHolder, including in composite or repeater entries.
static <T> Map<String,T>	findItemsByType(ModelAwareDataHolder dataHolder, ViewItemAccessor viewItemAccessor, String type)	Find all data of the given type on a ModelAwareDataHolder, including in composite or repeater entries.
static Object	getArrayValuesFromSynchronizableValue(SynchronizableValue synchronizableValue, ValueContext valueContext)	Retrieves an array of values from the given SynchronizableValue.
static ExternalizableDataProviderExtensionPoint	getExternalizableDataProviderExtensionPoint()	Retrieve the ExternalizableDataProviderExtensionPoint
static RepeaterEntry	getRepeaterEntry(ModelAwareDataHolder dataHolder, String repeaterName, int entryPosition)	Retrieves the repeater entry at the given position
static Pair<String,Integer>	getRepeaterNameAndEntryPosition(String pathSegment)	Retrieves the pair of repeater name and entry position of the given path segment Return null if the given path does not represent a repeater entry
static <T> T	getValue(String ametysObjectId, String dataPath)	Retrieves the value at the given path for the data aware ametys object with given id
static <T> T	getValue(AmetysObject ametysObject, String dataPath)	Retrieves the value at the given path for the data aware ametys object with given id
static <T> T	getValue(ModelAwareDataHolder dataHolder, String dataPath, ValueContext context)	Retrieves the value of the data at the given path
static Object	getValueFromSynchronizableValue(Object value, ModelAwareDataHolder dataHolder, ModelItem modelItem, Optional<String> dataPath, SynchronizationContext context)	Returns the value of the synchronized value corresponding of the future status If the value is not a SynchronizableValue, the value itself is returned The future status is determined from the synchronizable value itself or from the context if needed.
static boolean	hasNonEmptyRepeaterEntry(ModelAwareDataHolder dataHolder, String repeaterName, int entryPosition)	Checks if there is a non empty repeater entry at the given position
static boolean	hasRepeaterEntry(ModelAwareDataHolder dataHolder, String repeaterName, int entryPosition)	Checks if there is a repeater entry at the given position
static boolean	hasValue(ModelAwareDataHolder dataHolder, String dataPath, ValueContext context)	Checks if there is a non empty value, for the data at the given path
static boolean	hasValueOrEmpty(ModelAwareDataHolder dataHolder, String dataPath, ValueContext context)	Checks if there is value, even empty, for the data at the given path
static boolean	isMultiple(ModelItemAccessor parent, String attributePath)	Check if at least one element in the attribute path is multiple from the given parent accessor.
static boolean	isRepeaterEntryPath(String path)	Test if the path is a repeater entry path (for example entries[1])
static void	removeValue(ModifiableModelAwareDataHolder dataHolder, String dataPath, ValueContext context)	Removes the stored value of the data at the given path
static Object	removeValuesInArray(Object originalValues, Object valuesToRemove, ElementType elementType)	Removes some values from the given original ones
void	service(ServiceManager manager)
static void	setValue(ModifiableModelAwareDataHolder dataHolder, String dataPath, Object value, ValueContext context)	Sets the value of the data at the given path
static void	setValue(ModifiableModelAwareDataHolder dataHolder, String dataPath, Object value, ValueContext context, boolean forceStatus)	Sets the value of the data at the given path

Methods inherited from class java.lang.Object

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

Field Details

REPEATER_ENTRY_PATTERN

public static final Pattern REPEATER_ENTRY_PATTERN

Pattern for repeater entry : entryName[i]

Constructor Details

DataHolderHelper

public DataHolderHelper()

Method Details

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

dispose

public void dispose()

Specified by:

dispose in interface Disposable

hasRepeaterEntry

public static boolean hasRepeaterEntry(ModelAwareDataHolder dataHolder,
 String repeaterName,
 int entryPosition)
                                throws BadItemTypeException

Checks if there is a repeater entry at the given position

Parameters:

dataHolder - data holder that contains the repeater entry. The data holder must be the direct parent of the repeater

repeaterName - the name of the repeater

entryPosition - the position of the entry

Returns:

true if there is an entry at the given position, false otherwise

Throws:

BadItemTypeException - if the value stored in the repository for the given repeater name is not a repeater

hasNonEmptyRepeaterEntry

public static boolean hasNonEmptyRepeaterEntry(ModelAwareDataHolder dataHolder,
 String repeaterName,
 int entryPosition)
                                        throws BadItemTypeException

Checks if there is a non empty repeater entry at the given position

Parameters:

dataHolder - data holder that contains the repeater entry. The data holder must be the direct parent of the repeater

repeaterName - the name of the repeater

entryPosition - the position of the entry

Returns:

true if there is a non empty entry at the given position, false otherwise

Throws:

BadItemTypeException - if the value stored in the repository for the given repeater name is not a repeater

getRepeaterEntry

public static RepeaterEntry getRepeaterEntry(ModelAwareDataHolder dataHolder,
 String repeaterName,
 int entryPosition)
                                      throws BadItemTypeException

Retrieves the repeater entry at the given position

Parameters:

dataHolder - data holder that contains the repeater entry. The data holder must be the direct parent of the repeater

repeaterName - the name of the repeater

entryPosition - the position of the entry

Returns:

the repeater entry

Throws:

BadItemTypeException - if the value stored in the repository for the given repeater name is not a repeater

isRepeaterEntryPath

public static boolean isRepeaterEntryPath(String path)

Test if the path is a repeater entry path (for example entries[1])

Parameters:

path - the path representing the repeater entry

Returns:

true if the pathSegment is a repeater entry path

getRepeaterNameAndEntryPosition

public static Pair<String,Integer> getRepeaterNameAndEntryPosition(String pathSegment)

Retrieves the pair of repeater name and entry position of the given path segment Return null if the given path does not represent a repeater entry

Parameters:

pathSegment - the path segment representing the repeater entry

Returns:

the pair of repeater name and entry position

hasValue

public static boolean hasValue(ModelAwareDataHolder dataHolder,
 String dataPath,
 ValueContext context)
                        throws IllegalArgumentException,
BadDataPathCardinalityException

Checks if there is a non empty value, for the data at the given path

Parameters:

dataHolder - the data holder

dataPath - path of the data

context - the context of the value to check

Returns:

true if the data at the given path is defined by the model, if there is a non empty value for the data, and if the type of this value matches the type of the definition. false otherwise

Throws:

IllegalArgumentException - if the given data path is null or empty

BadDataPathCardinalityException - if the definition of a part of the data path is multiple. Only the last part can be multiple

hasValueOrEmpty

public static boolean hasValueOrEmpty(ModelAwareDataHolder dataHolder,
 String dataPath,
 ValueContext context)
                               throws IllegalArgumentException,
BadDataPathCardinalityException

Checks if there is value, even empty, for the data at the given path

Parameters:

dataHolder - the data holder

dataPath - path of the data

context - the context of the value to check

Returns:

true if the data at the given path is defined by the model, if there is a value, even empty, for the data, and if the type of this value matches the type of the definition. false otherwise

Throws:

IllegalArgumentException - if the given data path is null or empty

BadDataPathCardinalityException - if the definition of a part of the data path is multiple. Only the last part can be multiple

getValue

public static <T> T getValue(String ametysObjectId,
 String dataPath)
                      throws IllegalArgumentException,
UndefinedItemPathException,
BadItemTypeException,
BadDataPathCardinalityException

Retrieves the value at the given path for the data aware ametys object with given id

Type Parameters:

T - type of the value to retrieve

Parameters:

ametysObjectId - identifier of the data aware ametys object

dataPath - path of the data

Returns:

the value of the data or null if not exists or is empty.

Throws:

IllegalArgumentException - if the given data path is null or empty

UndefinedItemPathException - if the given data path is not defined by the model

BadItemTypeException - if the type defined by the model doesn't match the type of the stored value

BadDataPathCardinalityException - if the definition of a part of the data path is multiple. Only the last part can be multiple

getValue

public static <T> T getValue(AmetysObject ametysObject,
 String dataPath)

Retrieves the value at the given path for the data aware ametys object with given id

Type Parameters:

T - type of the value to retrieve

Parameters:

ametysObject - the data aware ametys object

dataPath - path of the data

Returns:

the value of the data or null if not exists or is empty.

Throws:

IllegalArgumentException - if the given data path is null or empty

UndefinedItemPathException - if the given data path is not defined by the model

BadItemTypeException - if the type defined by the model doesn't match the type of the stored value

BadDataPathCardinalityException - if the definition of a part of the data path is multiple. Only the last part can be multiple

getValue

public static <T> T getValue(ModelAwareDataHolder dataHolder,
 String dataPath,
 ValueContext context)
                      throws IllegalArgumentException,
UndefinedItemPathException,
BadItemTypeException,
BadDataPathCardinalityException

Retrieves the value of the data at the given path

Type Parameters:

T - type of the value to retrieve

Parameters:

dataHolder - the data holder

dataPath - path of the data

context - the context of the value to retrieve

Returns:

the value of the data or null if not exists or is empty.

Throws:

IllegalArgumentException - if the given data path is null or empty

UndefinedItemPathException - if the given data path is not defined by the model

BadItemTypeException - if the type defined by the model doesn't match the type of the stored value

BadDataPathCardinalityException - if the definition of a part of the data path is multiple. Only the last part can be multiple

setValue

public static void setValue(ModifiableModelAwareDataHolder dataHolder,
 String dataPath,
 Object value,
 ValueContext context)
                     throws IllegalArgumentException,
UndefinedItemPathException,
BadItemTypeException,
BadDataPathCardinalityException

Sets the value of the data at the given path

Parameters:

dataHolder - the data holder

dataPath - path of the data

value - the value to set. Give null to empty the value.

context - context of the data to set

Throws:

IllegalArgumentException - if the given data path is null or empty

UndefinedItemPathException - if the given data path is not defined by the model

BadItemTypeException - if the type defined by the model doesn't match the given value to set

BadDataPathCardinalityException - if the definition of a part of the data path is multiple. Only the last part can be multiple

setValue

public static void setValue(ModifiableModelAwareDataHolder dataHolder,
 String dataPath,
 Object value,
 ValueContext context,
 boolean forceStatus)
                     throws IllegalArgumentException,
UndefinedItemPathException,
BadItemTypeException,
BadDataPathCardinalityException

Sets the value of the data at the given path

Parameters:

dataHolder - the data holder

dataPath - path of the data

value - the value to set. Give null to empty the value.

context - context of the data to set

forceStatus - true to force the status to the given status context if defined

Throws:

IllegalArgumentException - if the given data path is null or empty

UndefinedItemPathException - if the given data path is not defined by the model

BadItemTypeException - if the type defined by the model doesn't match the given value to set

BadDataPathCardinalityException - if the definition of a part of the data path is multiple. Only the last part can be multiple

removeValue

public static void removeValue(ModifiableModelAwareDataHolder dataHolder,
 String dataPath,
 ValueContext context)
                        throws IllegalArgumentException,
UndefinedItemPathException,
BadItemTypeException,
UnknownDataException,
BadDataPathCardinalityException

Removes the stored value of the data at the given path

Parameters:

dataHolder - the data holder

dataPath - path of the data

context - context of the data to remove

Throws:

IllegalArgumentException - if the given data path is null or empty

UnknownDataException - if the value at the given data path does not exist

BadItemTypeException - if the value of the parent of the given path is not an item container

UndefinedItemPathException - if the given data path is not defined by the model

BadDataPathCardinalityException - if the definition of a part of the data path is multiple. Only the last part can be multiple

copyTo

public static void copyTo(DataHolder source,
 ModifiableDataHolder destination,
 DataContext context)

Copies the source DataHolder to the given ModifiableDataHolder destination.

Parameters:

source - the source DataHolder

destination - the ModifiableDataHolder destination

context - The context of the data to copy

copyTo

public static void copyTo(DataHolder source,
 ModifiableDataHolder destination,
 String name,
 DataContext context)

Copy the data name of the source DataHolder to the given ModifiableDataHolder destination.

Parameters:

source - the source DataHolder

destination - the ModifiableDataHolder destination

name - the name of the data

context - The context of the data to copy

commentsToSAX

public static void commentsToSAX(ModelAwareDataHolder dataHolder,
 ContentHandler contentHandler,
 ViewItemAccessor viewItemAccessor,
 String dataPath)
                          throws SAXException

Generates SAX events for the data comments in the given view

Parameters:

dataHolder - the ModelAwareDataHolder

contentHandler - the ContentHandler that will receive the SAX events

viewItemAccessor - the ViewItemAccessor referencing the items for which generate SAX events

dataPath - the data path corresponding of the current data holder. Can be null or empty.

Throws:

SAXException - if an error occurs during the SAX events generation

dataToSAX

public static void dataToSAX(ModelLessDataHolder dataHolder,
 ContentHandler contentHandler,
 DataContext context)
                      throws SAXException,
UnknownTypeException,
NotUniqueTypeException

Generates SAX events for data contained in this DataHolder

Parameters:

dataHolder - the ModelLessDataHolder to SAX

contentHandler - the ContentHandler that will receive the SAX events

context - The context of the data to SAX

Throws:

SAXException - if an error occurs during the SAX events generation

UnknownTypeException - if there is no compatible type with the saxed value

NotUniqueTypeException - if there are many compatible types (there is no way to determine which type is the good one) with the saxed value

dataToSAX

public static void dataToSAX(ModelLessDataHolder dataHolder,
 ContentHandler contentHandler,
 String relativeDataPath,
 DataContext context)
                      throws SAXException,
UnknownTypeException,
NotUniqueTypeException

Generates SAX events for data at the given relative path in this DataHolder

Parameters:

dataHolder - the ModelLessDataHolder to SAX

contentHandler - the ContentHandler that will receive the SAX events

relativeDataPath - the path of the data to SAX, relative to the given data holder

context - The context of the data to SAX

Throws:

SAXException - if an error occurs during the SAX events generation

UnknownTypeException - if there is no compatible type with the saxed value

NotUniqueTypeException - if there are many compatible types (there is no way to determine which type is the good one) with the saxed value

dataToJSON

public static Map<String,Object> dataToJSON(ModelLessDataHolder dataHolder,
 DataContext context)
                                     throws UnknownTypeException,
NotUniqueTypeException

Convert the data contained in the given DataHolder

Parameters:

dataHolder - the ModelLessDataHolder

context - The context of the data to convert

Returns:

The data of the given DataHolder as JSON

Throws:

UnknownTypeException - if there is no compatible type with the value to convert

NotUniqueTypeException - if there are many compatible types (there is no way to determine which type is the good one) with the value to convert

dataToJSON

public static Object dataToJSON(ModelLessDataHolder dataHolder,
 String relativeDataPath,
 DataContext context)
                         throws UnknownTypeException,
NotUniqueTypeException

Convert the data at the given relative path into a JSON object

Parameters:

dataHolder - the ModelLessDataHolder

relativeDataPath - the path of the data to convert, relative to the given data holder

context - The context of the data to convert

Returns:

The value as JSON

Throws:

UnknownTypeException - if there is no compatible type with the value to convert

NotUniqueTypeException - if there are many compatible types (there is no way to determine which type is the good one) with the value to convert

findEditableItemsByType

public static <T> Map<String,T> findEditableItemsByType(ModelAwareDataHolder dataHolder,
 String type)

Find all modifiable data of the given type on a ModelAwareDataHolder, including in composite or repeater entries. Properties are not modifiables, so they are excluded from the result

Type Parameters:

T - the actual type of the requested data.

Parameters:

dataHolder - the data holder.

type - the type identifier.

Returns:

a Map with all data paths as keys and corresponding data as values.

findItemsByType

public static <T> Map<String,T> findItemsByType(ModelAwareDataHolder dataHolder,
 String type)

Find all data of the given type on a ModelAwareDataHolder, including in composite or repeater entries.

Type Parameters:

T - the actual type of the requested data.

Parameters:

dataHolder - the data holder.

type - the type identifier.

Returns:

a Map with all data paths as keys and corresponding data as values.

findItemsByType

public static <T> Map<String,T> findItemsByType(ModelAwareDataHolder dataHolder,
 ViewItemAccessor viewItemAccessor,
 String type)

Find all data of the given type on a ModelAwareDataHolder, including in composite or repeater entries.

Type Parameters:

T - the actual type of the requested data.

Parameters:

dataHolder - the data holder.

viewItemAccessor - the view items to restrict to

type - the type identifier.

Returns:

a Map with all data paths as keys and corresponding data as values.

getExternalizableDataProviderExtensionPoint

public static ExternalizableDataProviderExtensionPoint getExternalizableDataProviderExtensionPoint()

Retrieve the ExternalizableDataProviderExtensionPoint

Returns:

the ExternalizableDataProviderExtensionPoint

createValueContextFromSynchronizationContext

public static ValueContext createValueContextFromSynchronizationContext(ModelAwareDataHolder dataHolder,
 String dataPath,
 SynchronizationContext synchronizationContext)

Creates a value context from the given SynchronizationContext

Parameters:

dataHolder - the data holder

dataPath - the path of the value needing context

synchronizationContext - the SynchronizationContext

Returns:

the created ValueContext

getValueFromSynchronizableValue

public static Object getValueFromSynchronizableValue(Object value,
 ModelAwareDataHolder dataHolder,
 ModelItem modelItem,
 Optional<String> dataPath,
 SynchronizationContext context)

Returns the value of the synchronized value corresponding of the future status If the value is not a SynchronizableValue, the value itself is returned The future status is determined from the synchronizable value itself or from the context if needed. As the returned value is extracted from the synchronizable value, it can be an UntouchedValue

Parameters:

value - the synchronizable value

dataHolder - the data holder concerned by the value

modelItem - the model item corresponding to the value

dataPath - the current data path of the value. Can be empty if the data is in a repeater, in a not yet existing entry

context - the synchronization context, used to compute the future status of the value

Returns:

the value of the synchronized value corresponding of the future status

getArrayValuesFromSynchronizableValue

public static Object getArrayValuesFromSynchronizableValue(SynchronizableValue synchronizableValue,
 ValueContext valueContext)

Retrieves an array of values from the given SynchronizableValue. If the value is not an array, create one with a single entry

Parameters:

synchronizableValue - the SynchronizableValue

valueContext - the ValueContext to choose the value to retrieve (local or external)

Returns:

an array containing the values of the SynchronizableValue

isMultiple

public static boolean isMultiple(ModelItemAccessor parent,
 String attributePath)

Check if at least one element in the attribute path is multiple from the given parent accessor.

Parameters:

parent - The parent accessor

attributePath - The attribute path to explore

Returns:

false if all elements in the path are single, otherwise true (can be a repeater or a multiple attribute)

convertValues

public static Map<String,Object> convertValues(ViewItemAccessor viewItemAccessor,
 Map<String,Object> values)

Converts the given values according to the definitions in the given ViewItemAccessor

Parameters:

viewItemAccessor - the view item accessor

values - the values to convert

Returns:

the converted values

convertValues

public static Map<String,Object> convertValues(ViewItemAccessor viewItemAccessor,
 Map<String,Object> values,
 BiFunction<ElementDefinition,Object,Object> convertValueFunction)

Converts the given values according to the definitions in the given ViewItemAccessor

Parameters:

viewItemAccessor - the view item accessor

values - the values to convert

convertValueFunction - The function to use to convert single values

Returns:

the converted values

convertValuesWithSynchronizableValues

public static Map<String,Object> convertValuesWithSynchronizableValues(ViewItemAccessor viewItemAccessor,
 Map<String,Object> values,
 BiFunction<ElementDefinition,Object,Object> convertValueFunction,
 Optional<DataHolderHelper.SynchronizableValuesStatusInfos> synchronizableValuesStatusInfos)

Converts the given values according to the definitions in the given ViewItemAccessor

Parameters:

viewItemAccessor - the view item accessor

values - the values to convert

convertValueFunction - The function to use to convert single values

synchronizableValuesStatusInfos - informations needed to choose status of created SynchronizableValue. If empty, the status is set to ExternalizableDataProvider.ExternalizableDataStatus.LOCAL

Returns:

the converted values

convertValueIgnoringIncompatibleOnes

public static Object convertValueIgnoringIncompatibleOnes(ElementDefinition definition,
 Object value)

Converts the given value according to the given definition If the value is multiple, an array is retrieved with each value converted to the right type If the value is not compatible whit the data type, no exception is thrown and the value is converted to an UntouchedValue in order to be ignored

Parameters:

definition - the definition

value - the value to convert

Returns:

the converted value

convertValue

public static Object convertValue(ElementDefinition definition,
 Object value)
                           throws BadItemTypeException

Converts the given value according to the given definition If the value is multiple, an array is retrieved with each value converted to the right type

Parameters:

definition - the definition

value - the value to convert

Returns:

the converted value

Throws:

BadItemTypeException - if the value to convert is not compatible with the data type

createViewItemAccessorFromValues

public static ViewItemAccessor createViewItemAccessorFromValues(Collection<? extends ModelItemAccessor> modelItemAccessors,
 Map<String,Object> values)

Create a ViewItemAccessor for the items corresponding to the given values

Parameters:

modelItemAccessors - the model containing the items corresponding to the values

values - the values

Returns:

the created ViewItemAccessor

aggregateMultipleValues

public static <T> T aggregateMultipleValues(List<? extends ModelAwareDataHolder> dataHolders,
 String dataPath,
 Class managedClass)

Aggregates multiple values of the data holders at the given path

Type Parameters:

T - type of the value to retrieve

Parameters:

dataHolders - the data holding the values

dataPath - the path of the data to retrieve

managedClass - class of the retrieved values

Returns:

aggregated multiple values

removeValuesInArray

public static Object removeValuesInArray(Object originalValues,
 Object valuesToRemove,
 ElementType elementType)

Removes some values from the given original ones

Parameters:

originalValues - the original values

valuesToRemove - the values to remove from the original ones

elementType - the type of the element concerned by the values

Returns:

an array containing the original values, less the ones to remove

appendValuesInArray

public static Object appendValuesInArray(Object originalValues,
 Object valuesToAppend,
 ElementType elementType)

Append some values to the given original ones

Parameters:

originalValues - the original values

valuesToAppend - the values to append to the original ones

elementType - the type of the element concerned by the values

Returns:

an array containing the original values, and the ones to append