com.esri.arcgis.trackinganalyst
Class TemporalRecordSet

java.lang.Object
  extended by com.esri.arcgis.trackinganalyst.TemporalRecordSet
All Implemented Interfaces:
com.esri.arcgis.interop.RemoteObjRef, ITemporalRecordSet, Serializable

public class TemporalRecordSet
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, ITemporalRecordSet

Defines the COM coclass for the TemporalRecordSet COM object.

Description

This object defines the COM CoClass for the TemporalRecordset COM object. This object's primary purpose is to index or sort a feature class and provide the mechanism to allow cursors to be created from this object that provide feature data in temporal order from oldest to newest.

Product Availability

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

See Also:
Serialized Form

Constructor Summary
TemporalRecordSet()
          Constructs a TemporalRecordSet using ArcGIS Engine.
TemporalRecordSet(Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
TemporalRecordSet theTemporalRecordSet = (TemporalRecordSet) obj;
 
Method Summary
 boolean equals(Object o)
          Compare this object with another
static String getClsid()
          getClsid.
 int getCount()
          Number of features contained by the cursor.
 int getFeatureCacheWindow()
          Determines the number of features to cache if FeaturesCached property is true.
 IFeatureClass getFeatureClass()
          A reference to the feature class of which this record set is a member.
 Object getMostCurrentFeature()
          Returns success, but does nothing.
 Object getOldestFeature()
          Returns success, but does nothing.
 String getTemporalColumnName()
          Identifies the column containing time and date information.
 String getTimeSeriesColumnName()
          Identifies column in the feature class containing temporal observations with time series.
 int hashCode()
          the hashcode for this object
 void indexFeatureClass(Object cvarCacheStartingTime, Object cvarCacheEndingTime, ISelectionSet piSelSet, IQueryFilter piQueryFilter, int lLocaleLanguageID, String bstrDateFormat, String bstrTimeFormat, String bstrAMDesignator, String bstrPMDesignator)
          Re-builds the temporal index and caches features based on the supplied temporal parameters.
 boolean isCacheFeatures()
          Controls whether features are cached in the renderer's feature memory or are read from the feature class.
 IFeatureCursor search(IQueryFilter piQueryFilter, boolean bvarRecycling, boolean bvarForDrawing)
          Performs a query on the record set for the given time range, returning a feature cursor.
 ISelectionSet selectByDate(Object varStartDate, Object varEndDate)
          Allows user to select record set by its date value.
 void setCacheFeatures(boolean pVal)
          Controls whether features are cached in the renderer's feature memory or are read from the feature class.
 void setFeatureCacheWindow(int pnPercent)
          Determines the number of features to cache if FeaturesCached property is true.
 void setFeatureClassByRef(IFeatureClass ppiFeatureClass)
          A reference to the feature class of which this record set is a member.
 void setTemporalColumnName(String pVal)
          Identifies the column containing time and date information.
 void setTimeSeriesColumnName(String pVal)
          Identifies column in the feature class containing temporal observations with time series.
 
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

TemporalRecordSet

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

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

TemporalRecordSet

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

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

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

getTemporalColumnName

public String getTemporalColumnName()
                             throws IOException,
                                    AutomationException
Identifies the column containing time and date information.

Description

This property is the name of the temporal column name. This column contains time-date information.

Product Availability

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

Specified by:
getTemporalColumnName in interface ITemporalRecordSet
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
Identifies the column containing time and date information.

Description

This property is the name of the temporal column name. This column contains time-date information.

Product Availability

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

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

setFeatureClassByRef

public void setFeatureClassByRef(IFeatureClass ppiFeatureClass)
                          throws IOException,
                                 AutomationException
A reference to the feature class of which this record set is a member.

Description

This routine sets a reference to the feature class that this record set is a part of.

Product Availability

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

Specified by:
setFeatureClassByRef in interface ITemporalRecordSet
Parameters:
ppiFeatureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

indexFeatureClass

public void indexFeatureClass(Object cvarCacheStartingTime,
                              Object cvarCacheEndingTime,
                              ISelectionSet piSelSet,
                              IQueryFilter piQueryFilter,
                              int lLocaleLanguageID,
                              String bstrDateFormat,
                              String bstrTimeFormat,
                              String bstrAMDesignator,
                              String bstrPMDesignator)
                       throws IOException,
                              AutomationException
Re-builds the temporal index and caches features based on the supplied temporal parameters.

Description

This method re-builds the temporal index and caches features based on the supplied temporal parameters. This method indexes all features in a feature class but only caches or saves the features object instances that fall within the parameters supplied.

Product Availability

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

Specified by:
indexFeatureClass in interface ITemporalRecordSet
Parameters:
cvarCacheStartingTime - A Variant (in)
cvarCacheEndingTime - A Variant (in)
piSelSet - A reference to a com.esri.arcgis.geodatabase.ISelectionSet (in)
piQueryFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)
lLocaleLanguageID - The lLocaleLanguageID (in)
bstrDateFormat - The bstrDateFormat (in)
bstrTimeFormat - The bstrTimeFormat (in)
bstrAMDesignator - The bstrAMDesignator (in)
bstrPMDesignator - The bstrPMDesignator (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCount

public int getCount()
             throws IOException,
                    AutomationException
Number of features contained by the cursor.

Description

This property provides the number of features that this record set contains.

Product Availability

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

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

search

public IFeatureCursor search(IQueryFilter piQueryFilter,
                             boolean bvarRecycling,
                             boolean bvarForDrawing)
                      throws IOException,
                             AutomationException
Performs a query on the record set for the given time range, returning a feature cursor.

Description

This method performs a query on the record set for the given time range and returns a Feature Cursor that the caller can iterate through to extract the features in ascending or descending temporal order.

The starting or ending date can be set to the constant TEMPORALEXTENT and the starting or ending time will begin with the first or last time in the record set depending on which argument it is set to. If both arguments are set to TEMPORALEXTENT then the whole record set is traversed.

Product Availability

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

Specified by:
search in interface ITemporalRecordSet
Parameters:
piQueryFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)
bvarRecycling - The bvarRecycling (in)
bvarForDrawing - The bvarForDrawing (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.IFeatureCursor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isCacheFeatures

public boolean isCacheFeatures()
                        throws IOException,
                               AutomationException
Controls whether features are cached in the renderer's feature memory or are read from the feature class.

Description

This property controls whether Features are cached in the renders feature memory or are read from the feature class.

Product Availability

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

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

setCacheFeatures

public void setCacheFeatures(boolean pVal)
                      throws IOException,
                             AutomationException
Controls whether features are cached in the renderer's feature memory or are read from the feature class.

Description

This property controls whether Features are cached in the renders feature memory or are read from the feature class.

Product Availability

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

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

getTimeSeriesColumnName

public String getTimeSeriesColumnName()
                               throws IOException,
                                      AutomationException
Identifies column in the feature class containing temporal observations with time series.

Description

This property identifies the feature class's column that identifies or groups temporal observations with time series.

Product Availability

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

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

setTimeSeriesColumnName

public void setTimeSeriesColumnName(String pVal)
                             throws IOException,
                                    AutomationException
Identifies column in the feature class containing temporal observations with time series.

Description

This property identifies the feature class's column that identifies or groups temporal observations with time series.

Product Availability

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

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

getFeatureClass

public IFeatureClass getFeatureClass()
                              throws IOException,
                                     AutomationException
A reference to the feature class of which this record set is a member.

Description

This routine sets a reference to the feature class that this record set is a part of.

Product Availability

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

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

getFeatureCacheWindow

public int getFeatureCacheWindow()
                          throws IOException,
                                 AutomationException
Determines the number of features to cache if FeaturesCached property is true.

Description

This property determines the amount of features to cache if features Cached property is true. This property uses the temporal references temporal period property to determine the period and then adds x percent to each end of the current temporally displayable features. For example, if the temporal period is 10 min and this property is 50, the resulting cached features will be 5 min before and 5 min after the 10 min period that is currently displayed.

Product Availability

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

Specified by:
getFeatureCacheWindow in interface ITemporalRecordSet
Returns:
The pnPercent
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setFeatureCacheWindow

public void setFeatureCacheWindow(int pnPercent)
                           throws IOException,
                                  AutomationException
Determines the number of features to cache if FeaturesCached property is true.

Description

This property determines the amount of features to cache if features Cached property is true. This property uses the temporal references temporal period property to determine the period and then adds x percent to each end of the current temporally displayable features. For example, if the temporal period is 10 min and this property is 50, the resulting cached features will be 5 min before and 5 min after the 10 min period that is currently displayed.

Product Availability

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

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

getOldestFeature

public Object getOldestFeature()
                        throws IOException,
                               AutomationException
Returns success, but does nothing.

Product Availability

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

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

getMostCurrentFeature

public Object getMostCurrentFeature()
                             throws IOException,
                                    AutomationException
Returns success, but does nothing.

Product Availability

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

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

selectByDate

public ISelectionSet selectByDate(Object varStartDate,
                                  Object varEndDate)
                           throws IOException,
                                  AutomationException
Allows user to select record set by its date value.

Product Availability

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

Specified by:
selectByDate in interface ITemporalRecordSet
Parameters:
varStartDate - A Variant (in)
varEndDate - A Variant (in)
Returns:
A reference to a com.esri.arcgis.geodatabase.ISelectionSet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.