Package org.ametys.runtime.model

Class ViewHelper

java.lang.Object

org.ametys.runtime.model.ViewHelper

public final class ViewHelper
extends Object

Helper class for views

Method Summary

Modifier and Type	Method	Description
static void	addViewAccessorItems(ViewItemAccessor currentAccessor, ViewItemAccessor accessorToInclude, View referenceView, String accessorPath)	Add the items of the view item accessor to include if they are not already present in the current view item accessor or in the reference view
static void	addViewItem(String relativePath, ViewItemAccessor viewItemAccessor, ModelItemAccessor... modelItemAccessors)	Add a view item in the given accessor
static boolean	areItemsPresentsOnlyOnce(View view)	Checks if all the items of the given view are present only once in the view Children of accessors that are not containers are not taken into account
static <T extends ViewItemAccessor> T	createEmptyViewItemAccessor(Collection<? extends ModelItemAccessor> modelItemAccessors)	Creates an empty ViewItemAccessor The created container can be a View, a ModelViewItemGroup or a ViewElementAccessor, according to the given ModelItemAccessors.
static <T extends ViewItemAccessor> T	createViewItemAccessor(Collection<? extends ModelItemAccessor> modelItemAccessors)	Creates a ViewItemAccessor with the items of the given ModelItemAccessor
static <T extends ViewItemAccessor> T	createViewItemAccessor(Collection<? extends ModelItemAccessor> modelItemAccessors, String... itemPaths)	Creates a ViewItemAccessor with the given items
static Collection<ModelItem>	getModelItemsFromView(View view)	Retrieves all model items in the given View
static Set<String>	getModelItemsPathsFromView(View view)	Retrieves the paths of all model items in the given View
static ModelViewItem	getModelViewItem(ViewItemAccessor viewItemAccessor, String itemPath)	Gets the ModelViewItem from the ViewItemAccessor at the given path.
static ModelViewItemGroup	getModelViewItemGroup(ViewItemAccessor viewItemAccessor, String itemPath)	Gets the ModelViewItemGroup from the ViewItemAccessor at the given path.
static View	getTruncatedView(View originalView)	Retrieves a View corresponding to the given one, avoiding the view items below the ViewItemAccessors that are not ViewItemContainers
static ViewElement	getViewElement(ViewItemAccessor viewItemAccessor, String itemPath)	Gets the ViewElement from the ViewItemAccessor at the given path.
static boolean	hasModelViewItem(ViewItemAccessor viewItemAccessor, String itemPath)	Checks if there is a ModelViewItem in the ViewItemAccessor at the given path
static View	mergeDuplicatedItems(View originalView)	Retrieves a View corresponding to the given one, where items that appears several times are merged
static Map<String,Object>	viewItemsToJSON(List<ViewItem> viewItems, DefinitionContext context)	Converts the given view items as a JSON map

Methods inherited from class java.lang.Object

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

Method Detail

addViewAccessorItems

public static void addViewAccessorItems(ViewItemAccessor currentAccessor,
                                        ViewItemAccessor accessorToInclude,
                                        View referenceView,
                                        String accessorPath)

Add the items of the view item accessor to include if they are not already present in the current view item accessor or in the reference view

Parameters:

currentAccessor - the current accessor

accessorToInclude - the accessor to include

referenceView - the reference view

accessorPath - the path of the accessor in the reference view

createViewItemAccessor

public static <T extends ViewItemAccessor> T createViewItemAccessor(Collection<? extends ModelItemAccessor> modelItemAccessors)
                                                             throws IllegalArgumentException

Creates a ViewItemAccessor with the items of the given ModelItemAccessor

Type Parameters:

T - Type of the ViewItemAccessor to create (View, ModelViewItemGroup or ViewElementAccessor)

Parameters:

modelItemAccessors - the model item accessors

Returns:

the created ViewItemAccessor

Throws:

IllegalArgumentException - if the model item accessors collection is empty

createViewItemAccessor

public static <T extends ViewItemAccessor> T createViewItemAccessor(Collection<? extends ModelItemAccessor> modelItemAccessors,
                                                                    String... itemPaths)
                                                             throws IllegalArgumentException,
                                                                    BadItemTypeException

Creates a ViewItemAccessor with the given items

Type Parameters:

T - Type of the ViewItemAccessor to create (View, ModelViewItemGroup or ViewElementAccessor)

Parameters:

modelItemAccessors - the model items accessing the items definitions

itemPaths - the paths of the items to put in the view item accessor

Returns:

the created ViewItemAccessor

Throws:

IllegalArgumentException - if the model item containers collection is empty or if an item path is null, empty, or is not defined in the given model item containers

BadItemTypeException - if a segment in a path (but not the last) does not represent a group item

createEmptyViewItemAccessor

public static <T extends ViewItemAccessor> T createEmptyViewItemAccessor(Collection<? extends ModelItemAccessor> modelItemAccessors)
                                                                  throws IllegalArgumentException

Creates an empty ViewItemAccessor The created container can be a View, a ModelViewItemGroup or a ViewElementAccessor, according to the given ModelItemAccessors.

Type Parameters:

T - The type of the created accessor

Parameters:

modelItemAccessors - the model items accessing the items definitions

Returns:

the created ViewItemAccessor

Throws:

IllegalArgumentException - if the model item accessors collection is empty

addViewItem

public static void addViewItem(String relativePath,
                               ViewItemAccessor viewItemAccessor,
                               ModelItemAccessor... modelItemAccessors)
                        throws IllegalArgumentException,
                               UndefinedItemPathException,
                               BadItemTypeException

Add a view item in the given accessor

Parameters:

relativePath - path of the item to add

viewItemAccessor - the view item accessor

modelItemAccessors - the corresponding model item accessors

Throws:

IllegalArgumentException - if the path is null or empty

UndefinedItemPathException - if the path is not defined in the given model item accessors

BadItemTypeException - if a segment in a path (but not the last) does not represent a group item

getModelItemsPathsFromView

public static Set<String> getModelItemsPathsFromView(View view)

Retrieves the paths of all model items in the given View

Parameters:

view - the View

Returns:

the paths of all items

getModelItemsFromView

public static Collection<ModelItem> getModelItemsFromView(View view)

Retrieves all model items in the given View

Parameters:

view - the View

Returns:

all model items

areItemsPresentsOnlyOnce

public static boolean areItemsPresentsOnlyOnce(View view)

Checks if all the items of the given view are present only once in the view Children of accessors that are not containers are not taken into account

Parameters:

view - the view to check

Returns:

true if all items are presents only once, false otherwise

getTruncatedView

public static View getTruncatedView(View originalView)

Retrieves a View corresponding to the given one, avoiding the view items below the ViewItemAccessors that are not ViewItemContainers

Parameters:

originalView - the view to truncate

Returns:

the truncated view

mergeDuplicatedItems

public static View mergeDuplicatedItems(View originalView)

Retrieves a View corresponding to the given one, where items that appears several times are merged

Parameters:

originalView - the view to merge

Returns:

the merged view

hasModelViewItem

public static boolean hasModelViewItem(ViewItemAccessor viewItemAccessor,
                                       String itemPath)

Checks if there is a ModelViewItem in the ViewItemAccessor at the given path

Parameters:

viewItemAccessor - The accessor of the view items

itemPath - The path of the item to check

Returns:

true if there is a model view item at the given path, false otherwise

viewItemsToJSON

public static Map<String,Object> viewItemsToJSON(List<ViewItem> viewItems,
                                                       DefinitionContext context)
                                                throws ProcessingException

Converts the given view items as a JSON map

Parameters:

viewItems - the view items to convert

context - the context of the items' definitions

Returns:

The view items as a JSON map

Throws:

ProcessingException - If an error occurs when converting the view items

getModelViewItem

public static ModelViewItem getModelViewItem(ViewItemAccessor viewItemAccessor,
                                             String itemPath)
                                      throws UndefinedItemPathException,
                                             BadItemTypeException

Gets the ModelViewItem from the ViewItemAccessor at the given path.
Unlike ViewItemAccessor.getModelViewItem(String), this method accepts a path and not only a name, allowing to traverse composites.

Parameters:

viewItemAccessor - The accessor of view items

itemPath - The path of the item to get

Returns:

The ModelViewItem. Can never be null

Throws:

UndefinedItemPathException - If one of the parts of the given path is undefined

BadItemTypeException - If one of the parts of the given path is defined, but is not of the correct type

getViewElement

public static ViewElement getViewElement(ViewItemAccessor viewItemAccessor,
                                         String itemPath)
                                  throws UndefinedItemPathException,
                                         BadItemTypeException

Gets the ViewElement from the ViewItemAccessor at the given path.
Unlike ViewItemAccessor.getModelViewItem(String), this method accepts a path and not only a name, allowing to traverse composites.

Parameters:

viewItemAccessor - The accessor of view items

itemPath - The path of the item to get

Returns:

The ViewElement. Can never be null

Throws:

UndefinedItemPathException - If one of the parts of the given path is undefined

BadItemTypeException - If one of the parts of the given path is defined, but is not of the correct type

getModelViewItemGroup

public static ModelViewItemGroup getModelViewItemGroup(ViewItemAccessor viewItemAccessor,
                                                       String itemPath)
                                                throws UndefinedItemPathException,
                                                       BadItemTypeException

Gets the ModelViewItemGroup from the ViewItemAccessor at the given path.
Unlike ViewItemAccessor.getModelViewItem(String), this method accepts a path and not only a name, allowing to traverse composites.

Parameters:

viewItemAccessor - The accessor of view items

itemPath - The path of the container to get

Returns:

The ModelViewItemGroup. Can never be null

Throws:

UndefinedItemPathException - If one of the parts of the given path is undefined

BadItemTypeException - If one of the parts of the given path is defined, but is not of the correct type