com.esri.arcgis.geodatabasedistributed
Class TableDataChangesInfo

java.lang.Object
  extended by com.esri.arcgis.geodatabasedistributed.TableDataChangesInfo
All Implemented Interfaces:
ITableDataChangesInfo, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class TableDataChangesInfo
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, ITableDataChangesInfo

The information needed to export changes.

Remarks

The TableDataChangesInfo coclass is used in conjunction with the TablesDataChanges coclass to define a delta file which contains edits. See DataChangesExporter for information on delta files.

Use the ITableDataChangesInfo:Init method to initialize the TableDataChangesInfo coclass. Use the ITableDataChanges:Add method to add an initialized TableDataChangesInfo object to the TablesDataChanges object.

Product Availability

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

See Also:
Serialized Form

Constructor Summary
TableDataChangesInfo()
          Constructs a TableDataChangesInfo using ArcGIS Engine.
TableDataChangesInfo(Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
TableDataChangesInfo theTableDataChangesInfo = (TableDataChangesInfo) obj;
 
Method Summary
 boolean equals(Object o)
          Compare this object with another
static String getClsid()
          getClsid.
 void getDeletedIDs(ILongArray[] deletedIDs, IStringArray[] deletedGIDs)
          The deleted ids.
 ITable getDeletes()
          The delete changes table.
 IQueryFilter getFilter(int changeType)
          The filter for the inserts table.
 ITable getInserts()
          The insert changes table.
 String getTargetName()
          The changes target name.
 ITable getUpdates()
          The updates changes table.
 int hashCode()
          the hashcode for this object
 void init(String targetName, ITable inserts, ITable updates, ITable deletes)
          Initializes the class by setting the inserts, updates, and deletes table.
 void setDeletedIDs(ILongArray deletedIDs, IStringArray deletedGIDs)
          The deleted ids.
 void setFilter(int changeType, IQueryFilter filter)
          The filter for the inserts table.
 
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

TableDataChangesInfo

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

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

TableDataChangesInfo

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

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

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

init

public void init(String targetName,
                 ITable inserts,
                 ITable updates,
                 ITable deletes)
          throws IOException,
                 AutomationException
Initializes the class by setting the inserts, updates, and deletes table.

Remarks

This method is used to initialize the TableDataChangesInfo coclass. This method defines edits based on geodatabase feature classes and tables. The TableDataChangesInfo coclass is used in conjunction with the TablesDataChanges coclass to define a delta file which contains edits. See DataChangesExporter for information on delta files.

The Init method takes the name of the target feature class or table, and up to 3 tables that define the inserts, updates, and deletes.

The TargetName is the string name of the feature class or table that will receive the changes. For example if you want to define edits to the "Buildings" feature class, the value for this parameter would be "Buildings".

The edits to be applied can be specified using geodatabase feature classes or tables.

The Inserts parameter is a table that contains all the inserted records to be applied. If there are no inserts to be applied, you may pass nothing for this parameter.

The Updates paramter is a table that contains all the updates to be applied. If there are no inserts to be applied, you may pass nothing for this parameter.

The Deletes parameter is a table that conatins all the deletes to be applied. Nothing may be passed if there are no deletes specified in a table. Alternatively, IDs to be deleted may also be set using the SetDeletedIDs property after calling the Init method.

Product Availability

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

Specified by:
init in interface ITableDataChangesInfo
Parameters:
targetName - The targetName (in)
inserts - A reference to a com.esri.arcgis.geodatabase.ITable (in)
updates - A reference to a com.esri.arcgis.geodatabase.ITable (in)
deletes - A reference to a com.esri.arcgis.geodatabase.ITable (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setFilter

public void setFilter(int changeType,
                      IQueryFilter filter)
               throws IOException,
                      AutomationException
The filter for the inserts table.

Remarks

The SetFilter method allows you to specify a query filter to be applied to the edits specified for the TableDataChangesInfo object. The edits that will be filtered are those specified in the Init method and also any deleted records specified with the SetDeletedIDs method.

The changeType parameter takes a member of the esriDataChangeType enumeration to determine whether the filter will be applied to the updates, inserts, or deletes. The Filter takes a reference to a QueryFilter which defines the filter to be applied to the change type specified by the changeType parameter.

Product Availability

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

Specified by:
setFilter in interface ITableDataChangesInfo
Parameters:
changeType - A com.esri.arcgis.geodatabasedistributed.esriDataChangeType constant (in)
filter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getFilter

public IQueryFilter getFilter(int changeType)
                       throws IOException,
                              AutomationException
The filter for the inserts table.

Remarks

This method returns the filter, if any, that was set for the specified data change type. See the SetFilter method for more information.

The changeType parameter takes a member of the esriDataChangeType enumeration to determine which filter will be returned.

Product Availability

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

Specified by:
getFilter in interface ITableDataChangesInfo
Parameters:
changeType - A com.esri.arcgis.geodatabasedistributed.esriDataChangeType constant (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IQueryFilter
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getTargetName

public String getTargetName()
                     throws IOException,
                            AutomationException
The changes target name.

Remarks

Returns the string name for the feature class or table that is the target of the changes. This is the target name that was set with the ITableDataChangesInfo::Init method.

Product Availability

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

Specified by:
getTargetName in interface ITableDataChangesInfo
Returns:
The targetName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getInserts

public ITable getInserts()
                  throws IOException,
                         AutomationException
The insert changes table.

Remarks

Returns a reference to an object that implements ITable. This table contains all the inserts that were defined (if any) when the TableDataChangesInfo object was initialized. See the ITableDataChangesInfo::Init method for more information.

Product Availability

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

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

getUpdates

public ITable getUpdates()
                  throws IOException,
                         AutomationException
The updates changes table.

Remarks

Returns a reference to an object that implements ITable. This table contains all the updates that were defined (if any) when the TableDataChangesInfo object was initialized. See the ITableDataChangesInfo::Init method for more information.

Product Availability

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

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

getDeletes

public ITable getDeletes()
                  throws IOException,
                         AutomationException
The delete changes table.

Remarks

Returns a reference to an object that implements ITable. This table contains all the deletes that are defined (if any) on the TableDataChangesInfo object. See the Init and SetDeletedIDs methods for more information on how deletes can be defined.

Product Availability

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

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

setDeletedIDs

public void setDeletedIDs(ILongArray deletedIDs,
                          IStringArray deletedGIDs)
                   throws IOException,
                          AutomationException
The deleted ids.

Remarks

The SetDeletedIDs method is a way to define the deletes based on an array of IDs and/or GlobalIDs.

Before using this method, the TableDataChangesInfo coclass must be initialized with the ITableDataChangesInfo::Init method, otherwise an error will be returned.

If the deletes are specified using the SetDeletedIDs method, any deletes previously defined by a table using the Init method will be ignored. The source of deletes may only come from either the Init method, or the SetDeletedIDs method.

The DeletedIDs parameter takes a long array of IDs of the records to delete.

The DeletedGIDs parameter takes a string array of Global ID values for the records to delete.

Product Availability

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

Specified by:
setDeletedIDs in interface ITableDataChangesInfo
Parameters:
deletedIDs - A reference to a com.esri.arcgis.system.ILongArray (in)
deletedGIDs - A reference to a com.esri.arcgis.system.IStringArray (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDeletedIDs

public void getDeletedIDs(ILongArray[] deletedIDs,
                          IStringArray[] deletedGIDs)
                   throws IOException,
                          AutomationException
The deleted ids.

Remarks

This method can be used to return a list of IDs and/or Global IDs corresponding to those that were set to be deleted with the SetDeletedIDs method.

The GetDeletedIDs method takes an empty long array (DeletedIDs parameter) and/or an empty string array (DeletedGIDs parameter). These arrays will be populated, respectively, with the IDs and the global IDs of the records to delete.

Product Availability

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

Specified by:
getDeletedIDs in interface ITableDataChangesInfo
Parameters:
deletedIDs - A reference to a com.esri.arcgis.system.ILongArray (out: use single element array)
deletedGIDs - A reference to a com.esri.arcgis.system.IStringArray (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.