RealspaceImpl

java.lang.Object
- com.supermap.services.components.impl.RealspaceImpl

所有已实现的接口:

ComponentContextAware, Realspace, Disposable
```
public class RealspaceImpl
extends java.lang.Object
implements Realspace, ComponentContextAware, Disposable
```
三维服务组件接口（Realspace）的实现类。

三维服务组件是一类 GIS 服务组件，封装了与三维相关的 GIS 功能。

构造器概要

构造器
构造器和说明

RealspaceImpl()
构造函数。

RealspaceImpl(RealspaceContext context)
根据三维上下文信息构建一个 RealspaceImpl 对象。

构造器
构造器和说明
`RealspaceImpl()` 构造函数。
`RealspaceImpl(RealspaceContext context)` 根据三维上下文信息构建一个 RealspaceImpl 对象。

方法概要

方法
限定符和类型	方法和说明
`boolean`	`cleanCacheData(java.lang.String dataName)` 清除动态发布数据的缓存。
`void`	`dispose()` 释放资源对象。
`java.lang.String`	`getCacheAccessKey()` 返回用于对缓存数据进行加密的密码。
`RealspaceDataResult`	`getData(RealspaceDataParam dataParam)` 获取三维瓦片数据结果。
`RealspaceDataResult`	`getData(java.lang.String sceneName, java.lang.String layerName, RealspaceDataParam dataParam)` 根据场景名以及图层名及瓦片参数三维瓦片数据结果。
`byte[]`	`getDataConfig(java.lang.String dataName)` 根据三维数据的名称获取三维缓存数据的配置文件。
`byte[]`	`getDataConfig(java.lang.String dataName, CompressType compressType)` 根据名称获取三维缓存数据的配置文件。
`java.util.List<RealspaceDataInfo>`	`getDataInfos()` 获取所有的三维数据信息。
`java.lang.String`	`getDataVersion(java.lang.String dataName, int xIndex, int yIndex, int level, java.lang.String fileExtension)` 根据索引获取瓦片数据的最新版本号。
`java.lang.String`	`getDataVersion(java.lang.String dataName, java.lang.String relativePath)` 根据相对路径获取瓦片数据的最新版本号。
`java.lang.String`	`getLayerExtendXML(java.lang.String sceneName, java.lang.String layerName)` 获取指定图层的图层扩展信息
`PrjCoordSys`	`getLayerPrj(java.lang.String sceneName, java.lang.String layerName)` 获取指定图层的投影信息
`byte[]`	`getModelIndex(java.lang.String dataName)` 根据三维数据的名称获取三维模型缓存数据的模型索引文件。
`java.util.List<OfflineDataInfo>`	`getOfflineDataPaths(java.lang.String sceneName, java.lang.String layerName)` 获取特定三维场景的所有数据离线包的位置信息
`SceneInfo`	`getSceneInfo(java.lang.String sceneName)` 根据三维场景的名称，获取三维场景的信息。
`java.util.List<java.lang.String>`	`getSceneNames()` 返回所有可用的三维场景的名称。
`RealspaceTilesRevisionInfo`	`getTilesRevisionInfo(java.lang.String dataName, long revisionNumber)` 获取指定版本号的瓦片变更信息。
`byte[]`	`getVectorIndex(java.lang.String dataName)` 根据三维数据的名称获取三维矢量缓存数据的索引文件。
`boolean`	`isCacheCanReuse()` 三维缓存是否允许拷贝和重用。
`boolean`	`isDataAvailable(java.lang.String dataName)` 三维数据是否可用。
`static boolean`	`isDataAvaliableUseLayerName(RealspaceProvider realspaceProvider, java.lang.String layerName)` 三维provider 是否支持给定的数据，并且用图层名指代数据。
`boolean`	`isSceneAvailable(java.lang.String sceneName)` 三维场景是否可用。
`boolean`	`isSecurityEnabled()` 是否启用安全机制。
`RealspaceDataResult[]`	`outputDataToMemory(java.lang.String sceneName, java.lang.String layerName, Output3DDataToMemoryParam dataParam)` 根据场景名以及图层名将三维瓦片生成到内存中
`void`	`setComponentContext(ComponentContext context)` 设置组件上下文信息。
`boolean`	`updateCacheData(java.lang.String dataName, Output3DDataToMemoryParam param)` 更新动态发布数据的缓存。

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

- 构造器详细资料
  - RealspaceImpl
```
public RealspaceImpl()
```
    构造函数。
  - RealspaceImpl
```
public RealspaceImpl(RealspaceContext context)
```
    根据三维上下文信息构建一个 RealspaceImpl 对象。
    
    参数:
    
    context - 三维的上下文信息。
- 方法详细资料
  - getSceneNames
```
public java.util.List<java.lang.String> getSceneNames()
                                               throws RealspaceException
```
    返回所有可用的三维场景的名称。
    
    指定者:
    
    getSceneNames 在接口中 Realspace
    
    返回:
    
    可用的场景名称列表。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - getSceneInfo
```
public SceneInfo getSceneInfo(java.lang.String sceneName)
                       throws RealspaceException
```
    根据三维场景的名称，获取三维场景的信息。
    
    指定者:
    
    getSceneInfo 在接口中 Realspace
    
    参数:
    
    sceneName - 三维场景的名称。
    
    返回:
    
    三维场景信息。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - getDataVersion
```
public java.lang.String getDataVersion(java.lang.String dataName,
                              int xIndex,
                              int yIndex,
                              int level,
                              java.lang.String fileExtension)
                                throws RealspaceException
```
    根据索引获取瓦片数据的最新版本号。
    
    指定者:
    
    getDataVersion 在接口中 Realspace
    
    参数:
    
    dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。
    
    xIndex - 瓦片数据 X 方向的索引。
    
    yIndex - 瓦片数据 Y 方向的索引。
    
    level - 瓦片数据的层号，仅模型的三维缓存数据需要设置。
    
    fileExtension - 瓦片数据的扩展名。包括 *.png，*.jpg，*.bil等。
    
    返回:
    
    瓦片数据件的版本。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - getDataVersion
```
public java.lang.String getDataVersion(java.lang.String dataName,
                              java.lang.String relativePath)
                                throws RealspaceException
```
    根据相对路径获取瓦片数据的最新版本号。
    
    瓦片数据的相对路径的设置有以下情况：
    - 对于地形和影像三维缓存数据来说，相对路径从缓存配置文件（SCT 和 SCI3D）所在的目录开始，也就是从缓存层号开始，缓存配置文件同级下存放了分层的缓存数据。比如缓存层号为12，那么相对路径为“12/.../.../缓存文件”。
    - 对于模型三维缓存数据来说，相对路径从缓存配置文件的父一级目录开始，即从缓存层号目录开始，模型数据与地形和影像数据不同，在分层目录下存放的不是缓存之后的数据，而是模型缓存文件的索引文件（index），版本号指的也是该索引文件的版本号。
    - KML 数据没有版本号。
    指定者:
    
    getDataVersion 在接口中 Realspace
    
    参数:
    
    dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。
    
    relativePath - 瓦片数据的相对路径。
    
    返回:
    
    瓦片数据的最新版本号。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - getData
```
public RealspaceDataResult getData(java.lang.String sceneName,
                          java.lang.String layerName,
                          RealspaceDataParam dataParam)
                            throws RealspaceException
```
    从接口复制的说明: Realspace
    
    根据场景名以及图层名及瓦片参数三维瓦片数据结果。
    
    指定者:
    
    getData 在接口中 Realspace
    
    参数:
    
    sceneName - 场景名。
    
    layerName - 图层名。
    
    dataParam - 瓦片参数。
    
    抛出:
    
    RealspaceException
  - getData
```
public RealspaceDataResult getData(RealspaceDataParam dataParam)
                            throws RealspaceException
```
    从接口复制的说明: Realspace
    
    获取三维瓦片数据结果。
    
    指定者:
    
    getData 在接口中 Realspace
    
    参数:
    
    dataParam - 瓦片参数。
    
    抛出:
    
    RealspaceException
  - getDataConfig
```
public byte[] getDataConfig(java.lang.String dataName)
                     throws RealspaceException
```
    根据三维数据的名称获取三维缓存数据的配置文件。
    
    指定者:
    
    getDataConfig 在接口中 Realspace
    
    参数:
    
    dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。
    
    返回:
    
    三维缓存数据的配置文件。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - getDataConfig
```
public byte[] getDataConfig(java.lang.String dataName,
                   CompressType compressType)
                     throws RealspaceException
```
    从接口复制的说明: Realspace
    
    根据名称获取三维缓存数据的配置文件。
    
    指定者:
    
    getDataConfig 在接口中 Realspace
    
    参数:
    
    dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。
    
    返回:
    
    三维缓存数据的配置文件。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - getModelIndex
```
public byte[] getModelIndex(java.lang.String dataName)
                     throws RealspaceException
```
    根据三维数据的名称获取三维模型缓存数据的模型索引文件。
    
    该文件以“index”为文件的扩展名，与模型缓存数据的配置文件（扩展名为“scm”的文件）位于同样的父目录下。
    
    指定者:
    
    getModelIndex 在接口中 Realspace
    
    参数:
    
    dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。
    
    返回:
    
    模型索引文件。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - getVectorIndex
```
public byte[] getVectorIndex(java.lang.String dataName)
                      throws RealspaceException
```
    根据三维数据的名称获取三维矢量缓存数据的索引文件。
    
    该文件以“dat”为文件的扩展名，与矢量缓存数据的配置文件（扩展名为“scv”的文件）位于同样的父目录下。
    
    指定者:
    
    getVectorIndex 在接口中 Realspace
    
    参数:
    
    dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。
    
    返回:
    
    矢量索引文件。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - isDataAvaliableUseLayerName
```
public static boolean isDataAvaliableUseLayerName(RealspaceProvider realspaceProvider,
                                  java.lang.String layerName)
```
    三维provider 是否支持给定的数据，并且用图层名指代数据。
    
    参数:
    
    realspaceProvider -
    
    dataName -
  - getDataInfos
```
public java.util.List<RealspaceDataInfo> getDataInfos()
                                               throws RealspaceException
```
    获取所有的三维数据信息。
    
    指定者:
    
    getDataInfos 在接口中 Realspace
    
    返回:
    
    三维数据信息。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - isDataAvailable
```
public boolean isDataAvailable(java.lang.String dataName)
                        throws RealspaceException
```
    三维数据是否可用。
    
    指定者:
    
    isDataAvailable 在接口中 Realspace
    
    参数:
    
    dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。
    
    返回:
    
    三维数据可用返回 true；否则返回 false。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - isSceneAvailable
```
public boolean isSceneAvailable(java.lang.String sceneName)
                         throws RealspaceException
```
    三维场景是否可用。
    
    指定者:
    
    isSceneAvailable 在接口中 Realspace
    
    参数:
    
    sceneName - 三维场景的名称。
    
    返回:
    
    三维场景可用返回 true；否则返回 false。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - setComponentContext
```
public void setComponentContext(ComponentContext context)
```
    设置组件上下文信息。
    
    指定者:
    
    setComponentContext 在接口中 ComponentContextAware
    
    参数:
    
    context - 上下文信息
  - dispose
```
public void dispose()
```
    释放资源对象。所有需要实现释放资源的类都需要实现 dispose()。
    
    指定者:
    
    dispose 在接口中 Disposable
  - getCacheAccessKey
```
public java.lang.String getCacheAccessKey()
                                   throws RealspaceException
```
    返回用于对缓存数据进行加密的密码。
    
    指定者:
    
    getCacheAccessKey 在接口中 Realspace
    
    返回:
    
    返回用于对缓存数据进行加密的密码。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - isSecurityEnabled
```
public boolean isSecurityEnabled()
                          throws RealspaceException
```
    是否启用安全机制。
    
    指定者:
    
    isSecurityEnabled 在接口中 Realspace
    
    返回:
    
    安全机制启用则返回 true；否则返回 false。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - cleanCacheData
```
public boolean cleanCacheData(java.lang.String dataName)
                       throws RealspaceException
```
    清除动态发布数据的缓存。
    
    指定者:
    
    cleanCacheData 在接口中 Realspace
    
    参数:
    
    dataName - 需清除缓存的数据名。
    
    返回:
    
    成功清除则返回 true；否则返回 false。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - updateCacheData
```
public boolean updateCacheData(java.lang.String dataName,
                      Output3DDataToMemoryParam param)
                        throws RealspaceException
```
    从接口复制的说明: Realspace
    
    更新动态发布数据的缓存。
    
    指定者:
    
    updateCacheData 在接口中 Realspace
    
    参数:
    
    dataName - 需更新缓存的数据名。
    
    param - 更新参数。
    
    返回:
    
    成功清除则返回 true；否则返回 false。
    
    抛出:
    
    RealspaceException - 三维异常信息。
  - getOfflineDataPaths
```
public java.util.List<OfflineDataInfo> getOfflineDataPaths(java.lang.String sceneName,
                                                  java.lang.String layerName)
                                                    throws RealspaceException
```
    获取特定三维场景的所有数据离线包的位置信息
    
    指定者:
    
    getOfflineDataPaths 在接口中 Realspace
    
    参数:
    
    sceneName - 三维场景的名称。
    
    返回:
    
    返回离线包位置
    
    抛出:
    
    RealspaceException
    
    从以下版本开始:
    
    6.1.3
  - isCacheCanReuse
```
public boolean isCacheCanReuse()
```
    从接口复制的说明: Realspace
    
    三维缓存是否允许拷贝和重用。
    
    指定者:
    
    isCacheCanReuse 在接口中 Realspace
    
    返回:
  - getTilesRevisionInfo
```
public RealspaceTilesRevisionInfo getTilesRevisionInfo(java.lang.String dataName,
                                              long revisionNumber)
                                                throws RealspaceException
```
    从接口复制的说明: Realspace
    
    获取指定版本号的瓦片变更信息。
    
    指定者:
    
    getTilesRevisionInfo 在接口中 Realspace
    
    revisionNumber - 版本号。
    
    返回:
    
    变更信息。
    
    抛出:
    
    RealspaceException
  - getLayerPrj
```
public PrjCoordSys getLayerPrj(java.lang.String sceneName,
                      java.lang.String layerName)
                        throws RealspaceException
```
    从接口复制的说明: Realspace
    
    获取指定图层的投影信息
    
    指定者:
    
    getLayerPrj 在接口中 Realspace
    
    参数:
    
    sceneName - 场景名
    
    layerName - 图层名
    
    返回:
    
    图层投影信息
    
    抛出:
    
    RealspaceException
  - outputDataToMemory
```
public RealspaceDataResult[] outputDataToMemory(java.lang.String sceneName,
                                       java.lang.String layerName,
                                       Output3DDataToMemoryParam dataParam)
                                         throws RealspaceException
```
    从接口复制的说明: Realspace
    
    根据场景名以及图层名将三维瓦片生成到内存中
    
    指定者:
    
    outputDataToMemory 在接口中 Realspace
    
    参数:
    
    sceneName - 场景名
    
    layerName - 图层名
    
    返回:
    
    生成的三维瓦片
    
    抛出:
    
    RealspaceException
  - getLayerExtendXML
```
public java.lang.String getLayerExtendXML(java.lang.String sceneName,
                                 java.lang.String layerName)
                                   throws RealspaceException
```
    从接口复制的说明: Realspace
    
    获取指定图层的图层扩展信息
    
    指定者:
    
    getLayerExtendXML 在接口中 Realspace
    
    参数:
    
    sceneName - 场景名
    
    layerName - 图层名
    
    返回:
    
    图层扩展信息xml
    
    抛出:
    
    RealspaceException

类 RealspaceImpl

构造器概要

方法概要

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

构造器详细资料

RealspaceImpl

RealspaceImpl

方法详细资料

getSceneNames

getSceneInfo

getDataVersion

getDataVersion

getData

getData

getDataConfig

getDataConfig

getModelIndex

getVectorIndex

isDataAvaliableUseLayerName

getDataInfos

isDataAvailable

isSceneAvailable

setComponentContext

dispose

getCacheAccessKey

isSecurityEnabled

cleanCacheData

updateCacheData

getOfflineDataPaths

isCacheCanReuse

getTilesRevisionInfo

getLayerPrj

outputDataToMemory

getLayerExtendXML