iservercontextfactory.java

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

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

import com.esri.arcgis.server.IServerContext;

/**
 * Responsible for creating instances of {@link IServerContext}.  It is up
 * to implementations of this interface to determine the exact strategy for
 * creating the {@link IServerContext} instances.  In general, the following
 * rules should be followed by implementors of this interface:
 * 
 * <ul>
 * 	<li>{@link IServerContext} objects should not be stored as member variables of the class.
 *  <li>{@link IServerContext#releaseContext()} should not be called in the {@link #createServerContext()}
 *  	method.  Otherwise, no one will be able to use the returned {@link IServerContext}.
 * </ul>
 */
public interface IServerContextFactory {

	/**
	 * Creates {@link IServerContext} objects.  If there was an error condition while
	 * attempting to create an {@link IServerContext} then a {@link ServicesException}
	 * should be thrown.
	 * 
	 * @return Instance of {@link IServerContext}, <code>null</code> should not be
	 * 			returned.
	 * @throws ServicesException	Thrown if there was an error condition while attempting
	 * 								to create a {@link IServerContext}.
	 */
	public IServerContext createServerContext () throws ServicesException;
	
}