com.esri.arcgis.geodatabase
Class ITopologyRuleContainerProxy

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

public class ITopologyRuleContainerProxy
extends com.esri.arcgis.interop.Dispatch
implements ITopologyRuleContainer, Serializable

Provides access to members that return and set topology rules.

Remarks

The ITopologyRuleContainer interface provides access to members for adding, removing and returning topology rules from a topology. This interface also provides access to members that control the promotion and demotion of topology errors and exceptions.

Product Availability

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

See Also:
ITopologyRule, 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
  ITopologyRuleContainerProxy()
           
  ITopologyRuleContainerProxy(Object obj)
           
protected ITopologyRuleContainerProxy(Object obj, String iid)
           
 
Method Summary
 void addListener(String iidStr, Object theListener, Object theSource)
           
 void addRule(ITopologyRule rule)
          Adds a topology rule.
 void deleteRule(ITopologyRule rule)
          Deletes a topology rule.
 void demoteFromRuleException(ITopologyErrorFeature errorException)
          Demotes a topology error from an exception to an error.
 IRule getRule(int ruleID)
          The topology rule with the corresponding ID.
 IRule getRuleByGUID(String gUID)
          The rule with the globally unique ID.
 IEnumRule getRules()
          An enumeration of all the topology rules.
 IEnumRule getRulesByClass(int classID)
          An enumeration of all the rules for a given class.
 IEnumRule getRulesByClassAndSubtype(int classID, int subType)
          An enumeration of all the rules for a given class and subtype.
 boolean isCanAddRule(ITopologyRule rule)
          Indicates if the topology rule can be added to the topology.
 void promoteToRuleException(ITopologyErrorFeature errorException)
          Promotes a topology error to an exception.
 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

ITopologyRuleContainerProxy

public ITopologyRuleContainerProxy()

ITopologyRuleContainerProxy

public ITopologyRuleContainerProxy(Object obj)
                            throws IOException
Throws:
IOException

ITopologyRuleContainerProxy

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

getRule

public IRule getRule(int ruleID)
              throws IOException,
                     AutomationException
The topology rule with the corresponding ID.

Product Availability

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

Specified by:
getRule in interface ITopologyRuleContainer
Parameters:
ruleID - The ruleID (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IRule
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRules

public IEnumRule getRules()
                   throws IOException,
                          AutomationException
An enumeration of all the topology rules.

Remarks

Returns an enumerator of the topology rules associated with the topology. The enumerator will contain all rules defined for the Topology, but will not contain the one rule that is inherent to each Topology, the esriTRTFeatureLargerThanClusterTolerance rule.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getRuleByGUID

public IRule getRuleByGUID(String gUID)
                    throws IOException,
                           AutomationException
The rule with the globally unique ID.

Product Availability

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

Specified by:
getRuleByGUID in interface ITopologyRuleContainer
Parameters:
gUID - The gUID (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IRule
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRulesByClass

public IEnumRule getRulesByClass(int classID)
                          throws IOException,
                                 AutomationException
An enumeration of all the rules for a given class.

Product Availability

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

Specified by:
getRulesByClass in interface ITopologyRuleContainer
Parameters:
classID - The classID (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IEnumRule
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRulesByClassAndSubtype

public IEnumRule getRulesByClassAndSubtype(int classID,
                                           int subType)
                                    throws IOException,
                                           AutomationException
An enumeration of all the rules for a given class and subtype.

Product Availability

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

Specified by:
getRulesByClassAndSubtype in interface ITopologyRuleContainer
Parameters:
classID - The classID (in)
subType - The subType (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IEnumRule
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isCanAddRule

public boolean isCanAddRule(ITopologyRule rule)
                     throws IOException,
                            AutomationException
Indicates if the topology rule can be added to the topology.

Product Availability

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

Specified by:
isCanAddRule in interface ITopologyRuleContainer
Parameters:
rule - A reference to a com.esri.arcgis.geodatabase.ITopologyRule (in)
Returns:
The canAddRule
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addRule

public void addRule(ITopologyRule rule)
             throws IOException,
                    AutomationException
Adds a topology rule.

Remarks

Adds the specified rule to the topology. Before adding the topology rule use CanAddRule to determine if the rule is inconsistent with any existing topology rules. Topology rules of the same type cannot be specified at the class level and subtype level for the same feature class.

Using AddRule on a topology which has already been validated, in whole or in part, will result in a dirty area created for the extent of the feature classes participating in the rule and a change to the state of the topology to esriTSUnanalyzed.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

deleteRule

public void deleteRule(ITopologyRule rule)
                throws IOException,
                       AutomationException
Deletes a topology rule.

Remarks

Removes the specified rule from the topology. DeleteRule will remove any associated topology errors and will not result in the creation of a dirty area, nor will the state of the topology change.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

promoteToRuleException

public void promoteToRuleException(ITopologyErrorFeature errorException)
                            throws IOException,
                                   AutomationException
Promotes a topology error to an exception.

Remarks

The PromoteToRuleException method will promote the specified error to an exception feature. On a topology in an ArcSDE geodatabase, PromoteToRuleException, must be called from within an edit session and edit operation. Topology Exceptions arise when a topology rule is purposefully violated. Marking purposeful topology errors as exceptions allows other clients of the topology to handle them in an appropriate or specific manner, e.g., in reporting or symbolization.

Note that it is also possible to demote an exception or mark the exception as an error with the ITopologyRuleContainer::DemoteFromRuleException method.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

demoteFromRuleException

public void demoteFromRuleException(ITopologyErrorFeature errorException)
                             throws IOException,
                                    AutomationException
Demotes a topology error from an exception to an error.

Remarks

The DemoteFromRuleException method will demote an exception feature from an exception to an error. On a topology in an ArcSDE geodatabase, DemoteFromRuleException, must be called from within an edit session and edit operation. Topology Exceptions arise when a topology rule is purposefully violated. Marking purposeful topology errors as exceptions allows other clients of the topology to handle them in an appropriate or specific manner, e.g., in reporting or symbolization.

Note that it is also possible to promote an error or mark the error as an exception with the ITopologyRuleContainer::PromoteToRuleException method.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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