SpatialTemporalObject (iObjects Java Help)

java.lang.Object
- com.supermap.data.InternalHandle
- - com.supermap.data.InternalHandleDisposable
  - - com.supermap.data.SpatialTemporalObject

所有已实现的接口:: IDisposable

public class SpatialTemporalObject
extends com.supermap.data.InternalHandleDisposable

时空对象类

实现栅格数据随时间轴变化的动态播放，满足用户动态播放栅格数据。

可以将普通栅格、栅格文件、缓存文件、栅格集合做为时空子项进行时空管理。
可以跨数据源添加时空子项，管理不同数据源的数据。
可以使用时间属性进行查询其时刻的时空子项信息。
可以以不同参数信息移除时空子项信息。
可以获取时空对象的始末时间信息。
时空对象目前不存储至数据库中，可通过其ToXML接口存储至XML文件中，可通过FromXML接口从XML中恢复。
时空子项ItemInfo中有SourceXML信息，可通过此信息获得数据源连接信息。

示范代码:

以下代码示范如何使用时空对象。

 public void SpatialTemporalObjectTest(){
                // 前提条件：已打开一个工作空间 workspace 对象，工作空间中存在一个数据源 datasource 对象，数据源中包含一些数据集。
                // 构造一个时空对象
                SpatialTemporalObject  spacetime = new SpatialTemporalObject();

                // 设置时空对象名称、描述信息等
                spacetime.setName(classname);
                spacetime.setDescription("时空对象测试");
                spacetime.setExtendInfo("时空对象接口测试");

                // 向时空对象中添加时空子项，srcinfo为数据源连接信息对象
                for(int i=0; i<5;i++){
                        Dataset dt = datasource.getDatasets().get(i);
                        Date time = new Date();
                        spacetime.AddItem(time, dt.getName(), dt.getName(),srcinfo.toXML());
                }

                //将时空对象转成XML文件保存到 srcudbdatapath 路径下，XML文件中保存了时空对象信息。
                spacetime.ToXML(srcudbdatapath+"SpatialTemporalObjectTest.XML");
                spacetime.dispose();
        }

构造器概要

构造器
构造器和说明
`SpatialTemporalObject()` 构造一个新的 SpatialTemporalObject 对象。
`SpatialTemporalObject(SpatialTemporalObject object)` 根据object构造一个新的SpatialTemporalObject对象。
`SpatialTemporalObject(String name, String des, String extinfo)` 根据给定的参数构造一个新的SpatialTemporalObject对象

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`int`	`AddItem(Date time, String Name, String ItemKey, String strSourceXml)` 向时空对象添加时空子项。
`int`	`AddItem(SpatialTemporalItemInfo itemInfo)` 根据itemInfo添加时空子项
`void`	`dispose()` 释放时空对象。
`SpatialTemporalItemInfo[]`	`findItemInfos(Date startTime, Date endTime)` 根据时间范围查找时空子项信息
`boolean`	`FromXML(String strXMLPath)` 根据XML文件恢复时空对象。
`SpatialTemporalItemInfo[]`	`getAllItemInfos()` 获取所有的时空子项信息
`int`	`getCount()` 获取时空对象子对象的个数。
`String`	`getDescription()` 获取时空对象描述信息。
`Date`	`getEndTime()` 获取结束时间。
`String`	`getExtendInfo()` 获取时空对象的扩展信息。
`String`	`getName()` 获取时空对象的名称
`Date`	`getStartTime()` 获取开始时间。
`int`	`IndexOf(SpatialTemporalItemInfo itemInfo)` 根据时空子对象信息定位时空子对象位置。
`boolean`	`RemoveAllItem()` 移除所有的时空子项。
`boolean`	`RemoveItem(Date time)` 根据时间移除时空子项。
`boolean`	`RemoveItem(String name)` 根据名称移除时空子项。
`void`	`setDescription(String strDes)` 设置时空对象描述信息
`void`	`setExtendInfo(String strExtInfo)` 设置时空对象的扩展信息。
`void`	`setName(String strName)` 设置时空对象名称。
`String`	`ToXML(String strXMLPath)` 生成XML文件保存到strXMLPath路径下，XML文件保存了时空对象信息。

从类继承的方法 com.supermap.data.InternalHandleDisposable
makeSureNativeObjectLive

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - SpatialTemporalObject
```
public SpatialTemporalObject()
```
    构造一个新的 SpatialTemporalObject 对象。
  - SpatialTemporalObject
```
public SpatialTemporalObject(String name,
                             String des,
                             String extinfo)
```
    根据给定的参数构造一个新的SpatialTemporalObject对象
    
    参数:
    
    name - 时空对象名称
    
    des - 时空对象的描述信息
    
    extinfo - 时空对象的扩展信息
  - SpatialTemporalObject
```
public SpatialTemporalObject(SpatialTemporalObject object)
```
    根据object构造一个新的SpatialTemporalObject对象。
    
    参数:
    
    object - 时空对象
- 方法详细资料
  - getName
```
public String getName()
```
    获取时空对象的名称
    
    返回:
    
    时空对象名称
  - setName
```
public void setName(String strName)
```
    设置时空对象名称。
    
    参数:
    
    strName -
  - getDescription
```
public String getDescription()
```
    获取时空对象描述信息。
    
    返回:
    
    时空对象描述信息。
  - setDescription
```
public void setDescription(String strDes)
```
    设置时空对象描述信息
    
    参数:
    
    strDes - 描述信息
  - getExtendInfo
```
public String getExtendInfo()
```
    获取时空对象的扩展信息。
    
    返回:
    
    时空对象扩展信息
  - setExtendInfo
```
public void setExtendInfo(String strExtInfo)
```
    设置时空对象的扩展信息。
    
    参数:
    
    strExtInfo - 扩展信息
  - AddItem
```
public int AddItem(SpatialTemporalItemInfo itemInfo)
```
    根据itemInfo添加时空子项
    
    参数:
    
    itemInfo - 时空子对象信息类
    
    返回:
    
    当前子项索引号
  - AddItem
```
public int AddItem(Date time,
                   String Name,
                   String ItemKey,
                   String strSourceXml)
```
    向时空对象添加时空子项。
    
    参数:
    
    time - 时间
    
    Name - 数据集名称
    
    AliasName - 别名
    
    strSourceXml - 数据集所在数据源连接信息
    
    返回:
    
    当前子项索引号
  - getCount
```
public int getCount()
```
    获取时空对象子对象的个数。
    
    返回:
    
    时空对象子对象的个数
  - findItemInfos
```
public SpatialTemporalItemInfo[] findItemInfos(Date startTime,
                                               Date endTime)
```
    根据时间范围查找时空子项信息
    
    参数:
    
    startTime - 开始时间
    
    endTime - 结束时间
    
    返回:
    
    时空子项信息数组
  - getAllItemInfos
```
public SpatialTemporalItemInfo[] getAllItemInfos()
```
    获取所有的时空子项信息
    
    返回:
    
    时空子项信息数组
  - getStartTime
```
public Date getStartTime()
```
    获取开始时间。
    
    返回:
    
    开始时间
  - getEndTime
```
public Date getEndTime()
```
    获取结束时间。
    
    返回:
    
    结束时间
  - RemoveItem
```
public boolean RemoveItem(Date time)
```
    根据时间移除时空子项。
    
    参数:
    
    time - 时间
    
    返回:
    
    是否移除成功，成功返回true，失败返回false
  - RemoveItem
```
public boolean RemoveItem(String name)
```
    根据名称移除时空子项。
    
    参数:
    
    name - 名称
    
    返回:
    
    是否移除成功，成功返回true，失败返回false
  - RemoveAllItem
```
public boolean RemoveAllItem()
```
    移除所有的时空子项。
    
    返回:
    
    是否移除成功，成功返回true，失败返回false
  - ToXML
```
public String ToXML(String strXMLPath)
```
    生成XML文件保存到strXMLPath路径下，XML文件保存了时空对象信息。
    
    参数:
    
    strXMLPath - XML文件路径
    
    返回:
    
    XML文件内容
  - FromXML
```
public boolean FromXML(String strXMLPath)
```
    根据XML文件恢复时空对象。
    
    参数:
    
    strXMLPath - XML文件路径
    
    返回:
    
    是否恢复成功，成功返回true，失败返回false
  - IndexOf
```
public int IndexOf(SpatialTemporalItemInfo itemInfo)
```
    根据时空子对象信息定位时空子对象位置。
    
    参数:
    
    itemInfo - 时空子对象信息。
    
    返回:
    
    时空子对象位置。
  - dispose
```
public void dispose()
```
    释放时空对象。

类 SpatialTemporalObject

构造器概要

方法概要

从类继承的方法 com.supermap.data.InternalHandleDisposable

从类继承的方法 java.lang.Object

构造器详细资料

SpatialTemporalObject

SpatialTemporalObject

SpatialTemporalObject

方法详细资料

getName

setName

getDescription

setDescription

getExtendInfo

setExtendInfo

AddItem

AddItem

getCount

findItemInfos

getAllItemInfos

getStartTime

getEndTime

RemoveItem

RemoveItem

RemoveAllItem

ToXML

FromXML

IndexOf

dispose