Class ISpatialCacheManager3Proxy

  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.geodatabase.ISpatialCacheManagerProxy
          extended by com.esri.arcgis.geodatabase.ISpatialCacheManager2Proxy
              extended by com.esri.arcgis.geodatabase.ISpatialCacheManager3Proxy
All Implemented Interfaces:
ISpatialCacheManager, ISpatialCacheManager2, ISpatialCacheManager3, Externalizable, Serializable

public class ISpatialCacheManager3Proxy
extends ISpatialCacheManager2Proxy
implements ISpatialCacheManager3, Serializable

Provides access to members that control the Spatial Cache Management.


The ISpatialCacheManager3 interface was added to enable creating a spatial cache and allowing the creation process to be cancelable.

Enabling feature caching improves the performance of all spatial searches whose query geometry lies within the cached area and and also improves the performance of all queries that retrieve features by object ID (for example, GetRow, GetFeature, GetRows, and GetFeatures). At ArcGIS release 8.3 and earlier, caching of features using ISpatialCacheManager requires that there be an active edit session. At ArcGIS release 9.0 and higher, using ISpatialCacheManager does not require an active edit session.

Use of the cache is transparent to editing applications. Objects retrieved using non-recycling cursors may be updated and stored by the editing application. As in the uncached case, the geodatabase takes care of ensuring read and query consistency when queries are issued againt updated objects. The cache is exposed to end users as the edit cache in ArcMap for ArcGIS release 8.3 and earlier, and the map cache for ArcGIS releases 9.0 and higher. The cache improves performance significantly for network editing when working with ArcSDE geodatabases.

The SpatialCacheManager optimistically builds caches for features within the workspace. It caches the features in the cache extent for any open feature class. Note that opening a feature class that participates in a topology or geometric network will also open all other feature classes participating in the topology or geometric network. To correctly use the cache, you should be aware of which feature classes are open within a workspace. If a reference to the workspace is returned from a map document, the open feature classes will include all the feature classes for that workspace in the map. If you have opened the workspace through the Geodatabase API, by using a method such as IFeatureWorkspace::OpenFeatureDataset, only those features from feature classes that have been explicitly opened using the IFeatureWorkspace::OpenFeatureClass method will be cached.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

See Also:
Serialized Form

Field Summary
 boolean noncastable
Fields inherited from class com.esri.arcgis.interop.Dispatch
Constructor Summary
  ISpatialCacheManager3Proxy(Object obj)
protected ISpatialCacheManager3Proxy(Object obj, String iid)
Method Summary
 void addListener(String iidStr, Object theListener, Object theSource)
 void fillCacheWithCancel(IEnvelope pExtent, double expansionFactor, ITrackCancel pCancelTraker)
          Fills the spatial cache using the specified extent with an expansion factor.
 void removeListener(String iidStr, Object theListener)
Methods inherited from class com.esri.arcgis.geodatabase.ISpatialCacheManager2Proxy
fillCacheEx, getCacheExpansionFactor
Methods inherited from class com.esri.arcgis.geodatabase.ISpatialCacheManagerProxy
emptyCache, fillCache, getCacheExtent, isCacheIsFull
Methods inherited from class com.esri.arcgis.interop.Dispatch
bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface com.esri.arcgis.geodatabase.ISpatialCacheManager2
fillCacheEx, getCacheExpansionFactor
Methods inherited from interface com.esri.arcgis.geodatabase.ISpatialCacheManager
emptyCache, fillCache, getCacheExtent, isCacheIsFull

Field Detail


public boolean noncastable
Constructor Detail


public ISpatialCacheManager3Proxy()


public ISpatialCacheManager3Proxy(Object obj)
                           throws IOException


protected ISpatialCacheManager3Proxy(Object obj,
                                     String iid)
                              throws IOException
Method Detail


public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException
addListener in class ISpatialCacheManager2Proxy


public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException
removeListener in class ISpatialCacheManager2Proxy


public void fillCacheWithCancel(IEnvelope pExtent,
                                double expansionFactor,
                                ITrackCancel pCancelTraker)
                         throws IOException,
Fills the spatial cache using the specified extent with an expansion factor.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:
fillCacheWithCancel in interface ISpatialCacheManager3
pExtent - A reference to a com.esri.arcgis.geometry.IEnvelope (in)
expansionFactor - The expansionFactor (in)
pCancelTraker - A reference to a com.esri.arcgis.system.ITrackCancel (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.