com.supermap.services.providers

Class UGCRealspaceProvider

java.lang.Object

com.supermap.services.providers.UGCRealspaceProvider

All Implemented Interfaces:

Disposable, ProviderContextAware, RealspaceProvider

public class UGCRealspaceProvider
extends java.lang.Object
implements RealspaceProvider, ProviderContextAware, Disposable

SuperMap 3D service provider.

UGCRealspaceProvider provides SuperMap map related services, encapsulates with the SuperMap 3D-related GIS functions.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UGCRealspaceProvider.WorkspaceDataRefresh The data in the workspace is modified to refresh the workspace.

Constructor Summary

Constructors

Constructor and Description
UGCRealspaceProvider() The Constructor.
UGCRealspaceProvider(UGCRealspaceProviderSetting setting) Builds the UGCRealspaceProvider object with SuperMap 3D service provider configuration.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	cleanCacheData(java.lang.String dataName) Clears the cache of dynamic publishing data
void	dispose() Release object.
java.lang.String	getCacheAccessKey() Returns the password used to encrypt the cached data.
RealspaceDataResult	getData(RealspaceDataParam dataParam) Gets 3D tile data results.
RealspaceDataResult	getData(java.lang.String dataName, java.lang.String relativePath) Obtains tile data based on relative path.
RealspaceDataResult	getData(java.lang.String sceneName, java.lang.String layerName, RealspaceDataParam dataParam) According to the scene name and layer name and tile parameters three-dimensional tile data results.
RealspaceDataResult	getData(java.lang.String dataName, java.lang.String relativePath, RelativePathType relativePathType) Obtains tile data based on relative path and relative path type.
byte[]	getDataConfig(java.lang.String dataName) Obtains 3D cache data configuration file according to the name of the 3D data.
byte[]	getDataConfig(java.lang.String dataName, CompressType compressType) Gets the configuration file for the 3D cache data by name.
java.util.List<RealspaceDataInfo>	getDataInfos() Gets all the 3D data of the current Provider.
java.lang.Object	getdataSetFromWorkspace(Workspace workspace, java.lang.String dataName) Gets the dataset or map object of the workspace in which the workspace is located
java.lang.String	getDataVersion(RealspaceDataParam dataParam)
java.lang.String	getDataVersion(java.lang.String dataName, int xIndex, int yIndex, int level, java.lang.String fileExtension) Obtain the latest version number of the tile data according to the index.
java.lang.String	getDataVersion(java.lang.String dataName, java.lang.String relativePath) Obtains the latest version number of the tile data according to the relative path.
java.lang.String	getLayerExtendXML(java.lang.String sceneName, java.lang.String layerName) Gets the layer extension information for the specified layer
PrjCoordSys	getLayerPrj(java.lang.String sceneName, java.lang.String layerName) Gets the projection information for the specified layer
byte[]	getModelIndex(java.lang.String dataName) The model index file of the 3D model cache data is obtained according to the name of the 3D data.
java.util.List<OfflineDataInfo>	getOfflineDataPaths(java.lang.String sceneName, java.lang.String layerName) Gets the location information for all data offline packages for a particular 3D scene
SceneInfo	getSceneInfo(java.lang.String sceneName) According to the name of the 3D scene, gets the information of the 3D scene.
java.util.List<java.lang.String>	getSceneNames() Gets the name of all available 3D scenes for the current service provider.
RealspaceTilesRevisionInfo	getTilesRevisionInfo(java.lang.String dataName, long revisionNumber) Gets the tile change information for the specified version number.
byte[]	getVectorIndex(java.lang.String dataName) Obtains the index file of the 3D vector cache data by name.
boolean	isDataAvailable(java.lang.String dataName) Whether the three-dimensional data is available.
boolean	isSceneAvailable(java.lang.String sceneName) Whether the 3D scene is available.
boolean	isSecurityEnabled() Whether the security mechanism is enabled.
RealspaceDataResult[]	outputDataToMemory(java.lang.String sceneName, java.lang.String layerName, Output3DDataToMemoryParam outputParam) Generates 3D tiles into memory based on scene name and layer name
void	pauseForRefreshWorkspace() Block requests to refresh the workspace.
void	refreshWorkspace() refreshes the workspace.
void	refreshWorkspaceFinished() Ends refreshing the workspace, then continues the request.
void	setProviderContext(ProviderContext context) Sets the service provider context

Methods inherited from class java.lang.Object

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

Constructor Detail

UGCRealspaceProvider

public UGCRealspaceProvider()

The Constructor.

UGCRealspaceProvider

public UGCRealspaceProvider(UGCRealspaceProviderSetting setting)

Builds the UGCRealspaceProvider object with SuperMap 3D service provider configuration.

Parameters:

setting - uperMap 3D service provider setting configures.

Method Detail

getData

public RealspaceDataResult getData(RealspaceDataParam dataParam)
                            throws RealspaceException

Description copied from interface: RealspaceProvider

Gets 3D tile data results.

Specified by:

getData in interface RealspaceProvider

Parameters:

dataParam - Tile parameters.

Throws:

RealspaceException

getData

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

Description copied from interface: RealspaceProvider

According to the scene name and layer name and tile parameters three-dimensional tile data results.

Specified by:

getData in interface RealspaceProvider

Parameters:

sceneName - Scene name.

layerName - Layer name.

dataParam - Tile parameters.

Throws:

RealspaceException

outputDataToMemory

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

Description copied from interface: RealspaceProvider

Generates 3D tiles into memory based on scene name and layer name

Specified by:

outputDataToMemory in interface RealspaceProvider

Parameters:

sceneName - Scene name.

layerName - Layer name

Returns:

The generated three-dimensional tiles

Throws:

RealspaceException

getData

public RealspaceDataResult getData(java.lang.String dataName,
                          java.lang.String relativePath)
                            throws RealspaceException

Obtains tile data based on relative path.

The setting of the relative data of the tile data is as follows:

For terrain and image 3D cache data, the relative path starts with the directory where the cache configuration file (SCT and SCI3D) resides, that is, from the cache layer number, the hierarchical cache data is stored in the cache configuration file. Such as the cache layer number is 12, then the relative path is "12 /.../.../ cache file". For the three-dimensional cache data of the model, the relative path starts from the parent-level directory of the cache configuration file, that is, the same level as the cache layer number. The model data is different from the terrain and image data. In the hierarchical directory, it is not the data after the cache, but the index of the model cache file. The cache data file (SGM) is stored in the directory of the cache configuration file. For KML data, the relative path is set to a KML file.

Parameters:

dataName - The name of the 3D data. Corresponds to the name of the 3D layer in the SuperMap 3D scene (LayerName).

relativePath - the relative path of tile data.

Returns:

tile data results.

Throws:

RealspaceException - 3D exception information.

getData

public RealspaceDataResult getData(java.lang.String dataName,
                          java.lang.String relativePath,
                          RelativePathType relativePathType)
                            throws RealspaceException

Obtains tile data based on relative path and relative path type.

If the relative cache configuration file is set, the settings for the tile data relative path are as follows:

• For terrain and image 3D cache data, the relative path starts with the directory where the cache configuration file (SCT and SCI3D) resides, that is, from the cache layer number, the hierarchical cache data is stored in the cache configuration file. Such as the cache layer number is 12, then the relative path is "12 /.../.../ cache file".
• For the three-dimensional cache data of the model, the relative path starts from the parent-level directory of the cache configuration file, that is, the same level as the cache layer number. The model data is different from the terrain and image data. In the hierarchical directory, it is not the data after the cache, but the index of the model cache file. The cache data file (SGM) is stored in the directory of the cache configuration file.
• For KML data, the relative path is set to a KML file.