com.esri.arcgis.trackinganalyst
Class ITemporalFeatureClassProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      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.