com.esri.arcgis.geodatabase
Class IVersionedTableProxy

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

public class IVersionedTableProxy
extends com.esri.arcgis.interop.Dispatch
implements IVersionedTable, Serializable

Provides access to methods that apply to versioned tables.

Description

The IVersionedTable interface can be used to detect the different conflict categories without first performing an IVersionEdit.Reconcile. By specifying the appropriate esriDifferenceType, such as TypeDeleteUpdate or TypeInsert, an IDifferenceCursor is returned with a set of OIDs and IRows for differences.

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
  IVersionedTableProxy()
           
  IVersionedTableProxy(Object obj)
           
protected IVersionedTableProxy(Object obj, String iid)
           
 
Method Summary
 void addListener(String iidStr, Object theListener, Object theSource)
           
 IDifferenceCursor differences(ITable differenceTable, int differenceType, IQueryFilter queryFilter)
          Returns an object cursor that can be used to retrieve rows by difference type.
 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

IVersionedTableProxy

public IVersionedTableProxy()

IVersionedTableProxy

public IVersionedTableProxy(Object obj)
                     throws IOException
Throws:
IOException

IVersionedTableProxy

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

differences

public IDifferenceCursor differences(ITable differenceTable,
                                     int differenceType,
                                     IQueryFilter queryFilter)
                              throws IOException,
                                     AutomationException
Returns an object cursor that can be used to retrieve rows by difference type.

Remarks

The Differences method returns a cursor that can be used to retrieve rows based on the specified difference type. Differences can be obtained for either transactional or historical versions.

If both transactional versions reference the same database state or both historical versions reference the same database moment empty result sets will be returned for all difference types. This implies that the two transactional or historical versions are identical. It is important to keep in mind that if connecting to a SDE instance earlier than ArcSDE 9.1 this case will return the FDO_E_SE_STATES_ARE_SAME error.

The IQueryFilter object is fully supported. When used with transactional versions and the difference types esriDifferenceTypeDeleteUpdate or esriDifferenceTypeDeleteNoChange the query filter (spatial or attribute) is applied against the target versioned table (where the row exists). For all other difference types the query filter is applied to the source versioned table.

If the objective is to detect all changes (inserts, updates and deletes) for a version based upon a query filter, then the target versioned table should be opened from the common ancestor version using IVersion2::GetCommonAncestor. The common ancestor version is the representation of the table when the source version was first created or last reconciled with the target version. This will ensure the results are all the rows which meet the definition of the query filter.

For example, if one needed to detect the changes which occurred within a municipal boundary one could either use the versioned table from the target version or the common ancestor version. If using the target version and a feature was deleted in the source version and updated in the target version, but moved outside the municipal boundary the feature would not be returned by the difference cursor. But, if the target versioned table was opened using the common ancestor version, the feature would be returned by the difference cursor because the deleted feature does exist within the municipal boundary.

When detecting differences for historical versions only, the difference types esriDifferenceTypeInsert, esriDifferenceTypeUpdateNoChange and esriDifferenceTypeDeleteNoChange are supported between two moments (since conflicts can not exist), if any other difference type is specified the error E_INVALIDARG is returned.

If finding differences between moments in time the two input versioned tables must be opened from historical versions or FDO_E_VERSION_NOT_HISTORICAL is returned. If the versioned table is not archive enabled FDO_E_TABLE_NOT_ARCHIVING is returned. When using historical versions the differences table must be a versioned table opened from a historical version whose moment is less than the moment of the source historical version or empty result sets are returned.

The same can also be said for transactional differences. If finding transactional differences the two input versioned tables must be opened from transactional versions.

IRow objects returned from a difference cursor are meant to be a read only. If row editing is desired the OID returned from the call to IDifferenceCursor::NextRow should be used in a call to the ITable::GetRow or ITable::GetRows methods.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
differences in interface IVersionedTable
Parameters:
differenceTable - A reference to a com.esri.arcgis.geodatabase.ITable (in)
differenceType - A com.esri.arcgis.geodatabase.esriDifferenceType constant (in)
queryFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IDifferenceCursor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.