com.esri.arcgis.geodatabasedistributed
Class ReplicationDataChanges

java.lang.Object
  extended by 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.