irastercatalogfactory.java

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

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

import com.esri.arcgis.geodatabase.IRasterCatalog;
import com.esri.arcgis.server.IServerContext;
import com.esri.solutions.jitk.services.common.ServicesException;

/**
 * Responsible for creating {@link IRasterCatalog} instances that reference
 * Raster Catalogs on the Server.  It is up to implementations of this
 * interface to determine the exact strategy on creating the {@link IRasterCatalog}
 * instance.  Implementors should follow these general rules:
 * 
 * <ul>
 * 	<li>Don't release the {@link IServletContext} instance.  It will
 * 		be released by the caller at some point.
 *  <li>Don't store the {@link IRasterCatalog} instance as a member variable.  It may
 *  	not be usable after the {@link IServletContext} is released.
 * </ul>
 */
public interface IRasterCatalogFactory {

	/**
	 * Creates {@link IRasterCatalog} objects.  A proxy to the RasterCatalog object on
	 * the server will be returned.  The proxy will point to the RasterCatalog object on the
	 * server specified by the {@link IServerContext} parameters.  If there are any error 
	 * conditions that occur within this method then a {@link ElevationException} should
	 * be thrown.
	 * 
	 * @param ctx		Reference to {@link IServerContext}, cannot be <code>null</code>
	 * @return Proxy object to RasterCatalog on the server.
	 * @throws ServicesException	Thrown if there is an error condition that occurred.
	 */
	public IRasterCatalog createRasterCatalog (IServerContext ctx) throws ServicesException;
}