imapcompositioneventproducer.java

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

package com.esri.solutions.jitk.web.tasks.mapcomp;

import java.util.List;

/**
 * Produces Map Composition Events to a set of Map Composition Event Observers.
 */
public interface IMapCompositionEventProducer {

	/**
	 * Pushes the Map Composition Event to the current observers.  The implementation
	 * must make a decision on which call back to call.  Typically, the following should
	 * be done:
	 * 
	 * <table>
	 * 	<tr>
	 * 	<td>Event Type</td>
	 *  <td>Callback Method</td>
	 *  </tr>
	 *  <tr>
	 *  	<td>MapCompositionEventType.CREATED</td>
	 *  	<td>{@link IMapCompositionEventObserver#created(MapCompositionEvent)}</td>
	 *  </tr>
	 *  <tr>
	 *  	<td>MapCompositionEventType.OPENED</td>
	 *  	<td>{@link IMapCompositionEventObserver#opened(MapCompositionEvent)(MapCompositionEvent)}</td>
	 *  </tr>
	 *  <tr>
	 *  	<td>MapCompositionEventType.SAVED</td>
	 *  	<td>{@link IMapCompositionEventObserver#saved(MapCompositionEvent)
	 *  </tr>
	 *  <tr>
	 *  	<td>MapCompositionEventType.DELETED</td>
	 *  	<td>{@link IMapCompositionEventObserver#deleted(MapCompositionEvent)(MapCompositionEvent)}</td>
	 *  </tr>
	 *  </table>
	 *  
	 * @param event	Contains applicable event information.
	 */
	public void push (MapCompositionEvent event);
	
	/**
	 * Returns a list of Map Composition Event observers.  This list is intended to be read-only.
	 * Observers should not be added to this list and expect to be notified of a Map Composition Event.
	 * 
	 * @return List of Map Composition Event Observers.
	 */
	public List<IMapCompositionEventObserver> getObservers();
}