com.supermap.services.providers

类 RestRealspaceProvider

java.lang.Object

com.supermap.services.providers.RestProviderBase

com.supermap.services.providers.RestRealspaceProvider

所有已实现的接口:

Disposable, ProviderContextAware, RealspaceProvider

public class RestRealspaceProvider
extends RestProviderBase
implements RealspaceProvider, ProviderContextAware

REST 真空间服务提供者。

RestRealspaceProvider 提供了从iServer 真空间REST服务获取 SuperMap 三维的相关服务，封装了与 SuperMap 三维相关的 GIS 功能。

RestRealspaceProvider 支持对三维场景（scenes）和三维数据集（datas）的访问；不支持符号（symbols）操作；不支持三维数据缓存。

嵌套类概要

从类继承的嵌套类/接口 com.supermap.services.providers.RestProviderBase

RestProviderBase.CacheModel, RestProviderBase.RestRequestException

字段概要

从类继承的字段 com.supermap.services.providers.RestProviderBase

JAVA_POSTFIX, javaConverter, JSON_POSTFIX, jsonConverter, jsonDecoder, lock, logger, message, XML_POSTFIX, xmlDecoder

构造器概要

构造器

构造器和说明
RestRealspaceProvider() 构造函数。
RestRealspaceProvider(RestRealspaceProviderSetting setting) 构造函数。

方法概要

方法

限定符和类型	方法和说明
boolean	cleanCacheData(java.lang.String dataName) 清除动态发布数据的缓存
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() 获取当前 Provider 的所有三维数据信息。
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) 获取特定三维场景下特定三维图层所有的离线数据路径
protected RestProviderSetting	getRestProviderSetting() 返回REST服务提供者配置信息。
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	isDataAvailable(java.lang.String dataName) 三维数据是否可用。
boolean	isSceneAvailable(java.lang.String sceneName) 三维场景是否可用。
boolean	isSecurityEnabled() 是否启用安全机制。
RealspaceDataResult[]	outputDataToMemory(java.lang.String sceneName, java.lang.String layerName, Output3DDataToMemoryParam outputParam) 根据场景名以及图层名将三维瓦片生成到内存中
void	setProviderContext(ProviderContext context) 设置服务提供者上下文。

从类继承的方法 com.supermap.services.providers.RestProviderBase

clearCache, dispose, executeRequest, executeRequest, executeRequest, executeRequestByApacheHttpClientForByteArray, executeRequestByRestletClientForByteArray, executeRequestForByteArray, executeRequestForByteArray, executeRequestForByteArray, executeRequestForByteArray, executeRequestForList, executeRequestForList, executeRequestForList, executeRequestForList, executeRequestForStream, executeRequestForStream, executeRequestForStream, executeRequestForText, executeRequestForText, executeRequestForText, getApacheHttpClient, getRestletRequest, handleExeption, init, initHttpClient, newAndSetClient, rectifyRestServiceRootURL

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

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

构造器详细资料

RestRealspaceProvider

public RestRealspaceProvider()

构造函数。

RestRealspaceProvider

public RestRealspaceProvider(RestRealspaceProviderSetting setting)

构造函数。

参数:

setting - Rest真空间服务提供者参数对象。

方法详细资料

setProviderContext

public void setProviderContext(ProviderContext context)

从接口复制的说明: ProviderContextAware

设置服务提供者上下文。

指定者:

setProviderContext 在接口中 ProviderContextAware

参数:

context - 服务提供者上下文。

getSceneNames

public java.util.List<java.lang.String> getSceneNames()
                                               throws RealspaceException

从接口复制的说明: RealspaceProvider

获取当前服务提供者所有可用的三维场景的名称。

指定者:

getSceneNames 在接口中 RealspaceProvider

返回:

可用的场景名称列表。

抛出:

RealspaceException - 三维异常信息。

getSceneInfo

public SceneInfo getSceneInfo(java.lang.String sceneName)
                       throws RealspaceException

从接口复制的说明: RealspaceProvider

根据三维场景的名称，获取三维场景的信息。

指定者:

getSceneInfo 在接口中 RealspaceProvider

参数:

sceneName - 三维场景的名称。

返回:

三维场景信息。

抛出:

RealspaceException - 三维异常信息。

getDataConfig

public byte[] getDataConfig(java.lang.String dataName)
                     throws RealspaceException

从接口复制的说明: RealspaceProvider

根据名称获取三维缓存数据的配置文件。

指定者:

getDataConfig 在接口中 RealspaceProvider

参数:

dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。

返回:

三维缓存数据的配置文件。

抛出:

RealspaceException - 三维异常信息。

getDataConfig

public byte[] getDataConfig(java.lang.String dataName,
                   CompressType compressType)
                     throws RealspaceException

从接口复制的说明: RealspaceProvider

根据名称获取三维缓存数据的配置文件。

指定者:

getDataConfig 在接口中 RealspaceProvider

参数:

dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。

返回:

三维缓存数据的配置文件。

抛出:

RealspaceException - 三维异常信息。

getModelIndex

public byte[] getModelIndex(java.lang.String dataName)
                     throws RealspaceException

从接口复制的说明: RealspaceProvider

根据名称获取三维模型缓存数据的模型索引文件。

该文件以“index”为文件的扩展名，与模型缓存数据的配置文件（扩展名为“scm”的文件）位于同样的父目录下。

指定者:

getModelIndex 在接口中 RealspaceProvider

参数:

dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。

返回:

模型的索引文件。

抛出:

RealspaceException - 三维异常信息。

getVectorIndex

public byte[] getVectorIndex(java.lang.String dataName)
                      throws RealspaceException

从接口复制的说明: RealspaceProvider

根据名称获取三维矢量缓存数据的索引文件。

指定者:

getVectorIndex 在接口中 RealspaceProvider

参数:

dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。

返回:

矢量数据的索引文件。

抛出:

RealspaceException - 三维异常信息。

getDataInfos

public java.util.List<RealspaceDataInfo> getDataInfos()
                                               throws RealspaceException

从接口复制的说明: RealspaceProvider

获取当前 Provider 的所有三维数据信息。

指定者:

getDataInfos 在接口中 RealspaceProvider

返回:

三维数据信息。

抛出:

RealspaceException - 三维异常信息。

isDataAvailable

public boolean isDataAvailable(java.lang.String dataName)
                        throws RealspaceException

从接口复制的说明: RealspaceProvider

三维数据是否可用。

指定者:

isDataAvailable 在接口中 RealspaceProvider

参数:

dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。

返回:

三维数据可用返回 true；否则返回 false。

抛出:

RealspaceException - 三维异常信息。

isSceneAvailable

public boolean isSceneAvailable(java.lang.String sceneName)
                         throws RealspaceException

从接口复制的说明: RealspaceProvider

三维场景是否可用。

指定者:

isSceneAvailable 在接口中 RealspaceProvider

参数:

sceneName - 三维场景的名称。

返回:

三维场景可用返回 true；否则返回 false。

抛出:

RealspaceException - 三维异常信息。

isSecurityEnabled

public boolean isSecurityEnabled()

从接口复制的说明: RealspaceProvider

是否启用安全机制。

指定者:

isSecurityEnabled 在接口中 RealspaceProvider

返回:

安全机制启用则返回 true；否则返回 false。

getCacheAccessKey

public java.lang.String getCacheAccessKey()

从接口复制的说明: RealspaceProvider

返回用于对缓存数据进行加密的密码。

指定者:

getCacheAccessKey 在接口中 RealspaceProvider

返回:

返回用于对缓存数据进行加密的密码。

cleanCacheData

public boolean cleanCacheData(java.lang.String dataName)
                       throws RealspaceException

从接口复制的说明: RealspaceProvider

清除动态发布数据的缓存

指定者:

cleanCacheData 在接口中 RealspaceProvider

返回:

抛出:

RealspaceException

getOfflineDataPaths

public java.util.List<OfflineDataInfo> getOfflineDataPaths(java.lang.String sceneName,
                                                  java.lang.String layerName)

从接口复制的说明: RealspaceProvider

获取特定三维场景下特定三维图层所有的离线数据路径

指定者:

getOfflineDataPaths 在接口中 RealspaceProvider

参数:

sceneName - 三维场景的名称。

返回:

返回离线包位置

getRestProviderSetting

protected RestProviderSetting getRestProviderSetting()

从类复制的说明: RestProviderBase

返回REST服务提供者配置信息。

指定者:

getRestProviderSetting 在类中 RestProviderBase

返回:

getData

public RealspaceDataResult getData(RealspaceDataParam dataParam)
                            throws RealspaceException

从接口复制的说明: RealspaceProvider

获取三维瓦片数据结果。

指定者:

getData 在接口中 RealspaceProvider

参数:

dataParam - 瓦片参数。

抛出:

RealspaceException

getData

public RealspaceDataResult getData(java.lang.String sceneName,
                          java.lang.String layerName,
                          RealspaceDataParam dataParam)
                            throws RealspaceException

从接口复制的说明: RealspaceProvider

根据场景名以及图层名及瓦片 参数三维瓦片数据结果。

指定者:

getData 在接口中 RealspaceProvider

参数:

sceneName - 场景名。

layerName - 图层名。

dataParam - 瓦片参数。

抛出:

RealspaceException

outputDataToMemory

public RealspaceDataResult[] outputDataToMemory(java.lang.String sceneName,
                                       java.lang.String layerName,
                                       Output3DDataToMemoryParam outputParam)
                                         throws RealspaceException

从接口复制的说明: RealspaceProvider

根据场景名以及图层名将三维瓦片生成到内存中

指定者:

outputDataToMemory 在接口中 RealspaceProvider

参数:

sceneName - 场景名

layerName - 图层名

返回:

生成的三维瓦片

抛出:

RealspaceException

getTilesRevisionInfo

public RealspaceTilesRevisionInfo getTilesRevisionInfo(java.lang.String dataName,
                                              long revisionNumber)
                                                throws RealspaceException

从接口复制的说明: RealspaceProvider

获取指定版本号的瓦片变更 信息。

指定者:

getTilesRevisionInfo 在接口中 RealspaceProvider

revisionNumber - 版本号。

返回:

变更 信息。

抛出:

RealspaceException

getDataVersion

public java.lang.String getDataVersion(java.lang.String dataName,
                              int xIndex,
                              int yIndex,
                              int level,
                              java.lang.String fileExtension)
                                throws RealspaceException

从接口复制的说明: RealspaceProvider

根据索引获取瓦片数据的最新版本号。

指定者:

getDataVersion 在接口中 RealspaceProvider

参数:

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

从接口复制的说明: RealspaceProvider

根据相对路径获取瓦片数据的最新版本号。

瓦片数据相对路径的设置有以下情况：

• 对于地形和影像三维缓存数据来说，相对路径从缓存配置文件（SCT 和 SCI3D）所在的目录开始，也就是从缓存层号开始，缓存配置文件同级下存放了分层的缓存数据。比如缓存层号为12，那么相对路径为“12/.../.../缓存文件”。
• 对于模型三维缓存数据来说，相对路径从缓存配置文件的父一级目录开始，即从缓存层号目录开始，模型数据与地形和影像数据不同，在分层目录下存放的不是缓存之后的数据，而是模型缓存文件的索引文件（index），版本号指的也是该索引文件的版本号。
• KML 数据没有版本号。

指定者:

getDataVersion 在接口中 RealspaceProvider

参数:

dataName - 三维数据的名称。对应 SuperMap 三维场景中的三维图层的名称（LayerName）。

relativePath - 瓦片数据的相对路径。

返回:

瓦片数据的最新版本号。

抛出:

RealspaceException - 三维异常信息。

getLayerPrj

public PrjCoordSys getLayerPrj(java.lang.String sceneName,
                      java.lang.String layerName)

从接口复制的说明: RealspaceProvider

获取指定图层的投影信息

指定者:

getLayerPrj 在接口中 RealspaceProvider

参数:

sceneName - 场景名

layerName - 图层名

返回:

图层投影信息

getLayerExtendXML

public java.lang.String getLayerExtendXML(java.lang.String sceneName,
                                 java.lang.String layerName)
                                   throws RealspaceException

从接口复制的说明: RealspaceProvider

获取指定图层的图层扩展信息

指定者:

getLayerExtendXML 在接口中 RealspaceProvider

参数:

sceneName - 场景名

layerName - 图层名

返回:

图层扩展信息xml

抛出:

RealspaceException