com.esri.arcgis.geodatabase
Class INetTopologyEditProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.geodatabase.INetTopologyProxy
          extended by com.esri.arcgis.geodatabase.INetTopologyEditProxy
All Implemented Interfaces:
INetTopology, INetTopologyEdit, Externalizable, Serializable

public class INetTopologyEditProxy
extends INetTopologyProxy
implements INetTopologyEdit, Serializable

Provides access to members that add and delete network elements from the logical network.

When To Use

Use the INetTopologyEdit interface to add and delete elements from a logical network.

This interface is designed specifically for the editing of a stand-alone logical network, a logical network that does not have an associated geometric network. It is imperative that if you have a geometric network, the logical network must be edited through its associated geometric network. You risk data corruption if you use the INetTopologyEdit interface on logical networks that have an associated geometric network. When a feature is created or removed in the geometric network, the corresponding element in the logical network is added or deleted as well.

The logical network maintains its own topology for the purpose of faster access. Directly manipulating the logical network's topology will cause the features in the geometric network to be out of sync with the topology maintained by the logical network.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

See Also:
INetTopologyEdit,

Not all members are callable from Java. Please use INetTopologyEditGEN instead.

, Serialized Form

Field Summary
 
Fields inherited from class com.esri.arcgis.interop.Dispatch
DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, E
 
Constructor Summary
  INetTopologyEditProxy()
           
  INetTopologyEditProxy(Object obj)
           
protected INetTopologyEditProxy(Object obj, String iid)
           
 
Method Summary
 int addEdgeByEndEIDs(INetElementDescription edgeDescription, int fromJunctionEID, int toJunctionEID)
          Adds an edge element to the logical network between the specified junction elements.
 int addJunction(INetElementDescription junctionDescription)
          Adds a junction element to the logical network.
 void addListener(String iidStr, Object theListener, Object theSource)
           
 void deleteByEID(int eID, int elementType)
          Deletes the specified network element from the logical network.
 void deleteByEIDs(int elementType, int elementCount, int[] elementEIDs)
          Deletes the specified network elements from the logical network.
 void deleteByID(int userClassID, int userID, int userSubID, int elementType)
          Deletes the specified network element from the logical network.
 void readExternal(ObjectInput in)
           
 void removeListener(String iidStr, Object theListener)
           
 void writeExternal(ObjectOutput out)
           
 
Methods inherited from class com.esri.arcgis.geodatabase.INetTopologyProxy
getAdjacentEdge, getAdjacentEdgeCount, getAdjacentEdges, getFromToJunctionEIDs
 
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, queryInterface, release, setNativeMode, setPropertyByName, toString, vtblInvoke
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.esri.arcgis.geodatabase.INetTopology
getAdjacentEdge, getAdjacentEdgeCount, getAdjacentEdges, getFromToJunctionEIDs
 

Constructor Detail

INetTopologyEditProxy

public INetTopologyEditProxy()

INetTopologyEditProxy

public INetTopologyEditProxy(Object obj)
                      throws IOException
Throws:
IOException

INetTopologyEditProxy

protected INetTopologyEditProxy(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 INetTopologyProxy
Throws:
IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException
Overrides:
removeListener in class INetTopologyProxy
Throws:
IOException

addJunction

public int addJunction(INetElementDescription junctionDescription)
                throws IOException,
                       AutomationException
Adds a junction element to the logical network.

Remarks

The value returned by AddJunction is the Element ID (EID) for the newly created junction. This value is unique.

Unlike edges, a junction can exist in a logical network without attachment to any edges. When a junction exits in this state (once it has been created using this function call), it is not connected to any other portion of the network, but may have edges connected to it so that it will be part of the network.

Only use this method on stand-alone logical networks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
addJunction in interface INetTopologyEdit
Parameters:
junctionDescription - A reference to a com.esri.arcgis.geodatabase.INetElementDescription (in)
Returns:
The junctionEID
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addEdgeByEndEIDs

public int addEdgeByEndEIDs(INetElementDescription edgeDescription,
                            int fromJunctionEID,
                            int toJunctionEID)
                     throws IOException,
                            AutomationException
Adds an edge element to the logical network between the specified junction elements.

Remarks

AddEdgeByEndEIDs adds a new edge between the specified junctions. The value returned by AddEdgeByEndEIDs is the Element ID (EID) for the newly created edge. This value is unique.

Define the parameters of the edge to add in the INetElementDescription object that you pass in.

Only use this method on stand-alone logical networks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
addEdgeByEndEIDs in interface INetTopologyEdit
Parameters:
edgeDescription - A reference to a com.esri.arcgis.geodatabase.INetElementDescription (in)
fromJunctionEID - The fromJunctionEID (in)
toJunctionEID - The toJunctionEID (in)
Returns:
The edgeEID
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

deleteByID

public void deleteByID(int userClassID,
                       int userID,
                       int userSubID,
                       int elementType)
                throws IOException,
                       AutomationException
Deletes the specified network element from the logical network.

Remarks

DeleteByID removes the specified feature from the network. Only use this method to remove elements from stand-alone logical networks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
deleteByID in interface INetTopologyEdit
Parameters:
userClassID - The userClassID (in)
userID - The userID (in)
userSubID - The userSubID (in)
elementType - A com.esri.arcgis.geodatabase.esriElementType constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

deleteByEID

public void deleteByEID(int eID,
                        int elementType)
                 throws IOException,
                        AutomationException
Deletes the specified network element from the logical network.

Remarks

DeleteByEID removes the specified element from the network. Only use this method on a stand-alone logical network.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
deleteByEID in interface INetTopologyEdit
Parameters:
eID - The eID (in)
elementType - A com.esri.arcgis.geodatabase.esriElementType constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

deleteByEIDs

public void deleteByEIDs(int elementType,
                         int elementCount,
                         int[] elementEIDs)
                  throws IOException,
                         AutomationException
Deletes the specified network elements from the logical network.

Remarks

DeleteByEIDs removes the specified array of elements from the network.

When using this method in VisualBasic code, specify the number of elements in your array, but only pass the first element of the array (pArray(0), for instance). Even though just the first element is passed, all elements in the array will be removed from the network.

Only use this method on stand-alone logical networks.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

This method is not callable from Java. Please use INetTopologyEditGEN::DeleteByEIDs.

Specified by:
deleteByEIDs in interface INetTopologyEdit
Parameters:
elementType - A com.esri.arcgis.geodatabase.esriElementType constant (in)
elementCount - The elementCount (in)
elementEIDs - The elementEIDs (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException
Specified by:
writeExternal in interface Externalizable
Overrides:
writeExternal in class INetTopologyProxy
Throws:
IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException
Specified by:
readExternal in interface Externalizable
Overrides:
readExternal in class INetTopologyProxy
Throws:
IOException
ClassNotFoundException