com.esri.arcgis.geodatabasedistributed
Class ReplicationDataChanges

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

All Implemented Interfaces:

IDataChanges, IDataChanges2, IDataChanges3, IReplicaDataChanges, IReplicaDataChangesInit, IReplicaDataChangesInit2, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class ReplicationDataChanges
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IDataChanges3, IReplicaDataChangesInit, IReplicaDataChangesInit2, IReplicaDataChanges

The replicadatachanges object.

Remarks

This ReplicationDataChanges coClass is used during replica synchronize to get the changes that have been made to the replica geodatabase sending the changes. It is also used by the DataChangesExporter coClass to export edits to a delta file. This class can only be used on replica geodatabases.

Product Availability

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

See Also:

Serialized Form

Constructor Summary

ReplicationDataChanges()
Constructs a ReplicationDataChanges using ArcGIS Engine.

ReplicationDataChanges(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ReplicationDataChanges theReplicationDataChanges = (ReplicationDataChanges) 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.
int	getChangesModelType() Geodabase model type, simple or full.
static String	getClsid() getClsid.
void	getGenerationNumbers(int[] sourceGenBegin, int[] sourceGenEnd, int[] targetGen) Source and target generation numbers for replica.
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	getReplicaState() The state of the replica that is the source of the data changes.
IWorkspace	getWorkspace() The workspace holding the replica from which the changes are being reported.
int	hashCode() the hashcode for this object
void	init(IReplica replica, IWorkspaceName checkoutWorkspace) Initializes the class by using the replica and the replica workspace.
void	init2(IReplica replica, IWorkspaceName checkoutWorkspace, int genOption) Initializes the class by using the replica, generation option and the replica 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

ReplicationDataChanges

public ReplicationDataChanges()
                       throws IOException,
                              UnknownHostException

Constructs a ReplicationDataChanges using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

ReplicationDataChanges

public ReplicationDataChanges(Object obj)
                       throws IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ReplicationDataChanges theReplicationDataChanges = (ReplicationDataChanges) obj;

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

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

getGenerationNumbers

public void getGenerationNumbers(int[] sourceGenBegin,
                                 int[] sourceGenEnd,
                                 int[] targetGen)
                          throws IOException,
                                 AutomationException

Source and target generation numbers for replica.

Product Availability

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

Specified by:

getGenerationNumbers in interface IDataChanges3

Parameters:

sourceGenBegin - The sourceGenBegin (out: use single element array)

sourceGenEnd - The sourceGenEnd (out: use single element array)

targetGen - The targetGen (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getReplicaState

public int getReplicaState()
                    throws IOException,
                           AutomationException

The state of the replica that is the source of the data changes.

Remarks

Returns the replica state which is the source of the data changes. The replica can be in a sending data state, sending acknowledgement state, or a waiting for data state. See the esriReplicaState enumeration for more information.

Product Availability

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

Specified by:

getReplicaState in interface IDataChanges3

Returns:

A com.esri.arcgis.geodatabase.esriReplicaState constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getChangesModelType

public int getChangesModelType()
                        throws IOException,
                               AutomationException

Geodabase model type, simple or full.

Remarks

Returns the model type of delta file or a replica.

A full model type delta file indicates that all reactive geodatabase behavior was executed at edit time.

A simple model type delta file assumes that the edits were not made by a reactive geodatabase editor.

See the DataChangesExporter coclass for more information on delta files. A check-out is always a full model type.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getChangesModelType in interface IDataChanges2

Returns:

A com.esri.arcgis.geodatabase.esriReplicaModelType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

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(IReplica replica,
                 IWorkspaceName checkoutWorkspace)
          throws IOException,
                 AutomationException

Initializes the class by using the replica and the replica workspace.

Remarks

The init method takes a checkoutWorkspace and a Replica. See IWorkspaceReplicas to see how to get a replica object.

This method is used to initialize replication data changes for check-out replicas. To initialize replication data changes for two way or one way replicas use the IReplicaDataChangesInit2::Init2 method.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

init in interface IReplicaDataChangesInit

Parameters:

replica - A reference to a com.esri.arcgis.geodatabase.IReplica (in)

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

init2

public void init2(IReplica replica,
                  IWorkspaceName checkoutWorkspace,
                  int genOption)
           throws IOException,
                  AutomationException

Initializes the class by using the replica, generation option and the replica workspace.

Remarks

This method is used to initialize replication data changes for two way or one way replicas. To initialize replication data changes for check-outs use the IReplicaDataChangesInit::Init method.

The init2 method takes a replica geodatabase, a Replica, and a GenOption. The Replica defines the replica from which to export the data changes. See IWorkspaceReplicas to see how to get a replica object. See the esriExportGenerationsOption enumeration for more information.

The GenOption parameter uses the esriExportGenerationsOption enumeration to specify what data changes to export. You may choose to export only unacknowledged data change, new data changes, all data changes, or no data changes. See the esriExportGenerationsOptions enumeration for more information.

Product Availability

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

Specified by:

init2 in interface IReplicaDataChangesInit2

Parameters:

replica - A reference to a com.esri.arcgis.geodatabase.IReplica (in)

checkoutWorkspace - A reference to a com.esri.arcgis.geodatabase.IWorkspaceName (in)

genOption - A com.esri.arcgis.geodatabasedistributed.esriExportGenerationsOption constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getWorkspace

public IWorkspace getWorkspace()
                        throws IOException,
                               AutomationException

The workspace holding the replica from which the changes are being reported.

Remarks

Returns a workspace object which references the replica geodatabase that is the source of the changes.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getWorkspace in interface IReplicaDataChanges

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.