com.esri.arcgis.geodatabase
Interface IEdgeFeature

All Superinterfaces:

java.io.Serializable

All Known Implementing Classes:

ComplexEdgeFeature, IEdgeFeatureProxy, SimpleEdgeFeature

public interface IEdgeFeature

extends java.io.Serializable

Provides access to members that modify and return information about an edge feature.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Remarks

Use the IEdgeFeature interface to get information about an edge feature as well as to disconnect an edge feature from a geometric network. The IEdgeFeature interface should not be used as a means to traverse the network. IEdgeFeature should only be used to return the connectivity information for features connected to the specific edge feature. Using the IEdgeFeature interface to navigate through the network will be extremely slow and cumbersome. For traverses through the network use the IForwardStar interface on the Network Object Model.

Method Summary

void	disconnectAtEndpoint(int eID, int fromEID, int toEID, boolean disconnectFrom, boolean disconnectTo) Perform the disconnection at either or both of the endpoint.
void	disconnectAtJunction(int eID, int junctionEID) Perform the disconnection at the specified junction.
int	getFromJunctionEID() The junction element EID that corresponds to the from endpoint.
IJunctionFeature	getFromJunctionFeature() The junction that corresponds to the from endpoint.
IEnumNetEID	getFromToJunctionEIDs() The FROM and TO junction element EIDs (the first is the FROM, the second is the TO).
IGeometry	getGeometryForEdgeElement(int subID) The geometry corresponding to the element with the given subID.
int	getToJunctionEID() The junction element EID that corresponds to the to endpoint.
IJunctionFeature	getToJunctionFeature() The junction that corresponds to the to endpoint.
void	update(INetworkFeature callingFeature, IPoint oldJunctionLocation, IPoint newJunctionLocation, ISet rigidEdges, ITransformGroup group) Programmatic update of the NetworkFeature.

Method Detail

disconnectAtEndpoint

public void disconnectAtEndpoint(int eID,
                                 int fromEID,
                                 int toEID,
                                 boolean disconnectFrom,
                                 boolean disconnectTo)
                          throws java.io.IOException,
                                 AutomationException

Perform the disconnection at either or both of the endpoint.

Supported Platforms

Windows, Solaris, Linux

Remarks

All edits to features that participate in a Topology or Geometric Network must be performed within an edit session and bracketed within an edit operation.

Parameters:

eID - The eID (in)

fromEID - The fromEID (in)

toEID - The toEID (in)

disconnectFrom - The disconnectFrom (in)

disconnectTo - The disconnectTo (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

disconnectAtJunction

public void disconnectAtJunction(int eID,
                                 int junctionEID)
                          throws java.io.IOException,
                                 AutomationException

Perform the disconnection at the specified junction.

Supported Platforms

Windows, Solaris, Linux

Remarks

All edits to features that participate in a Topology or Geometric Network must be performed within an edit session and bracketed within an edit operation.

Parameters:

eID - The eID (in)

junctionEID - The junctionEID (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getGeometryForEdgeElement

public IGeometry getGeometryForEdgeElement(int subID)
                                    throws java.io.IOException,
                                           AutomationException

The geometry corresponding to the element with the given subID.

Supported Platforms

Windows, Solaris, Linux

Remarks

Simple edge features have one corresponding logical network element and therefore one SubID value. When using GeometryForEdgeElement with simple edge features, the SubID parameter is still required but can be any number, positive, negative or zero. The geometry for the simple edge feature will always be returned.

Complex edge features have a one feature to many elements mapping with the logical network. As such, a valid SubID must be supplied. The SubID for a complex edge feature can be returned by supplying the elements ID to the INetElements::QueryIDs method.

Parameters:

subID - The subID (in)

Returns:

A reference to a com.esri.arcgis.geometry.IGeometry

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFromJunctionEID

public int getFromJunctionEID()
                       throws java.io.IOException,
                              AutomationException

The junction element EID that corresponds to the from endpoint.

Supported Platforms

Windows, Solaris, Linux

Returns:

The eID

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFromJunctionFeature

public IJunctionFeature getFromJunctionFeature()
                                        throws java.io.IOException,
                                               AutomationException

The junction that corresponds to the from endpoint.

Supported Platforms

Windows, Solaris, Linux

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getToJunctionEID

public int getToJunctionEID()
                     throws java.io.IOException,
                            AutomationException

The junction element EID that corresponds to the to endpoint.

Supported Platforms

Windows, Solaris, Linux

Returns:

The eID

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getToJunctionFeature

public IJunctionFeature getToJunctionFeature()
                                      throws java.io.IOException,
                                             AutomationException

The junction that corresponds to the to endpoint.

Supported Platforms

Windows, Solaris, Linux

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFromToJunctionEIDs

public IEnumNetEID getFromToJunctionEIDs()
                                  throws java.io.IOException,
                                         AutomationException

The FROM and TO junction element EIDs (the first is the FROM, the second is the TO).

Supported Platforms

Windows, Solaris, Linux

Remarks

The FromToJunctionEIDs property hands back both the FROM and TO junction EIDs; it is more efficient to access this property than to call FromJunctionEID and ToJunctionEID.

It is important to note that these properties are generally computationally expensive.

Returns:

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

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

update

public void update(INetworkFeature callingFeature,
                   IPoint oldJunctionLocation,
                   IPoint newJunctionLocation,
                   ISet rigidEdges,
                   ITransformGroup group)
            throws java.io.IOException,
                   AutomationException

Programmatic update of the NetworkFeature.

Supported Platforms

Windows, Solaris, Linux

Remarks

The Update method is reserved for internal use during the process of updating the shape and storing the result. There is no need for clients to directly call this method.

Parameters:

callingFeature - A reference to a com.esri.arcgis.geodatabase.INetworkFeature (in)

oldJunctionLocation - A reference to a com.esri.arcgis.geometry.IPoint (in)

newJunctionLocation - A reference to a com.esri.arcgis.geometry.IPoint (in)

rigidEdges - A reference to a com.esri.arcgis.system.ISet (in)

group - A reference to a com.esri.arcgis.geodatabase.ITransformGroup (in)

Throws:

java.io.IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.