配置数据服务提供者

SuperMap iServer 支持以下类型的数据服务提供者：

• 配置本地数据服务提供者
• 配置 REST 数据服务提供者
• 配置 ArcGIS REST 数据服务提供者
• 配置 WFS 数据服务提供者
• 配置 GeoPackage 数据服务提供者

配置本地数据服务提供者

配置一个本地数据服务提供者，如下所示：

<provider name="ugcDataProvider1" class="com.supermap.services.providers.UGCDataProvider">
        <config class="com.supermap.services.providers.UGCDataProviderSetting">
                <workspacePath>../../samples/data/World/World.sxwu</workspacePath>
                <excludedFieldsInDatasources>
                   <com.supermap.services.providers.ExcludedFieldsInDatasource>
                       <dataSourceName>World</dataSourceName>
                 <!-- 设置排除字段 -->      
                       <excludedFieldsInDatasets>
                            <com.supermap.services.providers.ExcludedFieldsInDataset>
                                 <datasetName>Countries</datasetName>
                                 <excludedFields>SMID,SmUserID</excludedFields>
                            </com.supermap.services.providers.ExcludedFieldsInDataset>
                       </excludedFieldsInDatasets>
                 <!-- 延迟提交配置 -->                      
                     <dataProviderDelayCommitSetting>                             
                            <enabled>false</enabled>  
                            <logEntireErrorMsg>true</logEntireErrorMsg>  
                            <dayOfWeek>1,2,3,4,5,6,7</dayOfWeek>  
                            <hour>3</hour>  
                            <minute>0</minute>  
                            <commitMode>SPECIFICTIME</commitMode>
                            <countToCommit>1000</countToCommit>  
                            <updateInterval>300</updateInterval>
                            <cachePath>/output</cachePath>
                       </dataProviderDelayCommitSetting> 
                   </com.supermap.services.providers.ExcludedFieldsInDatasource>
                </excludedFieldsInDatasources>
        </config>
</provider>

其中<provider>中的 class 标识的是本地数据服务提供者的实现类，<config>中的 class 标识的是本地数据服务提供者对应的配置类，即 UGCDataProviderSetting，<config>中的内容是相应的配置项。

• <workspacePath>：该服务提供者所用的工作空间的路径。若工作空间有密码，假设密码为 supermap，则写为：   

• <workspacePath>server=../samples/data/World/World.sxwu;password=supermap</workspacePath> 

  此外，工作空间路径支持从环境变量和系统配置文件中读取。可写为：

  <workspacePath>server=${datapath1}/World.sxwu;password=supermap</workspacePath> 

  详细说明请参见：预设本地工作空间路径
• <excludedFieldsInDatasources>:此参数为可选参数，用于设置排除字段。管理员可以根据需要，排除指定数据集的字段，当用户进行数据集字段查询操作时，将查看不到已排除的字段。

其中，com.supermap.services.providers.ExcludedFieldsInDatasource、com.supermap.services.providers.ExcludedFieldsInDataset为字段排除设置实现类。<dataSourceName>为数据源名称，<datasetName>为数据集名称，<excludedFields>指定排除的字段。

•  <dataProviderDelayCommitSetting>： 要素操作延迟提交设置。开启此设置时，对要素执行编辑操作后，系统将根据设置的时间，延迟提交已执行的操作。参数为可选参数。不设置时，对要素的编辑操作将同步提交并立即生效。当数据为允许编辑时，此参数可用。具体设置包括：
• <enabled>：是否开启延迟提交。
• <logEntireErrorMsg>：是否开启控制台错误日志。开启后，当操作出现错误时，详细错误信息将在控制台显示。
• <commitMode>：设置提交方式，包括定时提交SPECIFICTIME 和间隔提交INTERVALUPDATE 。定时提交表示在具体时间点进行批量提交，需要设置<dayOfWeek>、<hour>、<minute>。间隔提交表示每隔一段时间进行一次批量提交。需设置<updateInterval>参数。
• <countToCommit>：最大请求数。提交方式为间隔提交( INTERVALUPDATA) 时有效。例如设置为1000，到达指定的时间前，如果数据编辑请求数量已达到1000条，系统将自动提交这些操作。
• <dayOfWeek>：设定更新的周期。例如<dayOfWeek>1,3,5</dayOfWeek>表示每周的周一、周三及周日自动提交已执行的操作。<commitMode>的值为SpecificTime时，此参数可用。
• <hour>：设定提交时间的小时数（24小时制）。<commitMode>的值为SPECIFICTIME 时，此参数可用。
• <minute>：设定提交时间的分钟数。<commitMode>的值为SpecificTime时，此参数可用。
• <updateInterval>：提交间隔，单位为秒。例如<updateInterval>300</updateInterval>表示每隔300秒更新一次数据。当 <commitMode>为IntervalUpdate时，参数可用。
• <cachePath>：操作信息的存储地址。到指定的提交时间时，系统自动将这些操作信息文件提交至后台，完成要素编辑。

配置 REST 数据服务提供者

配置一个 REST 数据服务提供者，如下所示：

<provider name="restMapProvider1" class="com.supermap.services.providers.RESTDataProvider">
        <config class="com.supermap.services.providers.RESTDataProviderSetting">
                <restServiceRootURL>http://localhost:8090/iserver/services/rest</restServiceRootURL>
                <token>GsXST0cE0CumxQUFXBX7Oopin4<token>
        </config>
</provider>

其中<provider>中的 class 标识的是 REST 数据服务提供者的实现类，<config>中的 class 标识的是 REST 数据服务提供者对应的配置类，即 RestDataProviderSetting，<config>中的内容是相应的配置项：

• <restServiceRootURL>：REST 数据服务的地址，指向服务的根资源路径，如 http://localhost:8090/iserver/services/data-world/rest。
• <useCache>：是否使用缓存。默认为 true。开启缓存后，对资源的 REST 请求会缓存在本地，下次收到同样的请求就直接在缓存中读取，不需要再向服务端发送。
• <restProviderCacheConfig>：服务提供者历史请求缓存在内存中的存储设置，包括：
• <maxElementsInMemory>：内存中允许存储的最大请求记录数。0代表无限制；1代表不使用内存缓存，默认为1。如果不为1，则优先向内存中存储请求记录。
• <maxSizeOnDisk>：磁盘最大容量。单位为 MB，默认大小为2048MB。
• <timeToLiveSeconds>：设置缓存存活的时间上限，超时后会自动清除缓存。从创建记录开始计算，单位为秒，默认为0，代表缓存永久存活。
• <timeToIdleSeconds>：设置缓存闲置的时间上限，超时后会自动清除缓存。从上次被访问开始计算，单位为秒，默认为0，代表缓存永久存活。
• <token>、<httpReferer>：启用安全机制的情况下，访问受保护的服务需要提供Token 令牌。如果使用的 Token 是以 HTTP referer 方式申请的，则需要设置相应的<httpReferer>。

配置 ArcGIS REST 数据服务提供者

配置一个 ArcGIS  REST 数据服务提供者，如下所示：

<provider class="com.supermap.services.providers.ArcGISRestDataProvider" enabled="true" name="arcgisRestDataProvider-test"> 
      <config class="com.supermap.services.providers.ArcGISRestDataProviderSetting"> 
        <restServiceRootURL>http://localhost:6080/arcgis/rest/services/SampleWorldCities/FeatureServer</restServiceRootURL>  
        <token>51fda53ceb25478cb37fa059ab013160</token>  
      </config> 
    </provider>

其中<provider>中的 class 标识的是 ArcGIS REST 数据服务提供者的实现类，<config>中的 class 标识的是 ArcGIS REST 数据服务提供者对应的配置类，即 ArcGISRestDataProviderSetting，<config>中的内容是相应的配置项：

• <restServiceRootURL>：ArcGIS REST 要素服务的地址，指向服务的根资源路径。
• <token>、<httpReferer>：启用安全机制的情况下，访问受保护的服务需要提供Token 令牌。如果使用的 Token 是以 HTTP referer 方式申请的，则需要设置相应的<httpReferer>。

配置 WFS 数据服务提供者

配置一个 WFS 数据服务提供者，如下所示：

<provider class="com.supermap.services.providers.WFSDataProvider"
        enabled="true" name="wfsDataProvider-test">
        <config class="com.supermap.services.providers.WFSDataProviderSetting">
                <serviceRootURL>http://localhost:8090/iserver/services/data-world/wfs100/utf-8</serviceRootURL>
        </config>
</provider>

其中<provider>中的 class 标识的是 REST 数据服务提供者的实现类，<config>中的 class 标识的是 REST 数据服务提供者对应的配置类，即 WFSDataProviderSetting，<config>中的内容是相应的配置项：

• <serviceRootURL>：数据服务的访问路径。
• <idMappingClassName>：FeatureID 转换器类名。针对不同的 WFS 服务实现，对要素 ID 的转换规则是不同的，因此在访问一个 WFS 服务时，需要提供一个 FeatureID 转换器，用于在 WFS 服务的要素 ID 与整数之间建立一一映射。SuperMap iServer 默认取 WFS 服务要素 ID 的结尾数字转换为整数，作为要素 ID 值。用户自定义转换规则时，需要对 FeatureIDMapping 接口进行实现。

配置 GeoPackage 数据服务提供者

配置一个 GeoPackage 数据服务提供者，如下所示：

<provider class="com.supermap.services.providers.GeoPackageDataProvider"  enabled="true"  name="gpkgData-samplevectors">  
      <config class="com.supermap.services.providers.GeoPackageDataProviderSetting"> 
             <filePath>../../samples/sample_vectors.gpkg</filePath>  
      </config>  
</provider> 

其中<provider>中的 class 标识的是 GeoPackage 数据服务提供者的实现类，<config>中的 class 标识的是 GeoPackage 数据服务提供者对应的配置类，即 GeoPackageDataProviderSetting，<config>中的内容与 GeoPackageDataProviderSetting  中的配置项相对应：

• <filePath>： GeoPackage 数据库文件的路径。