com.esri.arcgis.geodatabasedistributed
Class ReplicationAgent

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

All Implemented Interfaces:

IReplicationAgent, IReplicationAgent2, IReplicationAgentCancelControl, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class ReplicationAgent
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IReplicationAgent, IReplicationAgent2, IReplicationAgentCancelControl

A class used to perform replica operations.

Remarks

The ReplicatonAgent coClass is a software component that can be used to implement replication commands and agents (services). The fundamental unit of replication is a replica pair consisting of a parent replica and a child replica. A ReplicationAgent works with a pair of GeoDataServers. It can be used to create and synchronize replicas within the two GeoDataServers. The ReplicaAgrent also allows you to perform data extration.

If both GeoDataServers are can't be accessed on the same network they are considered disconnected. In this environment, you can perform replication operations by exporting, transporting and importing files. The GeoDataServer class has methods to support these operations.

Product Availability

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

See Also:

Serialized Form

Constructor Summary

ReplicationAgent()
Constructs a ReplicationAgent using ArcGIS Engine.

ReplicationAgent(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ReplicationAgent theReplicationAgent = (ReplicationAgent) obj;

Method Summary

void	addIFeatureProgressListener(IFeatureProgress theListener) addIFeatureProgressListener.
void	createReplica(String versionName, IGeoDataServer srcGDS, IGeoDataServer destGDS, String replicaName, IGPReplicaDescription desc, IGPReplicaOptions repOptions) Creates a replica pair in the workspaces bound to the input geodataservers.
void	createReplica2(String versionName, IGeoDataServer srcGDS, IGeoDataServer destGDS, String replicaName, IGPReplicaDescription desc, IGPReplicaOptions repOptions, String layersFolder) Creates a replica pair and optionally layers in the workspaces bound to the input geodataservers.
boolean	equals(Object o) Compare this object with another
void	extractData(String versionName, IGeoDataServer srcGDS, IGeoDataServer destGDS, IGPReplicaDescription desc) Extracts data from the source geodata server into the destination geodata server.
static String	getClsid() getClsid.
int	hashCode() the hashcode for this object
void	removeIFeatureProgressListener(IFeatureProgress theListener) removeIFeatureProgressListener.
void	setCancelTrackerByRef(ITrackCancel rhs1) The cancel tracker to inspect for user cancellations.
boolean	synchronizeReplica(IGeoDataServer gds1, IGeoDataServer gds2, IGPReplica rep1, IGPReplica rep2, int pol, int dir, boolean columnLevel) Synchronizes a replica pair.

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

ReplicationAgent

public ReplicationAgent()
                 throws IOException,
                        UnknownHostException

Constructs a ReplicationAgent using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

ReplicationAgent

public ReplicationAgent(Object obj)
                 throws IOException

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

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

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

addIFeatureProgressListener

public void addIFeatureProgressListener(IFeatureProgress theListener)
                                 throws IOException

addIFeatureProgressListener. Listen to events generated by this class.

Parameters:

theListener - An object that implements the com.esri.arcgis.geodatabase.IFeatureProgress interface.

Throws:

IOException - If there are communications problems.

removeIFeatureProgressListener

public void removeIFeatureProgressListener(IFeatureProgress theListener)
                                    throws IOException

removeIFeatureProgressListener. Stop listening to events generated by this class.

Parameters:

theListener - An object that implements the com.esri.arcgis.geodatabase.IFeatureProgress interface.

Throws:

IOException - If there are communications problems.

createReplica

public void createReplica(String versionName,
                          IGeoDataServer srcGDS,
                          IGeoDataServer destGDS,
                          String replicaName,
                          IGPReplicaDescription desc,
                          IGPReplicaOptions repOptions)
                   throws IOException,
                          AutomationException

Creates a replica pair in the workspaces bound to the input geodataservers.

Remarks

The IReplicationAgent::CreateReplica method is used to create replicas in a connected environment. This method may be used to create check-out replicas, two way replicas, or one way replicas. To create replicas in a disconnected environement please see the IGeodataserver::CreateReplica method for more information

This method requires two input geodataserver objects,a srcGDS and a destGDS. The replicas will be created in the geodatabases represented by the input geodataserver objects. The srcGDS will host the parent replica, and the destGDS will host the child replica in the replica pair. See the GeoDataServer2 coclass for more information. The ReplicaName is a string that uniquely identifies the replica.

The versionName is the version on the geodatabase represented by the srcGDS from which the replica will be created.

The desc parameter defines the data which will be replicated. See the GPReplicaDescription coclass for more information.

The repOptions parameter defines replica options such as the replica access type. See the GPReplicaOptions coclass for more information.

Product Availability

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

Specified by:

createReplica in interface IReplicationAgent

Parameters:

versionName - The versionName (in)

srcGDS - A reference to a com.esri.arcgis.geodatabasedistributed.IGeoDataServer (in)

destGDS - A reference to a com.esri.arcgis.geodatabasedistributed.IGeoDataServer (in)

replicaName - The replicaName (in)

desc - A reference to a com.esri.arcgis.geodatabase.IGPReplicaDescription (in)

repOptions - A reference to a com.esri.arcgis.geodatabase.IGPReplicaOptions (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

synchronizeReplica

public boolean synchronizeReplica(IGeoDataServer gds1,
                                  IGeoDataServer gds2,
                                  IGPReplica rep1,
                                  IGPReplica rep2,
                                  int pol,
                                  int dir,
                                  boolean columnLevel)
                           throws IOException,
                                  AutomationException

Synchronizes a replica pair.

Remarks

The SynchronizeReplica method provides a way to synchronize changes between a replica pair in a connected environment. This method may be used with check-out replicas, two way replicas, or one way replicas. If you are using replication in a disconnected environment, where the replicas are not on the same network, you must use the IGeoDataServer interface to synchronize changes. Please see the GeoDataServer coclass for more information.

The SynchronizeReplica method requires two input geodataserver objects, gds1 and gds2. One geodataserver must reference the geodatabase with the parent replica and the other the geodatabase with the child replica. The order is not important. For example, if gds1 references the child, gds2 would reference the parent or vice versa.

The rep1 and rep2 parameters take GPReplica objects for the parent and child replicas. See the GPReplica coclass for more information. These parameters must be consistent with the ordering of the geodataserver objects passed in for gds1 and gds2. For example, if gds1 refers to the geodatabase with the parent replica then rep1 must reference the parent replica. The gds2 and rep2 parameters in the same way must then refer to the child replica.

During synchronization, changes are first applied to a synchronization version. For 2 way and 1 way replicas, this version is always reconciled and posted with the replica version. For check-out replicas, you can choose whether or not to reconcile and post. The pol parameter takes an esriReplicationAgentReconilePolicy enumeration value to determine how conflicts will be handled during reconcile. See the esriReplicationAgentReconcilePolicy enumeration for more information. The following describes the meaning of each enumeration:

esriRADetectConflicts -If conflicts occur, the reconcile process is aborted and you must reconcile and post manually after sycnhronization is completed.

esriRAResolveConflictsInFavorOfReplica1 - Automatically reconcile in favor of rep1 if conflicts arrise.

esriRAResolveConflictsInFavorOfReplica2 - Automatically reconcile in favor of rep2 if conflicts arrise.

esriRAResolveConflictsNone - This enumeration has meaning for check-out replicas only. It indicates that a the synchronization version should not be reconciled and post with the replica version during synchronization

The dir parameter takes an esriReplicaSynchronizeDirection enumeration value to define the direction to synchronize the changes. See esriReplicaSynchronizeDirection for more information.

If synchronizing in both directions, the reconcile policy set with the pol parameter will apply to both synchronizations. Therefore you must set the pol parameter to either resolve conflicts in favor of rep1 or resolve in favor of rep2. An error occurs if you specify any other policy when synchronizing in both directions.

Product Availability

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

Specified by:

synchronizeReplica in interface IReplicationAgent

Parameters:

gds1 - A reference to a com.esri.arcgis.geodatabasedistributed.IGeoDataServer (in)

gds2 - A reference to a com.esri.arcgis.geodatabasedistributed.IGeoDataServer (in)

rep1 - A reference to a com.esri.arcgis.geodatabase.IGPReplica (in)

rep2 - A reference to a com.esri.arcgis.geodatabase.IGPReplica (in)

pol - A com.esri.arcgis.geodatabasedistributed.esriReplicationAgentReconcilePolicy constant (in)

dir - A com.esri.arcgis.geodatabasedistributed.esriReplicaSynchronizeDirection constant (in)

columnLevel - The columnLevel (in)

Returns:

The conflictsDetected

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

extractData

public void extractData(String versionName,
                        IGeoDataServer srcGDS,
                        IGeoDataServer destGDS,
                        IGPReplicaDescription desc)
                 throws IOException,
                        AutomationException

Extracts data from the source geodata server into the destination geodata server.

Description

The IReplicationAgent::ExtractData method is used to copy data between geodatabases applying filters to determine the rows to copy.

This method requires two input geodataserver objects, a srcGDS and a destGDS. The srcGDS references the geodatabase that originally contains the data while the destGDS references the geodatabase where the data will be copied.

The desc parameter defines the data which will be extracted. See the GPReplicaDescription coclass for more information.

Product Availability

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

Specified by:

extractData in interface IReplicationAgent

Parameters:

versionName - The versionName (in)

srcGDS - A reference to a com.esri.arcgis.geodatabasedistributed.IGeoDataServer (in)

destGDS - A reference to a com.esri.arcgis.geodatabasedistributed.IGeoDataServer (in)

desc - A reference to a com.esri.arcgis.geodatabase.IGPReplicaDescription (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

createReplica2

public void createReplica2(String versionName,
                           IGeoDataServer srcGDS,
                           IGeoDataServer destGDS,
                           String replicaName,
                           IGPReplicaDescription desc,
                           IGPReplicaOptions repOptions,
                           String layersFolder)
                    throws IOException,
                           AutomationException

Creates a replica pair and optionally layers in the workspaces bound to the input geodataservers.

Remarks

The IReplicationAgent2::CreateReplica2 method is used to create replicas in a connected environment. This method may be used to create check-out replicas, two way replicas, or one way replicas. To create replicas in a disconnected environement please see the IGeodataserver::CreateReplica method for more information

This method requires two input geodataserver objects,a srcGDS and a destGDS. The replicas will be created in the geodatabases represented by the input geodataserver objects. The srcGDS will host the parent replica, and the destGDS will host the child replica in the replica pair. See the GeoDataServer2 coclass for more information. The ReplicaName is a string that uniquely identifies the replica.

The versionName is the version on the geodatabase represented by the srcGDS from which the replica will be created.

The desc parameter defines the data which will be replicated. See the GPReplicaDescription coclass for more information.

The repOptions parameter defines replica options such as the replica access type. See the GPReplicaOptions coclass for more information.

The optional layersFolder parameter defines the location where layer files referencing the destGDS will be created.

Product Availability

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

Specified by:

createReplica2 in interface IReplicationAgent2

Parameters:

versionName - The versionName (in)

srcGDS - A reference to a com.esri.arcgis.geodatabasedistributed.IGeoDataServer (in)

destGDS - A reference to a com.esri.arcgis.geodatabasedistributed.IGeoDataServer (in)

replicaName - The replicaName (in)

desc - A reference to a com.esri.arcgis.geodatabase.IGPReplicaDescription (in)

repOptions - A reference to a com.esri.arcgis.geodatabase.IGPReplicaOptions (in)

layersFolder - The layersFolder (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCancelTrackerByRef

public void setCancelTrackerByRef(ITrackCancel rhs1)
                           throws IOException,
                                  AutomationException

The cancel tracker to inspect for user cancellations.

Remarks

The putref_CancelTracker method inspects for user cancellations.

Product Availability

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

Specified by:

setCancelTrackerByRef in interface IReplicationAgentCancelControl

Parameters:

rhs1 - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.