ierrorsinkexporter.java

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

package com.esri.solutions.jitk.web.error;

import java.util.List;

/**
 * Exports errors to a custom location defined by implementations.  The Error
 * Sink object will invoke the methods within this object in the following
 * order:
 * 
 * <ul>
 * 	<li>{@link #begin()}
 *  <li>{@link #setErrors(List)}
 *  <li>{@link #export()}
 *  <li>{@link #end()}
 * </ul>
 */
public interface IErrorSinkExporter {

	/**
	 * Invoked to indicate that exporting is going to begin and gives
	 * implementors a chance to perform any initialization.
	 */
	public void begin ();
	
	/**
	 * Sets the errors that are to be exported.  The implementation should
	 * save the list of errors internally.
	 * 
	 * @param errors	Errors to be exported, typically all errors in
	 * 					the Error Sink.
	 */
	public void setErrors (List<IError> errors);
	
	/**
	 * Invoked to export the errors to a custom location defined by implementations.
	 * Implementations should catch any checked exceptions and log accordingly.
	 */
	public void export ();
	
	/**
	 * Invoked to indicate that exporting has ended and gives implementors
	 * a chance to perform any initialization.
	 */
	public void end ();
}