com.esri.arcgis.trackinganalyst
Class ITemporalFeatureClassProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.trackinganalyst.ITemporalFeatureClassProxy
All Implemented Interfaces:
ITemporalFeatureClass, Externalizable, Serializable

public class ITemporalFeatureClassProxy
extends com.esri.arcgis.interop.Dispatch
implements ITemporalFeatureClass, Serializable

Provides access to properties that allow the temporal column to be identified within a feature class and to set the TemporalObjectColumn name.

Description

This interface provides properties that allow the temporal column to be identified within a feature class, and properties to set the TemporalObjectColumnName otherwise known as the tracking id. This interface also provides functions to prune the underline table of the TemporalFeatureClass, and to query the feature class using the full temporal extent.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

See Also:
Serialized Form

Field Summary
 boolean noncastable
           
 
Fields inherited from class com.esri.arcgis.interop.Dispatch
DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef
 
Constructor Summary
  ITemporalFeatureClassProxy()
           
  ITemporalFeatureClassProxy(Object obj)
           
protected ITemporalFeatureClassProxy(Object obj, String iid)
           
 
Method Summary
 void addListener(String iidStr, Object theListener, Object theSource)
           
 IActionProcessor getPostActionProcessor()
          Evaluates data messages once they are placed in the feature class' internal storage.
 IActionCollection getPostActions()
          Collection of actions that will be evaluated after data messages are placed in the temporal feature class' internal storage.
 double getPurgePercentage()
          Indicates percentage of the maximum number of records to delete when the Purge method is called.
 int getPurgeRule()
          Indicates rule to use when purging records when AutoPurge is true (e.g., purge oldest records).
 String getTemporalColumnName()
          Name of the column containing the time-date information.
 String getTemporalObjectColumnName()
          Name of the column containing the temporal information.
 Object getThreshold()
          Indicates the high-water mark, or maximum number of observations allowed before records are purged from memory.
 boolean isAutoPurge()
          Controls whether or not to automatically purge records once a user-defined threshold is met.
 boolean isContainsTemporalObjects()
          Indicates whether or not a temporal object table is used to collect or provide static information about temporal observations.
 void pruneTable()
          Apply the purge rule to the temporal table.
 void queryTemporalExtent(Object[] pvarStartTime, Object[] pvarEndTime)
          Queries the feature class using the full temporal extent.
 void registerListener(IListener piListener)
          Registers a Listener Object with the feature class.
 void removeListener(String iidStr, Object theListener)
           
 void setAutoPurge(boolean pVal)
          Controls whether or not to automatically purge records once a user-defined threshold is met.
 void setPostActionProcessorByRef(IActionProcessor ppiProcessor)
          Evaluates data messages once they are placed in the feature class' internal storage.
 void setPostActionsByRef(IActionCollection ppiActions)
          Collection of actions that will be evaluated after data messages are placed in the temporal feature class' internal storage.
 void setPurgePercentage(double pVal)
          Indicates percentage of the maximum number of records to delete when the Purge method is called.
 void setPurgeRule(int pVal)
          Indicates rule to use when purging records when AutoPurge is true (e.g., purge oldest records).
 void setTemporalColumnName(String pVal)
          Name of the column containing the time-date information.
 void setThreshold(Object pVal)
          Indicates the high-water mark, or maximum number of observations allowed before records are purged from memory.
 
Methods inherited from class com.esri.arcgis.interop.Dispatch
bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

noncastable

public boolean noncastable
Constructor Detail

ITemporalFeatureClassProxy

public ITemporalFeatureClassProxy()

ITemporalFeatureClassProxy

public ITemporalFeatureClassProxy(Object obj)
                           throws IOException
Throws:
IOException

ITemporalFeatureClassProxy

protected ITemporalFeatureClassProxy(Object obj,
                                     String iid)
                              throws IOException
Throws:
IOException
Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException
Overrides:
addListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException
Overrides:
removeListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

queryTemporalExtent

public void queryTemporalExtent(Object[] pvarStartTime,
                                Object[] pvarEndTime)
                         throws IOException,
                                AutomationException
Queries the feature class using the full temporal extent.

Description

This function returns the full temporal extent of data stored in the feature class. The returned objects are VT_DATE type (e.g., “mm/dd/yyyy hh:mm:ss AM/PM”).

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
queryTemporalExtent in interface ITemporalFeatureClass
Parameters:
pvarStartTime - A Variant (in/out: use single element array)
pvarEndTime - A Variant (in/out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getTemporalColumnName

public String getTemporalColumnName()
                             throws IOException,
                                    AutomationException
Name of the column containing the time-date information.

Description

This property is the name of the column that contains the temporal data. This data can be a timestamp or a time period.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getTemporalColumnName in interface ITemporalFeatureClass
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setTemporalColumnName

public void setTemporalColumnName(String pVal)
                           throws IOException,
                                  AutomationException
Name of the column containing the time-date information.

Description

This property is the name of the column that contains the temporal data. This data can be a timestamp or a time period.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setTemporalColumnName in interface ITemporalFeatureClass
Parameters:
pVal - The pVal (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isContainsTemporalObjects

public boolean isContainsTemporalObjects()
                                  throws IOException,
                                         AutomationException
Indicates whether or not a temporal object table is used to collect or provide static information about temporal observations.

Description

This property indicates whether or not a temporal object table is used to collect or provide static information about temporal observations. This simply means that for a given temporal observation there is a set of static attributes that do not change from observation to observation.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
isContainsTemporalObjects in interface ITemporalFeatureClass
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getTemporalObjectColumnName

public String getTemporalObjectColumnName()
                                   throws IOException,
                                          AutomationException
Name of the column containing the temporal information.

Description

This property returns the column name that provides the temporal data. This property is set during the feature classes creation and is read-only.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getTemporalObjectColumnName in interface ITemporalFeatureClass
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getPostActionProcessor

public IActionProcessor getPostActionProcessor()
                                        throws IOException,
                                               AutomationException
Evaluates data messages once they are placed in the feature class' internal storage.

Description

The post action processor is the action processor that will evaluate data messages once they are placed in the feature class's internal storage. These data messages are queued to the actions processor's work queue, and a separate thread is used to perform this processing.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getPostActionProcessor in interface ITemporalFeatureClass
Returns:
A reference to a com.esri.arcgis.trackinganalyst.IActionProcessor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setPostActionProcessorByRef

public void setPostActionProcessorByRef(IActionProcessor ppiProcessor)
                                 throws IOException,
                                        AutomationException
Evaluates data messages once they are placed in the feature class' internal storage.

Description

The post action processor is the action processor that will evaluate data messages once they are placed in the feature class's internal storage. These data messages are queued to the actions processor's work queue, and a separate thread is used to perform this processing.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setPostActionProcessorByRef in interface ITemporalFeatureClass
Parameters:
ppiProcessor - A reference to a com.esri.arcgis.trackinganalyst.IActionProcessor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getPostActions

public IActionCollection getPostActions()
                                 throws IOException,
                                        AutomationException
Collection of actions that will be evaluated after data messages are placed in the temporal feature class' internal storage.

Description

This property is a collection of actions that will be evaluated after data messages are placed in the temporal feature class's internal storage.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getPostActions in interface ITemporalFeatureClass
Returns:
A reference to a com.esri.arcgis.trackinganalyst.IActionCollection
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setPostActionsByRef

public void setPostActionsByRef(IActionCollection ppiActions)
                         throws IOException,
                                AutomationException
Collection of actions that will be evaluated after data messages are placed in the temporal feature class' internal storage.

Description

This property is a collection of actions that will be evaluated after data messages are place in the temporal feature class's internal storage.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setPostActionsByRef in interface ITemporalFeatureClass
Parameters:
ppiActions - A reference to a com.esri.arcgis.trackinganalyst.IActionCollection (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

registerListener

public void registerListener(IListener piListener)
                      throws IOException,
                             AutomationException
Registers a Listener Object with the feature class.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
registerListener in interface ITemporalFeatureClass
Parameters:
piListener - A reference to a com.esri.arcgis.trackinganalyst.IListener (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isAutoPurge

public boolean isAutoPurge()
                    throws IOException,
                           AutomationException
Controls whether or not to automatically purge records once a user-defined threshold is met.

Description

This property controls whether or not to automatically purge observations that meet a specified criteria--the user-defined Purge Rule--when the high-water mark has been exceeded.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
isAutoPurge in interface ITemporalFeatureClass
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAutoPurge

public void setAutoPurge(boolean pVal)
                  throws IOException,
                         AutomationException
Controls whether or not to automatically purge records once a user-defined threshold is met.

Description

This property controls whether or not to automatically purge observations that meet a specified criteria--the user-defined Purge Rule--when the high-water mark has been exceeded.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setAutoPurge in interface ITemporalFeatureClass
Parameters:
pVal - The pVal (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getThreshold

public Object getThreshold()
                    throws IOException,
                           AutomationException
Indicates the high-water mark, or maximum number of observations allowed before records are purged from memory.

Description

This property indicates the high-water mark or the number of observations that should not be exceeded. When the auto purge property is enabled or true, this level is the maximum number of records that can exist in the table. The auto purge process occurs or is triggered, and it will prune the table according to the Purge Rule. If Auto Purge is not true or enabled then record inserts will fail and no further data will be allowed into the table.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getThreshold in interface ITemporalFeatureClass
Returns:
A Variant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setThreshold

public void setThreshold(Object pVal)
                  throws IOException,
                         AutomationException
Indicates the high-water mark, or maximum number of observations allowed before records are purged from memory.

Description

This property indicates the high-water mark or the number of observations that should not be exceeded. When the auto purge property is enabled or true, this level is the maximum number of records that can exist in the table. The auto purge process occurs or is triggered, and it will prune the table according to the Purge Rule. If Auto Purge is not true or enabled then record inserts will fail and no further data will be allowed into the table.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setThreshold in interface ITemporalFeatureClass
Parameters:
pVal - A Variant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getPurgePercentage

public double getPurgePercentage()
                          throws IOException,
                                 AutomationException
Indicates percentage of the maximum number of records to delete when the Purge method is called.

Description

This property indicates the percentage of the maximum allowed number of records to delete when the Purge method is called. This maximum allowed limit is also the same as the Threshold property.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getPurgePercentage in interface ITemporalFeatureClass
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setPurgePercentage

public void setPurgePercentage(double pVal)
                        throws IOException,
                               AutomationException
Indicates percentage of the maximum number of records to delete when the Purge method is called.

Description

This property indicates the percentage of the maximum allowed number of records to delete when the Purge method is called. This maximum allowed limit is also the same as the Threshold property.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setPurgePercentage in interface ITemporalFeatureClass
Parameters:
pVal - The pVal (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getPurgeRule

public int getPurgeRule()
                 throws IOException,
                        AutomationException
Indicates rule to use when purging records when AutoPurge is true (e.g., purge oldest records).

Description

This property identifies the purge rule to apply when the Purge method is called via user, or the auto purge criteria. See the purge rule enumeration constants for details about each rule.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getPurgeRule in interface ITemporalFeatureClass
Returns:
A com.esri.arcgis.trackinganalyst.enumPurgeRule constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setPurgeRule

public void setPurgeRule(int pVal)
                  throws IOException,
                         AutomationException
Indicates rule to use when purging records when AutoPurge is true (e.g., purge oldest records).

Description

This property identifies the purge rule to apply when the Purge method is called via user ,or the auto purge criteria.

See the purge rule enumeration constants for details about each rule.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setPurgeRule in interface ITemporalFeatureClass
Parameters:
pVal - A com.esri.arcgis.trackinganalyst.enumPurgeRule constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

pruneTable

public void pruneTable()
                throws IOException,
                       AutomationException
Apply the purge rule to the temporal table.

Description

This function applies the purge rule to the temporal table to purge observations that meet a specified criteria--the user-defined Purge Rule--when the high-water mark has been exceeded.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
pruneTable in interface ITemporalFeatureClass
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.