com.supermap.data
类 SpatialTemporalObject

java.lang.Object
  com.supermap.data.SpatialTemporalObject

public class SpatialTemporalObject
extends java.lang.Object

时空对象类

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

1. 可以将 普通栅格、栅格文件、缓存文件、栅格集合 做为时空子项进行时空管理。
2. 可以跨数据源添加时空子项，管理不同数据源的数据。
3. 可以使用时间属性进行查询其时刻的时空子项信息。
4. 可以以不同参数信息移除时空子项信息。
5. 可以获取时空对象的始末时间信息。
6. 时空对象目前不存储至数据库中，可通过其ToXML接口存储至XML文件中，可通过FromXML接口从XML中恢复。
7. 时空子项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(java.lang.String name, java.lang.String des, java.lang.String extinfo)
根据给定的参数构造一个新的SpatialTemporalObject对象

方法摘要

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

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

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

SpatialTemporalObject

public SpatialTemporalObject()

构造一个新的 SpatialTemporalObject 对象。

SpatialTemporalObject

public SpatialTemporalObject(SpatialTemporalObject object)

根据object构造一个新的SpatialTemporalObject对象。

参数：

object - 时空对象

SpatialTemporalObject

public SpatialTemporalObject(java.lang.String name,
                             java.lang.String des,
                             java.lang.String extinfo)

根据给定的参数构造一个新的SpatialTemporalObject对象

参数：

name - 时空对象名称

des - 时空对象的描述信息

extinfo - 时空对象的扩展信息

方法详细信息

getName

public java.lang.String getName()

获取时空对象的名称

返回：

时空对象名称

setName

public void setName(java.lang.String strName)

设置时空对象名称。

参数：

strName -

getDescription

public java.lang.String getDescription()

获取时空对象描述信息。

返回：

时空对象描述信息。

setDescription

public void setDescription(java.lang.String strDes)

设置时空对象描述信息

参数：

strDes - 描述信息

getExtendInfo

public java.lang.String getExtendInfo()

获取时空对象的扩展信息。

返回：

时空对象扩展信息

setExtendInfo

public void setExtendInfo(java.lang.String strExtInfo)

设置时空对象的扩展信息。

参数：

strExtInfo - 扩展信息

AddItem

public int AddItem(java.util.Date time,
                   java.lang.String Name,
                   java.lang.String AliasName,
                   java.lang.String strSourceXml)

向时空对象添加时空子项。

参数：

time - 时间

Name - 数据集名称

AliasName - 别名

strSourceXml - 数据集所在数据源连接信息

返回：

当前子项索引号

AddItem

public int AddItem(SpatialTemporalItemInfo itemInfo)

根据itemInfo添加时空子项

参数：

itemInfo - 时空子对象信息类

返回：

当前子项索引号

getCount

public int getCount()

获取时空对象子对象的个数。

返回：

时空对象子对象的个数

findItemInfos

public SpatialTemporalItemInfo[] findItemInfos(java.util.Date startTime,
                                               java.util.Date endTime)

根据时间范围查找时空子项信息

参数：

startTime - 开始时间

endTime - 结束时间

返回：

时空子项信息数组

getAllItemInfos

public SpatialTemporalItemInfo[] getAllItemInfos()

获取所有的时空子项信息

返回：

时空子项信息数组

getStartTime

public java.util.Date getStartTime()

获取开始时间。

返回：

开始时间

getEndTime

public java.util.Date getEndTime()

获取结束时间。

返回：

结束时间

RemoveItem

public boolean RemoveItem(java.util.Date time)

根据时间移除时空子项。

参数：

time - 时间

返回：

是否移除成功，成功返回true，失败返回false

RemoveItem

public boolean RemoveItem(java.lang.String name)

根据名称移除时空子项。

参数：

name - 名称

返回：

是否移除成功，成功返回true，失败返回false

RemoveAllItem

public boolean RemoveAllItem()

移除所有的时空子项。

返回：

是否移除成功，成功返回true，失败返回false

ToXML

public java.lang.String ToXML(java.lang.String strXMLPath)

生成XML文件保存到strXMLPath路径下，XML文件保存了时空对象信息。

参数：

strXMLPath - XML文件路径

返回：

XML文件内容

FromXML

public boolean FromXML(java.lang.String strXMLPath)

根据XML文件恢复时空对象。

参数：

strXMLPath - XML文件路径

返回：

是否恢复成功，成功返回true，失败返回false

IndexOf

public int IndexOf(SpatialTemporalItemInfo itemInfo)

根据时空子对象信息定位时空子对象位置。

参数：

itemInfo - 时空子对象信息。

返回：

时空子对象位置。

dispose

public void dispose()

释放时空对象。