Configuring spatial analysis service provider

SuperMap iServer supports the following types of spatial analysis service providers:

• Local spatial analysis service provider
• REST spatial analysis service provider

Local spatial analysis service provider

Configure a UGC spatial analysis service provider as illustrated below:

<!-- UGC spatial analysis provider-->
<provider class="com.supermap.services.providers.UGCSpatialAnalystProvider" name="ugcSpatialProvider"> 
        <config class="com.supermap.services.providers.UGCSpatialAnalystProviderSetting">
                <workspacePath>../../samples/data/SpatialAnalyst/spatialAnalyst.sxwu</workspacePath>
        </config>
</provider> 

Where the class of <provider> identifies the implementation class of the UGC spatial analysis service provider, the class of <config> identifies the UGCSpatialAnalystProviderSetting, and the content of <config> is its corresponding configuring items:

<workspacePath> represents the path of the workspace used by the service provider. In addition, the workspace path supports reading from environment variables and system configuration files. It can be written as:

<workspacePath>${datapath1}/World.sxwu</workspacePath> 

REST spatial analysis service provider

Configure a REST spatial analysis service provider as illustrated below:

<!-- REST spatial analysis provider-->
<provider class="com.supermap.services.providers.RestSpatialAnalystProvider" name="restSpatialProvider"> 
        <config class="com.supermap.services.providers.RestSpatialAnalystProviderSetting">
                <restServiceRootURL>http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr</restServiceRootURL>
                <restProviderCacheConfig>
                        <maxElementsInMemory>1</maxElementsInMemory>
                        <maxSizeOnDisk>2048</maxSizeOnDisk>
                        <timeToLiveSeconds>0</timeToLiveSeconds>
                        <timeToIdleSeconds>0</timeToIdleSeconds>
                </restProviderCacheConfig>
                <useCache>true</useCache>
        </config>
</provider> 

Where the class of <provider> identifies the implementation class of the REST spatial analysis service provider, the class of <config> identifies the RestSpatialAnalystProviderSetting, and the content of <config> is its corresponding configuring items:

• <restServiceRootURL>: REST spatial analysis service address, pointing at the root resource path, such as http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr.
• <useCache>: Whether to use caches. Default is true. After opening the REST cache, the REST request to the resource will be cached locally. For the later same requests will be read directly in the cache.
• <restProviderCacheConfig>: The storage settings about the historical request cache of the provider in the memory, including
• <maxElementsInMemory>: The maximum of records in the memory. 0 denotes unlimited; 1 denotes not to use the cache of the memory. Default is 1. If not 1, then the request will be stored in the memory in precedence.
• <maxSizeOnDisk>: The maximum capacity of the disk. Unit is MB, and default is 2048MB.
• <timeToLiveSeconds>:Sets the upper limit for the survival of the cache, beginning at the creation of the record. The cache is automatically removed after the limit. Unit is second. Default is 0, denoting permanent survival.
• <timeToIdleSeconds>:Sets the upper limit for the idle time of the cache, beginning at the last visit. The cache is automatically removed after the limit. Unit is second. Default is 0, denoting permanent survival.
• <token>: When enabling the security mechanism, visiting the protected REST resource needs to provide Token .