com.esri.arcgis.geodatabasedistributed
Class DataChanges

java.lang.Object
  com.esri.arcgis.geodatabasedistributed.DataChanges

All Implemented Interfaces:

IDataChanges, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class DataChanges
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IDataChanges

The edits in check-outs, modified rows in versions or edits in a delta file.

Remarks

The DataChanges class provides methods used by inherited classes to return edits. The inherited class defines the source of the edits. The source can be a check-out database (CheckoutDataChanges), a replica geodatabase (ReplicationDataChanges), modified rows between source and target versions (VersionDataChanges), a delta file (DeltaDataChanges) or changes within tables and feature classes (TablesDataChanges). A delta file can be generated from the DataChangesExporter or a custom application.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

See Also:

Serialized Form

Constructor Summary

DataChanges(Object obj)
Construct a DataChanges using a reference to such an object returned from ArcGIS Engine or Server.

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.
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

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

DataChanges

public DataChanges(Object obj)
            throws IOException

Construct a DataChanges using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to DataChanges.
Casting to this class from the return value of a method will not work, as this class represents an abstract class in ArcObjects.
*
DataChanges o = (DataChanges)obj; // will not work

DataChanges o = new DataChanges(obj); // Use this constructor instead
* @param obj an object returned from ArcGIS Engine or Server

Throws:

IOException - if there are interop problems DataChanges theDataChanges = (DataChanges) obj;

Method Detail

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.