com.esri.arcgis.geodatabase
Class ITopologyContainerProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.geodatabase.ITopologyContainerProxy

All Implemented Interfaces:

ITopologyContainer, Externalizable, Serializable

Direct Known Subclasses:

ITopologyContainer2Proxy

public class ITopologyContainerProxy
extends com.esri.arcgis.interop.Dispatch
implements ITopologyContainer, Serializable

Provides access to members that create, add, and hand out topologies.

Superseded By

ITopologyContainer2

Remarks

The ITopologyContainer interface can be used to manage and create topologies within a feature dataset. If your intention is to simply browse for the set of topologies in a feature dataset, it is not necessary to open the feature dataset and call the methods on ITopologyContainer. The IFeatureDatasetNames::TopologyNames method can be used to efficiently obtain this information. Careful consideration should be given to specifying the parameters when creating a topology. Once the topology is built, none of the parameters can be modified. In order to change properties such as cluster tolerance, the topology must be deleted and rebuilt with the new parameters.

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

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

	ITopologyContainerProxy()
	ITopologyContainerProxy(Object obj)
protected	ITopologyContainerProxy(Object obj, String iid)

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
ITopology	createTopology(String name, double clusterTolerance, int maxGeneratedErrorCount, String configurationKeyword) Creates a new topology.
double	getDefaultClusterTolerance() The default cluster tolerance as per the topology engine.
double	getMaximumClusterTolerance() The maximal cluster tolerance as per the topology engine.
double	getMinimumClusterTolerance() The minimal cluster tolerance as per the topology engine.
ITopology	getTopology(int index) The topology at the specified index.
ITopology	getTopologyByID(int iD) The topology with the specified ID.
ITopology	getTopologyByName(String name) The topology with the specified name.
int	getTopologyCount() The number of topologies in the container.
void	removeListener(String iidStr, Object theListener)

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

Field Detail

noncastable

public boolean noncastable

Constructor Detail

ITopologyContainerProxy

public ITopologyContainerProxy()

ITopologyContainerProxy

public ITopologyContainerProxy(Object obj)
                        throws IOException

Throws:

IOException

ITopologyContainerProxy

protected ITopologyContainerProxy(Object obj,
                                  String iid)
                           throws IOException

Throws:

IOException

Method Detail

addListener

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

Overrides:

addListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

removeListener

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

Overrides:

removeListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

getTopology

public ITopology getTopology(int index)
                      throws IOException,
                             AutomationException

The topology at the specified index.

Product Availability

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

Specified by:

getTopology in interface ITopologyContainer

Parameters:

index - The index (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.ITopology

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTopologyByName

public ITopology getTopologyByName(String name)
                            throws IOException,
                                   AutomationException

The topology with the specified name.

Product Availability

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

Specified by:

getTopologyByName in interface ITopologyContainer

Parameters:

name - The name (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.ITopology

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTopologyByID

public ITopology getTopologyByID(int iD)
                          throws IOException,
                                 AutomationException

The topology with the specified ID.

Product Availability

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

Specified by:

getTopologyByID in interface ITopologyContainer

Parameters:

iD - The iD (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.ITopology

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTopologyCount

public int getTopologyCount()
                     throws IOException,
                            AutomationException

The number of topologies in the container.

Remarks

The number of Topologies in this container (FeatureDataset).

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getTopologyCount in interface ITopologyContainer

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createTopology

public ITopology createTopology(String name,
                                double clusterTolerance,
                                int maxGeneratedErrorCount,
                                String configurationKeyword)
                         throws IOException,
                                AutomationException

Creates a new topology.

Remarks

The CreateTopology method creates a topology with the specified name, cluster tolerance, maximum allowable number of errors to be generated and for ArcSDE, with the supplied configuation keyword. When a topology is initially created, it is empty with no participating feature classes or rules.

The ITopologyContainer::DefaultClusterTolerance property should be used to return the default or recommended cluster tolerance for a topology. The ITopologyContainer::MaximumClusterTolerance property can be used to return the maximum cluster tolerance for a topology. You cannot specify a cluster tolerance larger than the maximum or smaller than the minimum or default cluster tolerance. As such, if the specified cluster tolerance is less than the DefaultClusterTolerance for the feature dataset, then the Topology will be created with the default cluster tolerance value. If the specified cluster tolerance is larger than the MaximumClusterTolerance, the topology will be created with the maximum cluster tolerance.

Using the CreateTopology method to create a topology within a geodatabase that supports Z cluster tolerances, will result in a topology with a ZClusterTolerance of 0.

Starting at version 9.2, cluster tolerance values should match the feature dataset's tolerance values.

The maxGeneratedErrorCount parameter specifies the maximum number of errors validate will generate before stopping. Setting a value of -1 indicates there is no limit to the number of errors that will be generated.

The configurationKeyword parameter allows the application to control the physical layout for this table in the underlying RDBMS—for example, in the case of an Oracle database, the configuration keyword controls the tablespace in which the table is created, the initial and next extents, and other properties. The configurationKeywords for an ArcSDE instance are set up by the ArcSDE data administrator, the list of available keywords supported by a workspace may be obtained using the IWorkspaceConfiguration interface. The configurationKeyword parameter is not mandatory when building a topology in an ArcSDE Geodatabase, an empty string can be specified, in which case the topology will be built using the default configuration.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

createTopology in interface ITopologyContainer

Parameters:

name - The name (in)

clusterTolerance - The clusterTolerance (in)

maxGeneratedErrorCount - The maxGeneratedErrorCount (in)

configurationKeyword - The configurationKeyword (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.ITopology

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDefaultClusterTolerance

public double getDefaultClusterTolerance()
                                  throws IOException,
                                         AutomationException

The default cluster tolerance as per the topology engine.

Remarks

Returns the "default" cluster tolerance as generated by the topology engine. Currently this is the same as the MinimumClusterTolerance.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getDefaultClusterTolerance in interface ITopologyContainer

Returns:

The clusterTolerance

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMinimumClusterTolerance

public double getMinimumClusterTolerance()
                                  throws IOException,
                                         AutomationException

The minimal cluster tolerance as per the topology engine.

Remarks

Returns the minimum cluster tolerance for the topology.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getMinimumClusterTolerance in interface ITopologyContainer

Returns:

The clusterTolerance

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMaximumClusterTolerance

public double getMaximumClusterTolerance()
                                  throws IOException,
                                         AutomationException

The maximal cluster tolerance as per the topology engine.

Remarks

Returns the maximum cluster tolerance for the topology. This value will be six orders of magnitude (10^6) greater than the minimum cluster tolerance. For example, if the minimum cluster tolerance is 0.0000020407, the maximum cluster tolerance will be 0.20407.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getMaximumClusterTolerance in interface ITopologyContainer

Returns:

The clusterTolerance

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.