com.esri.arcgis.geodatabase
Class IGeometricNetworkErrorDetectionProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.geodatabase.IGeometricNetworkErrorDetectionProxy
All Implemented Interfaces:
IGeometricNetworkErrorDetection, Externalizable, Serializable

public class IGeometricNetworkErrorDetectionProxy
extends com.esri.arcgis.interop.Dispatch
implements IGeometricNetworkErrorDetection, Serializable

Provides access to members that manage and provide geometric network error detection.

Description

The IGeometricNetworkErrorDetection interface identifies errors between a geometric network and its logical network. In order to maintain correct network connectivity in large production environments, it is necessary to have a collection of tools that will enable the user to detect a variety of connectivity problems within a geometric network. In production environments, it is often impractical to drop the network and rebuild when connectivity problems are encountered during general editing of the network. For this reason, it is necessary to provide a set of tools that will enable the end user to detect and repair such problems.

Philosophically, there should not be any need for such tools—the network should always be correct. From this standpoint, the geodatabase will not waver. However, there are certain circumstances where this may
be violated:

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
  IGeometricNetworkErrorDetectionProxy()
           
  IGeometricNetworkErrorDetectionProxy(Object obj)
           
protected IGeometricNetworkErrorDetectionProxy(Object obj, String iid)
           
 
Method Summary
 void addListener(String iidStr, Object theListener, Object theSource)
           
 void createErrorTable(String name, ITable[] errorTable)
          Creates a non-versioned table that can be used to persist error information.
 ISet createSelectionSetFromErrorTable()
          Returns a set of selection sets of the features in the geometric network Error Table.
 void deleteNetworkElements(ISet selectionSets)
          Deletes the network elements associated with the specified network features.
 void detectNetworkErrors(int errorType, IEnvelope areaOfInterest, ISet selectionSets, ISet[] problemSelectionSets)
          The features in the geometric network with connectivity problems.
 ITable getErrorTable()
          The error table currently associated with the geometric network.
 void removeListener(String iidStr, Object theListener)
           
 void setErrorTable(ITable errorTable)
          The error table currently associated with the geometric network.
 
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

IGeometricNetworkErrorDetectionProxy

public IGeometricNetworkErrorDetectionProxy()

IGeometricNetworkErrorDetectionProxy

public IGeometricNetworkErrorDetectionProxy(Object obj)
                                     throws IOException
Throws:
IOException

IGeometricNetworkErrorDetectionProxy

protected IGeometricNetworkErrorDetectionProxy(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

getErrorTable

public ITable getErrorTable()
                     throws IOException,
                            AutomationException
The error table currently associated with the geometric network. This property will return nothing unless it has been set within the running application.

Description

The ErrorTable property provides the ability to either return the error table if it exists or associate an error table with the geometric network, after it has been created with the IGeometricNetworkErrorDetection::CreateErrorTable method. Once the error table is created, it can be associated with, or retrieved from, a geometric network. However, this association will not be persisted—the association is only for the lifetime of the geometric network component instance. The user is responsible for managing this error table.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getErrorTable in interface IGeometricNetworkErrorDetection
Returns:
A reference to a com.esri.arcgis.geodatabase.ITable
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setErrorTable

public void setErrorTable(ITable errorTable)
                   throws IOException,
                          AutomationException
The error table currently associated with the geometric network. This property will return nothing unless it has been set within the running application.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setErrorTable in interface IGeometricNetworkErrorDetection
Parameters:
errorTable - A reference to a com.esri.arcgis.geodatabase.ITable (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createSelectionSetFromErrorTable

public ISet createSelectionSetFromErrorTable()
                                      throws IOException,
                                             AutomationException
Returns a set of selection sets of the features in the geometric network Error Table.

Description

A set of selection sets may be created from all the entries found in the error table that are currently associated with a geometric network via the CreateSelectionSetFromErrorTable method. This is a mechanism that can be used to create instances of the network features that are listed in the error table.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
createSelectionSetFromErrorTable in interface IGeometricNetworkErrorDetection
Returns:
A reference to a com.esri.arcgis.system.ISet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createErrorTable

public void createErrorTable(String name,
                             ITable[] errorTable)
                      throws IOException,
                             AutomationException
Creates a non-versioned table that can be used to persist error information.

Description

The CreateErrorTable method is used to create a table that can be used to persist information related to inconsistent network features (using a fixed table schema) with the specified name. Such network error information can only be persisted by the geometric network in a table with this schema. This table is user managed and should remain unversioned.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
createErrorTable in interface IGeometricNetworkErrorDetection
Parameters:
name - The name (in)
errorTable - A reference to a com.esri.arcgis.geodatabase.ITable (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

detectNetworkErrors

public void detectNetworkErrors(int errorType,
                                IEnvelope areaOfInterest,
                                ISet selectionSets,
                                ISet[] problemSelectionSets)
                         throws IOException,
                                AutomationException
The features in the geometric network with connectivity problems.

Description

The DetectNetworkErrors method is used to detect the different possible types of network connectivity and geometry problems. While the DetectNetworkErrors method will discover network features with inconsistent connectivity, it does not perform an exhaustive verification. The IGeometricNetworkConnectivity2::CheckandRepairConnectivity method performs a more exhaustive check for network inconsistencies.

The DetectNetworkErrors method takes a number of arguements, the first being the type of network error to detect. This arguement corresponds with a value from the esriNetworkErrorType enumeration. Use esriNETConnectivity to verify network connectivity and esriNETGeometry to verify network feature geometry.

The second argument is an IEnvelope object defining the area of interest, any feature within or intersecting the envelope will be verified. The third arguement is a selection set of features. If Nothing is supplied for an area of interest, the features in the selection set will be verified. Finally, any features identified as invalid will be returned in a selection set.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
detectNetworkErrors in interface IGeometricNetworkErrorDetection
Parameters:
errorType - A com.esri.arcgis.geodatabase.esriNetworkErrorType constant (in)
areaOfInterest - A reference to a com.esri.arcgis.geometry.IEnvelope (in)
selectionSets - A reference to a com.esri.arcgis.system.ISet (in)
problemSelectionSets - A reference to a com.esri.arcgis.system.ISet (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

deleteNetworkElements

public void deleteNetworkElements(ISet selectionSets)
                           throws IOException,
                                  AutomationException
Deletes the network elements associated with the specified network features.

Description

The DeleteNetworkElements method takes an ISet of ISelectionSets. All of the network features contained in the various selection sets will have their network elements deleted from the logical network. The primary reason why one would want to do this is to correct the geometry of an edge feature that was loaded with invalid polyline geometry. This method should be called on valid network features.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
deleteNetworkElements in interface IGeometricNetworkErrorDetection
Parameters:
selectionSets - A reference to a com.esri.arcgis.system.ISet (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.