Package org.ametys.runtime.model

Class ModelHelper

java.lang.Object

org.ametys.runtime.model.ModelHelper

public final class ModelHelper
extends Object

Helper class for models

Field Summary

Fields

Modifier and Type	Field	Description
private static org.slf4j.Logger	__LOGGER

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ModelHelper()

Method Summary

Modifier and Type	Method	Description
private static boolean	_checkValueEnumeration(Object value)
private static Object	_emptyStringToNull(Object compareValue)
private static boolean	_evaluateCondition(DisableCondition condition, Map<String,DefinitionAndValue> definitionAndValues, org.slf4j.Logger logger)
private static boolean	_evaluateConditionValue(Object value, DisableCondition.OPERATOR operator, Object compareValue)
private static List<ModelItem>	_getAllModelItemsInPath(String definitionPath, ModelItemAccessor itemAccessor)
private static boolean	_hasDisableConditions(DisableConditions disableConditions)
private static Pair<Boolean,ElementDefinition>	_isModelItemGroupActive(ModelItemGroup group, Map<String,Object> values)
private static void	_validateEnumeration(ElementDefinition definition, Object value, List<I18nizableText> errorsList)
static boolean	evaluateDisableConditions(DisableConditions disableConditions, Map<String,DefinitionAndValue> definitionAndValues, org.slf4j.Logger logger)	Recursively evaluate the DisableConditions against the given values
static List<ModelItem>	findModelItemsByType(ModelItemContainer container, String type)	Find all model items of the given type
static List<ModelItem>	getAllModelItemsInPath(String path, Collection<? extends ModelItemAccessor> itemAccessors)	Retrieve the list of successive model items represented by the given path.
static Map<String,List<ModelItem>>	getAllModelItemsInPaths(Set<String> paths, Collection<? extends ModelItemAccessor> itemAccessors)	Retrieve the list of successive model items represented by the given paths, indexed by path.
static String	getDefinitionPathFromDataPath(String dataPath)	Retrieves the given dataPath as a definition path (without the repeaterEntry positions)
static ModelItem	getModelItem(String path, Collection<? extends ModelItemAccessor> itemAccessors)	Retrieves the model item at the given relative path
static boolean	hasModelItem(String path, Collection<? extends ModelItemAccessor> itemAccessors)	Checks if there is a model item at the given relative path
static boolean	hasModelItemOfType(ModelItemContainer container, String type)	Determines if a container of model items contains a model item of the given type
static boolean	isGroupSwitchOn(ModelItem modelItem, Map<String,Object> values)	Checks if this item is in a group with a switch on
static List<I18nizableText>	validateValue(ElementDefinition definition, Object value)	Validates the given value
static List<I18nizableText>	validateValue(ElementDefinition definition, Object value, boolean checkEnumerated)	Validates the given value

Methods inherited from class java.lang.Object

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

Field Detail

__LOGGER

private static final org.slf4j.Logger __LOGGER

Constructor Detail

ModelHelper

private ModelHelper()

Method Detail

hasModelItem

public static boolean hasModelItem(String path,
                                   Collection<? extends ModelItemAccessor> itemAccessors)
                            throws IllegalArgumentException

Checks if there is a model item at the given relative path

Parameters:

path - path of the model item. This path is relative to the given accessors. No matter if it is a definition or data path (with repeater entry positions)

itemAccessors - model item accessors where to search if there is a model item

Returns:

true if there is model item at this path, false otherwise

Throws:

IllegalArgumentException - if the given path is null or empty

getModelItem

public static ModelItem getModelItem(String path,
                                     Collection<? extends ModelItemAccessor> itemAccessors)
                              throws IllegalArgumentException,
                                     UndefinedItemPathException

Retrieves the model item at the given relative path

Parameters:

path - path of the model item to retrieve. This path is relative to the given accessors. No matter if it is a definition or data path (with repeater entry positions)

itemAccessors - model item accessors where to search the model item

Returns:

the model item

Throws:

IllegalArgumentException - if the given path is null or empty

UndefinedItemPathException - if there is no item defined at the given path in given item accessors

getAllModelItemsInPaths

public static Map<String,List<ModelItem>> getAllModelItemsInPaths(Set<String> paths,
                                                                        Collection<? extends ModelItemAccessor> itemAccessors)
                                                                 throws IllegalArgumentException,
                                                                        UndefinedItemPathException

Retrieve the list of successive model items represented by the given paths, indexed by path.

Parameters:

paths - paths of the model items to retrieve. These paths are relative to the given accessors. No matter if they are definition or data paths (with repeater entry positions)

itemAccessors - model item accessors where to search the model items

Returns:

the list of successive model items, indexed by path

Throws:

IllegalArgumentException - if one of the given paths is null or empty

UndefinedItemPathException - if there is no item defined at one of the given paths in given item accessors

getAllModelItemsInPath

public static List<ModelItem> getAllModelItemsInPath(String path,
                                                     Collection<? extends ModelItemAccessor> itemAccessors)
                                              throws IllegalArgumentException,
                                                     UndefinedItemPathException

Retrieve the list of successive model items represented by the given path.

Parameters:

path - path of the model items to retrieve. This path is relative to the given accessors. No matter if it is a definition or data path (with repeater entry positions)

itemAccessors - model item accessors where to search the model items

Returns:

the list of successive model items

Throws:

IllegalArgumentException - if the given path is null or empty

UndefinedItemPathException - if there is no item defined at the given path in given item accessors

_getAllModelItemsInPath

private static List<ModelItem> _getAllModelItemsInPath(String definitionPath,
                                                       ModelItemAccessor itemAccessor)

hasModelItemOfType

public static boolean hasModelItemOfType(ModelItemContainer container,
                                         String type)

Determines if a container of model items contains a model item of the given type

Parameters:

container - the model item container

type - the type identifier to find.

Returns:

true if a model item of the given type is found

findModelItemsByType

public static List<ModelItem> findModelItemsByType(ModelItemContainer container,
                                                   String type)

Find all model items of the given type

Parameters:

container - the model item container

type - the type identifier to find.

Returns:

the list of ModelItems of this type

getDefinitionPathFromDataPath

public static String getDefinitionPathFromDataPath(String dataPath)

Retrieves the given dataPath as a definition path (without the repeaterEntry positions)

Parameters:

dataPath - the data path

Returns:

the definition path

isGroupSwitchOn

public static boolean isGroupSwitchOn(ModelItem modelItem,
                                      Map<String,Object> values)

Checks if this item is in a group with a switch on

Parameters:

modelItem - the item to check

values - all items' values to get switchers' values

Returns:

false if this item is part of a group with a switch to off, true otherwise

_isModelItemGroupActive

private static Pair<Boolean,ElementDefinition> _isModelItemGroupActive(ModelItemGroup group,
                                                                             Map<String,Object> values)

evaluateDisableConditions

public static boolean evaluateDisableConditions(DisableConditions disableConditions,
                                                Map<String,DefinitionAndValue> definitionAndValues,
                                                org.slf4j.Logger logger)

Recursively evaluate the DisableConditions against the given values

Parameters:

disableConditions - the disable conditions to evaluate

definitionAndValues - the values to evaluate

logger - the logger for disable conditions evaluation logs

Returns:

true if the disable conditions are true, false otherwise

_hasDisableConditions

private static boolean _hasDisableConditions(DisableConditions disableConditions)

_evaluateCondition

private static boolean _evaluateCondition(DisableCondition condition,
                                          Map<String,DefinitionAndValue> definitionAndValues,
                                          org.slf4j.Logger logger)

_evaluateConditionValue

private static boolean _evaluateConditionValue(Object value,
                                               DisableCondition.OPERATOR operator,
                                               Object compareValue)

_emptyStringToNull

private static Object _emptyStringToNull(Object compareValue)

validateValue

public static List<I18nizableText> validateValue(ElementDefinition definition,
                                                 Object value)

Validates the given value

Parameters:

definition - The definition to use to validate the value

value - the value to validate

Returns:

the structure with errors information if the validation failed.

validateValue

public static List<I18nizableText> validateValue(ElementDefinition definition,
                                                 Object value,
                                                 boolean checkEnumerated)

Validates the given value

Parameters:

definition - The definition to use to validate the value

value - the value to validate

checkEnumerated - true true to make sure that the item with an enumerator has its value in the enumerated values

Returns:

the structure with errors information if the validation failed. TODO NEWATTRIBUTEAPI RUNTIME-2897: remove this method to always check enumerator when validating a value

_validateEnumeration

private static void _validateEnumeration(ElementDefinition definition,
                                         Object value,
                                         List<I18nizableText> errorsList)

_checkValueEnumeration

private static boolean _checkValueEnumeration(Object value)