001/*
002 *  Copyright 2020 Anyware Services
003 *
004 *  Licensed under the Apache License, Version 2.0 (the "License");
005 *  you may not use this file except in compliance with the License.
006 *  You may obtain a copy of the License at
007 *
008 *      http://www.apache.org/licenses/LICENSE-2.0
009 *
010 *  Unless required by applicable law or agreed to in writing, software
011 *  distributed under the License is distributed on an "AS IS" BASIS,
012 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 *  See the License for the specific language governing permissions and
014 *  limitations under the License.
015 */
016package org.ametys.runtime.model;
017
018import java.util.List;
019
020import org.apache.commons.lang3.StringUtils;
021
022/**
023 * Interface for objects that can access to some view items
024 */
025public interface ViewItemAccessor
026{
027    /**
028     * Retrieves all the view items of this accessor
029     * @return the view items
030     */
031    public List<ViewItem> getViewItems();
032    
033    /**
034     * Add a view item in the accessor
035     * @param item the item to add
036     */
037    public void addViewItem(ViewItem item);
038    
039    /**
040     * Insert a view item in the accessor at the given index
041     * @param item the item to insert
042     * @param index index at which the item has to be inserted
043     */
044    public void insertViewItem(ViewItem item, int index);
045    
046    /**
047     * Removes the given items of this accessor
048     * @param item the item to remove
049     * @return <code>true</code> if this accessor contained the given item, <code>false</code> otherwise
050     */
051    public boolean removeViewItem(ViewItem item);
052    
053    /**
054     * Removes all items of this accessor
055     */
056    public void clear();
057    
058    /**
059     * Add view items in the accessor
060     * @param items the items to add
061     */
062    public default void addViewItems(List<ViewItem> items)
063    {
064        for (ViewItem item : items)
065        {
066            addViewItem(item);
067        }
068    }
069    
070    /**
071     * Checks if the current {@link ViewItemAccessor} contains the given model view item
072     * Consider that the accessor contains the given item if it contains an item representing the same definition
073     * @param item the item
074     * @return <code>true</code> if the accessor contains the given item, <code>false</code> otherwise 
075     */
076    public default boolean hasModelViewItem(ModelViewItem item)
077    {
078        return hasModelViewItem(item, StringUtils.EMPTY, item.getDefinition().getPath());
079    }
080    
081    /**
082     * Checks if the current {@link ViewItemAccessor} contains the given model view item
083     * Consider that the accessor contains the given item if it contains an item representing the same definition AND with the same children if it is a group AND at the same position as the given path
084     * @param item the item
085     * @param currentAccessorPath The path of the current item accessor
086     * @param itemPath the path of the item in the accessor
087     * @return <code>true</code> if the accessor contains the given item, <code>false</code> otherwise 
088     */
089    public default boolean hasModelViewItem(ModelViewItem item, String currentAccessorPath, String itemPath)
090    {
091        for (ViewItem currentItem : getViewItems())
092        {
093            String currentItemPath = currentAccessorPath;
094            if (currentItem instanceof ModelViewItem)
095            {
096                currentItemPath += StringUtils.isNotEmpty(currentAccessorPath) ? ModelItem.ITEM_PATH_SEPARATOR + currentItem.getName() : currentItem.getName();
097                if (currentItemPath.equals(itemPath) && currentItem.equals(item))
098                {
099                    return true;
100                }
101            }
102            
103            if (currentItem instanceof ViewItemAccessor && ((ViewItemAccessor) currentItem).hasModelViewItem(item, currentItemPath, itemPath))
104            {
105                return true;
106            }
107        }
108        
109        // No item found
110        return false;
111    }
112    
113    /**
114     * Checks if there is a model view item with the given name
115     * @param itemName the name of the item
116     * @return <code>true</code> if the accessor can access to an item with the given name, <code>false</code> otherwise 
117     */
118    public default boolean hasModelViewItem(String itemName)
119    {
120        return getModelViewItem(itemName) != null;
121    }
122    
123    /**
124     * Retrieves the model view item with the given name
125     * If there are more than one corresponding items, the first one is retrieved
126     * @param itemName the name of the item
127     * @return the model view item, or <code>null</code> if none was found
128     */
129    public default ModelViewItem getModelViewItem(String itemName)
130    {
131        if (StringUtils.isEmpty(itemName))
132        {
133            return null;
134        }
135        else
136        {
137            for (ViewItem item : getViewItems())
138            {
139                // The item is a reference to the model
140                if (item instanceof ModelViewItem)
141                {
142                    if (itemName.equals(item.getName()))
143                    {
144                        return (ModelViewItem) item;
145                    }
146                }
147                // The item is not a reference to the model and is a group => check its children
148                else if (item instanceof ViewItemAccessor)
149                {
150                    ModelViewItem modelViewItem = ((ViewItemAccessor) item).getModelViewItem(itemName);
151                    if (modelViewItem != null)
152                    {
153                        return modelViewItem;
154                    }
155                }
156            }
157        
158            // No item found
159            return null;
160        }
161    }
162}