配置影像服务提供者

配置一个影像服务提供者，如下所示：

 <provider class="com.supermap.services.providers.UGCImageServiceProvider" enabled="true" name="imageservice-ChinaImages"> 
      <config class="com.supermap.services.providers.ImageProviderSetting"> 
        <id>ChinaImages</id>
        <title>ChinaImages</title>
        <collectionConfigs> 
          <com.supermap.services.components.ImageCollectionSetting> 
            <id>ChinaTIFF</id>
            <title>全国 .tif 格式影像数据</title>
            <crs>EPSG:4326</crs>
            <dataConnectionInfo>
              <type>IMAGEFOLDER</type>
              <server>H:\ChinaImages</server>
              <ext>.tif</ext>
              <datasetName>ChinaTIFF</datasetName>
            </dataConnectionInfo>
            <editable>false</editable>
            <downloadable>false</downloadable>
            <cacheEnable>true</cacheEnable>
          </com.supermap.services.components.ImageCollectionSetting>
        </collectionConfigs>
        <description>覆盖中国区域的影像数据，坐标系为WGS84</description>
        <datasourceConnectionInfo>
          <engineType>UDBX</engineType>
          <server>E:/imageserver/imageService/ChinaImages.udbx</server>
        </datasourceConnectionInfo>
        <outputPath>../../webapps/iserver/output</outputPath>
        <outputSite>http://{ip}:{port}/iserver/output/</outputSite> 
      </config> 
</provider>

其中<provider>中的 class 标识的是 UGC 服务提供者的实现类，<config>中的 class 标识的是服务提供者对应的配置类，即 ImageProviderSetting 。

下面详细介绍<provider>中的配置内容，<provider>中配置内容分为两大部分：第一：基本信息配置。第二：服务中影像结合配置（<collectionConfigs>）。

基本信息配置

<id>：影像服务配置的 ID。
<title>影像服务配置的名称。
<description>：影像服务的详细描述。
<datasourceConnectionInfo>：数据源连接信息配置。用来指定存储影像集合的数据源。影像服务中的影像会组织在影像集合中，影像集合则存储在一个 SuperMap 数据源中，支持UDBX文件型数据源和PostGIS、PostgreSQL数据库型数据源。
- <engineType>：数据源类型，支持两种：UDBX：UDBX文件型数据源；PostGIS：PostGIS数据库型数据源；PostgreSQL：PostgreSQL数据库型数据源。根据选择的数据源类型，选择性地完成<datasourceConnectionInfo>下面的配置项。
- <server>：若数据源类型为UDBX，则为UDBX数据源文件的路径；若数据源类型为数据库型数据源，则为数据库服务器地址。
- <database>：若数据源类型为数据库型数据源，则为数据库名称。
- <user>：若数据源类型为数据库型数据源，则为数据库访问用户名。
- <password>：若数据源类型为数据库型数据源，则为数据库访问密码。

影像集合配置

影像服务中的影像会组织在影像集合中，一个影像服务可以包含多个影像集合，同一影像集合中只能添加相同像素格式和波段数目的影像。

<com.supermap.services.components.ImageCollectionSetting> 为一个影像服务集合的配置，因此，<collectionConfigs>下可以包含多个<com.supermap.services.components.ImageCollectionSetting> 。

下面详细介绍影像集合配置项：

<id>：影像集合ID，用来在服务中唯一标识该影像集合。
<title>影像集合的标题，有别于id，title没有字符限制。
<keywords> 关键字，可以包含多个关键字，并以“,”逗号分隔。
<dataConnectionInfo>：影像数据配置，用来配置集合中影像数据的来源。
- <type>：指定集合中影像数据的来源，影像的来源可以通过以下几种方式提供：
  1. 影像数据目录，该参数值设置为：IMAGEFOLDER。
  2. 清单文件，该参数值设置为：LISTFILE，一个.txt文件，该文件内容为影像文件路径的列表，一行记录对应一个影像文件的全路径。
  3. 单个影像文件，该参数值设置为：SINGLEFILE。
  4. UDBX文件型数据源或PostGIS、PostgreSQL数据库型数据源中的镶嵌数据集。该参数值设置为：DATASET。
- <server>：配置影像数据来源，根据“<type>”值的不同，该参数值内容也不同：
  1. type值为IMAGEFOLDER，该参数值为影像数据目录路径且支持多个目录路径，需要通过“<recursive>”指定是否搜索子文件夹中的文件；还需要通过“<ext>”指定添加的影像文件类型。
  2. type值为LISTFILE，该参数值为清单文件（.txt）的路径。
  3. type值为SINGLEFILE，该参数值为一个影像文件的路径。
  4. type值为DATASET，该参数的值为镶嵌数据集所在的数据源，若数据源为UDBX文件型数据源，该参数值为UDBX数据源文件路径；若数据源为PostGIS、PostgreSQL数据库型数据源，该参数值为数据库服务器地址，此外，还需要进一步设置数据库名称、用户名、密码参数。
- <ext>：指定添加的影像文件类型，即影像文件扩展名，可以指定多个文件扩展名并以“,”逗号分隔，如：.tif,.img,.ecw。
- <recursive>：是否搜索子文件夹中的文件。
- <database>：数据库名称。
- <user>：数据库访问用户名。
- <password>：数据库访问密码。
- <datasetName>：若集合的影像数据来源为已有的镶嵌数据集，这里指定镶嵌数据集名称；若集合的影像数据来源非已有的镶嵌数据集，该参数值为影像集合数据集名称。
- <cacheEnable>：是否启用缓存；该参数值为true，表示启用缓存，在浏览该集合中的影像时，缓存动态生成的瓦片；false表示关闭缓存。
- <downloadable>：影像集合中的影像数据资产是否支持下载，该参数值为true，表示支持下载；false表示不支持下载。