通过 XML 文件配置服务组件

发送反馈

服务组件对不同服务提供者的功能进行组合和封装，封装成粒度较粗的模块，例如地图组件、数据组件等，同时支持将一个或多个服务组件组装成服务组件集合提供服务。服务组件的配置是在<component>节点中进行，服务组件集合的配置在<componentSet>节点中进行。

服务组件和服务组件集都可以与服务接口相结合来提供服务实例，假设已配置了一个名为 rest 的 REST 服务接口（参见：服务接口层的配置），在以上 map-world 组件的配置中，已经绑定了“rest”接口，则 map-world 组件与 rest 服务接口组合提供的服务实例的 URI 依次如下：

http://<server>:<port>/iserver/services/map-world/rest

http://<server>:<port>/iserver/services/components-rest/rest

分别表示 map-world 服务组件包含的 REST 服务的根目录和 components-rest 组件集包含的 REST 服务的根目录，通过后者，可以访问到 map-world、data-world、3D-sample、transportationanalyst-sample 几个服务组件包含的全部 REST 服务。

其中，不同服务组件绑定的服务接口类型也是不完全相同的，目前 SuperMap iServer 中服务组件与服务接口的对应情况如表1_服务组件与服务接口对照表所示。

表1 服务组件与服务接口对照表

服务组件类型	服务接口类型	预定义的服务接口
地图服务组件（MapImpl）	REST 接口（RestServlet） ArcGIS REST 接口（AGSRestServlet） Baidu REST 接口（BaiduRestServlet） Google REST 接口（GoogleRestServlet） WMS 接口（WMSServlet） WMTS 接口（WMTSServlet）	rest、arcgisrest1、baidurest1、googlerest1 wms111、wms130 wmts100、wmts-china
数据服务组件（DataImpl）	REST 接口（RestServlet） WFS 接口（WFSSServlet） WCS 接口（WCSServlet）	rest wfs100、wfs200 wcs111、wcs112
空间分析服务组件（SpatialAnalystImpl）	REST/JSR 接口（JaxrsServletForJersey） WPS 接口（WPSServlet）	restjsr wps100
交通网络分析服务组件（TransportationAnalystImpl）	REST 接口（RestServlet）	rest
交通换乘分析服务组件（TrafficTransferAnalystImpl）	REST/JSR 接口（JaxrsServletForJersey）	restjsr
三维服务组件（RealspaceImpl）	REST 接口（RestServlet）	rest
三维网络分析（NetworkAnalyst3DImpl）	REST/JSR 接口（JaxrsServletForJersey）	restjsr
空间建模服务组件（GeoprocessorComponent）	GP 接口（GeoprocessorServlet）	gpserver
动态标绘服务组件（PlotImpl）	REST接口（RestServlet）	rest

注1：在iServer中使用该接口，需购买服务分发扩展模块，iExpress 可直接使用。

服务组件配置基本结构
地图组件配置
数据服务组件配置
服务组件集合配置
自定义服务组件配置

服务组件配置基本结构

<component> 和 <componentSet> 在配置文件中的结构如下所示：

<application>
                ...
                <componentSets>
                        ...
                        <componentSet>
                              ...
                        <componentSet/>
                </componentSets>
                <components>
                        ...
                        <component>
                             ...
                        <component/>
                </components>
</application>

地图组件配置

地图服务组件配置示例：

<component name="map-china400" class="com.supermap.services.components.impl.MapImpl"
     interfaceNames="rest,wms111,wms130,wmts100,wmts-china" providers="ugcMapProvider-China400">
        <config class="com.supermap.services.components.MapConfig">
        <useCache>true</useCache> 
        <tileCacheConfig class="com.supermap.services.tilesource.SMTilesTileSourceInfo"> 
            <outputPath>E:/iserver/smiserver_700_10809_3995_win32_chs_zip/webapps/iserver/output/sqlite</outputPath> 
        </tileCacheConfig>  
        <utfGridCacheConfig class="com.supermap.services.tilesource.UTFGridTileSourceInfo"> 
            <type>UTFGrid</type>  
            <outputPath>E:/iserver/smiserver_700_10809_3995_win32_chs_zip/webapps/iserver/output/sqlite</outputPath> 
        </utfGridCacheConfig>  
        <vectorTileCacheConfig class="com.supermap.services.tilesource.SVTilesTileSourceInfo"> 
            <type>SVTiles</type>  
            <outputPath>E:/iserver/smiserver_700_10809_3995_win32_chs_zip/webapps/iserver/output/sqlite</outputPath> 
        </vectorTileCacheConfig>  
        <expired>0</expired> 
        <cacheReadOnly>false</cacheReadOnly> 
        </config>
</component>

其中<component>节点的 class 属性标识的是地图组件的实现类；providers 属性是地图组件用到的服务提供者（集合），（参见：服务提供者层的配置）；interfaceNames 属性标识的是服务组件绑定的服务接口，多个服务接口之间用“,”分隔，参见：服务接口层的配置。<config>节点是该地图组件实现对应的配置项，对应接口配置类MapConfig，以下参数均为可选参数：

<outputPath>：瓦片的存储位置，可以根据需要更改。
<useCache>：是否使用缓存。
<cacheReadOnly>：缓存文件是否可以编辑。
<expired>：瓦片过期时间。从瓦片创建开始计算瓦片存活时间。时间单位为分钟，0代表缓存永不过期。该配置只对栅格瓦片缓存，属性瓦片缓存，矢量瓦片缓存有效。对 FastDFS 和 MongoDB 无效。
<tileCacheConfig>：地图瓦片配置类，瓦片类型支持 SMTiles、FastDFS、MongoDB、GDP。关于瓦片格式的详细介绍，请参考：瓦片格式。
当瓦片类型为 SMTiles 时，对应类为 com.supermap.services.tilesource.SMTilesTileSourceInfo
当瓦片类型为 FastDFS 时，对应类为 com.supermap.services.tilesource.FastDFSTileSourceInfo
当瓦片类型为 MongoDB 时，对应类为 com.supermap.services.tilesource.MongoDBTileSourceInfo
当瓦片类型为 GDP 时，对应类为com.supermap.services.tilesource.GDPTileSourceInfo
<utfGridCacheConfig>：属性瓦片配置类，瓦片类型支持 UTFGrid，对应类为 com.supermap.services.tilesource.UTFGridTileSourceInfo。
<vectorTileCacheConfig>：矢量瓦片配置类，瓦片类型支持 SVTilesTileSourceInfo，对应类为 com.supermap.services.tilesource.SVTilesTileSourceInfo。
<type>：瓦片缓存类型，当缓存类型为 SMTiles 时，此项可以省略。

数据服务组件配置

数据服务组件配置示例：

<component name="data-world" class="com.supermap.services.components.impl.DataImpl"
           interfaceNames="rest,wfs100,wfs200,wcs111,wcs112" providers="ugcDataProvider-World"> 
      <config class="com.supermap.services.components.DataConfig">
            <editable>true</editable>
      </config> 
</component>

其中，<component>节点的 class 属性标识组件类型，对应实现类 DataImpl，<config>节点是该 Data 组件对应的配置项，即接口配置类DataConfig。主要参数说明：

<editable>属性，表示是否可编辑。当 editable 为 true 时可编辑。

服务组件集合配置

<componentSet>节点可以将一个或多个服务组件组装成服务组件集，一个<componentSet>节点的示例如下：

<componentSet name="components-rest">
        <component-reference  name="map-world"></component-reference>
        <component-reference  name="3D-sample"></component-reference>
        <component-reference  name="data-world"></component-reference>
        <component-reference  name="transportationanalyst-sample"></component-reference>
</componentSet>

自定义服务组件配置

添加一个自定义组件类型的示例如下：

<component-type  alias="SuperMap 自定义服务组件" configClass="com.supermap.services.components.SMConfig">
   com.supermap.services.components.impl.SMImpl
</component-type>

其中 com.supermap.services.components.impl.SMImpl 是自定义的服务组件类型的实现类，com.supermap.services.components.SMConfig 是自定义的服务组件类型的配置类。

<component-type>节点在配置文件中的结构如下所示：

<server>
     <management>
              …
         <component-types>
                  …
               <component-type>
                      …
               </component-type> 
 
         </component-types>
      </management>
</server>