com.esri.arcgis.geodatabasedistributed
Class VersionDataChanges

java.lang.Object
  extended by com.esri.arcgis.geodatabasedistributed.VersionDataChanges
All Implemented Interfaces:
IDataChanges, IDataChangesInfo, IVersionDataChangesInit, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class VersionDataChanges
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IDataChanges, IVersionDataChangesInit, IDataChangesInfo

The information needed to export modified rows in versions to a delta file.

Remarks

This class returns edits between source and target versions. It is used by the DataChangesExporter coclass to export the edits to a delta file.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

See Also:
DataChangesExporter, DataChanges, IExportDataChanges, Serialized Form

Constructor Summary
VersionDataChanges()
          Constructs a VersionDataChanges using ArcGIS Engine.
VersionDataChanges(Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
VersionDataChanges theVersionDataChanges = (VersionDataChanges) obj;
 
Method Summary
 boolean equals(Object o)
          Compare this object with another
 IDifferenceCursor extract(String tableName, int changeType)
          Lists the edits in each feature class or table.
 IFIDSet getChangedIDs(String className, int diffType)
          IDs of rows that changed between two versions.
static String getClsid()
          getClsid.
 IEnumModifiedClassInfo getModifiedClassesInfo()
          Returns an enumeration listing of the feature classes and tables with edits.
 int getParentReplicaID()
          ID for the replica in the parent geodatabase.
 IWorkspaceName getParentWorkspaceName()
          Workspace of the master geodatabase.
 String getReplicaGuid()
          GUID identifying the child/parent replica pair.
 int hashCode()
          the hashcode for this object
 void init(IWorkspaceName sourceVersionedWorkspace, IWorkspaceName targetVersionedWorkspace)
          Initializes the class by setting the versioned workspace and one of its ancestor versioned workspace.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef
getJintegraDispatch, release
 

Constructor Detail

VersionDataChanges

public VersionDataChanges()
                   throws IOException,
                          UnknownHostException
Constructs a VersionDataChanges using ArcGIS Engine.

Throws:
IOException - if there are interop problems
UnknownHostException - if there are interop problems

VersionDataChanges

public VersionDataChanges(Object obj)
                   throws IOException
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
VersionDataChanges theVersionDataChanges = (VersionDataChanges) obj;

Construct a VersionDataChanges using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to VersionDataChanges.

Parameters:
obj - an object returned from ArcGIS Engine or Server
Throws:
IOException - if there are interop problems
Method Detail

getClsid

public static String getClsid()
getClsid.


equals

public boolean equals(Object o)
Compare this object with another

Overrides:
equals in class Object

hashCode

public int hashCode()
the hashcode for this object

Overrides:
hashCode in class Object

getModifiedClassesInfo

public IEnumModifiedClassInfo getModifiedClassesInfo()
                                              throws IOException,
                                                     AutomationException
Returns an enumeration listing of the feature classes and tables with edits.

Remarks

The GetModifiedClassesInfo method returns an enumeration of the datasets that have been edited. For replicas (check-out replicas, two way and one way replicas), datasets that have been replicated but not edited are not included.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getModifiedClassesInfo in interface IDataChanges
Returns:
A reference to a com.esri.arcgis.geodatabasedistributed.IEnumModifiedClassInfo
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

extract

public IDifferenceCursor extract(String tableName,
                                 int changeType)
                          throws IOException,
                                 AutomationException
Lists the edits in each feature class or table.

Remarks

The Extract method returns a difference cursor of the rows inserted, updated or deleted. The tablename can be any class that implements ITableName such as a feature class name, table name or attributed relationship class name. The changeType enumeration is used to specify the type of changes to return.

If using this interface with a DeltaDataChanges coclass, initializing the coclass with random access may be significant. See DeltaDataChanges::IDeltaDataChangesInit2 for more information.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
extract in interface IDataChanges
Parameters:
tableName - The tableName (in)
changeType - A com.esri.arcgis.geodatabasedistributed.esriDataChangeType constant (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.

getParentWorkspaceName

public IWorkspaceName getParentWorkspaceName()
                                      throws IOException,
                                             AutomationException
Workspace of the master geodatabase.

Remarks

The ParentWorkspaceName property returns the workspace name of the parent geodatabase. This property is only valid for CheckoutDataChanges coclasses, DeltaDataChanges coclasses, and ReplicationDataChanges initialized using delta databases (mdb file) or delta file geodatabases (gdb file). A delta XML file does not store this information.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getParentReplicaID

public int getParentReplicaID()
                       throws IOException,
                              AutomationException
ID for the replica in the parent geodatabase.

Remarks

This property returns the parent replica ID.

The ParentReplicaID and ReplicaGUID properties identify the replica on the parent geodatabase. These properties are only valid for the CheckoutDataChanges coclass, DeltaDataChanges coclass, and the ReplicationDataChanges coclass when initialized for a replica. Both properties can be used to identify the replica, however, ReplicaGUID is unique across all databases.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getParentReplicaID in interface IDataChanges
Returns:
The parentReplicaID
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getReplicaGuid

public String getReplicaGuid()
                      throws IOException,
                             AutomationException
GUID identifying the child/parent replica pair.

Remarks

This property returns the replica's GUID.

The ParentReplicaID and ReplicaGUID properties identify the replica on the parent geodatabase. These properties are only valid for the CheckoutDataChanges coclass, DeltaDataChanges coclass, and the ReplicationDataChanges coclass when initialized for a replica. Both properties can be used to identify the replica, however, ReplicaGUID is unique across all databases.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getReplicaGuid in interface IDataChanges
Returns:
The replicaGuid
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

init

public void init(IWorkspaceName sourceVersionedWorkspace,
                 IWorkspaceName targetVersionedWorkspace)
          throws IOException,
                 AutomationException
Initializes the class by setting the versioned workspace and one of its ancestor versioned workspace.

Remarks

This interface Init method is used to initialize a VersionDataChanges coclass. This coclass can be used to get the edits between a source version and a target version.

The SourceVersionedWorkspace parameter is the WorkspaceName object that references the source version. The TargetVersionedWorkspace parameter is the WorkspaceName object that references the target version.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
init in interface IVersionDataChangesInit
Parameters:
sourceVersionedWorkspace - A reference to a com.esri.arcgis.geodatabase.IWorkspaceName (in)
targetVersionedWorkspace - A reference to a com.esri.arcgis.geodatabase.IWorkspaceName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
DataChangesExporter, DataChanges, IExportDataChanges

getChangedIDs

public IFIDSet getChangedIDs(String className,
                             int diffType)
                      throws IOException,
                             AutomationException
IDs of rows that changed between two versions.

Product Availability

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

Specified by:
getChangedIDs in interface IDataChangesInfo
Parameters:
className - The className (in)
diffType - A com.esri.arcgis.geodatabasedistributed.esriDataChangeType constant (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IFIDSet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.