resourcecontextmenuitems.java

esri的ArcGIS Server超级学习模板程序（for java）

package com.esri.solutions.jitk.common.contextmenus;

import java.util.ArrayList;
import java.util.List;

/**
 * Container for GIS Resource Context Menu Items.  The Context Menu Items
 * within this object are associated at the GIS Resource level within
 * the Table Of Contents.  The Context Menu Items have final say on
 * whether they should be displayed for a specific GIS Resource via
 * the {@link IResourceContextMenuItem#shouldDisplay(com.esri.adf.web.data.GISResource)}
 * method.
 */
public class ResourceContextMenuItems {

	/**
	 * Container for Resource Context Menu Items.
	 */
	private final List<IResourceContextMenuItem> m_contextMenuItems;
	
	/**
	 * Constructs a new <code>ResourceContextMenuItems</code> object
	 * and initializes the internal containers.
	 */
	public ResourceContextMenuItems () {
		m_contextMenuItems = new ArrayList<IResourceContextMenuItem>();
	}
	
	/**
	 * Sets the collection of Resource Context Menu Items within this
	 * container.  If the specified argument is <code>null</code> then
	 * any current Resource Context Menu Items will remain intact and
	 * no action will be performed.  To clear the current Resource
	 * Context Menu Items, pass an empty list into this method.
	 * 
	 * @param contextMenuItems	Collection of Resource Context Menu Items.
	 */
	public void setContextMenuItems (List<IResourceContextMenuItem> contextMenuItems) {
		if (contextMenuItems != null) {
			m_contextMenuItems.clear();
			m_contextMenuItems.addAll(contextMenuItems);
		}
	}

	/**
	 * Returns the collection of Resource Context Menu Items within
	 * this container.  <code>null</code> will never be returned.
	 * 
	 * @return Collection of current Resource Context Menu Items.
	 */
	public List<IResourceContextMenuItem> getContextMenuItems () {
		return m_contextMenuItems;
	}
}