通过 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_服务组件与服务接口对照表所示。
| 服务组件类型 | 服务接口类型 | 预定义的服务接口 |
| 地图服务组件
（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）
ArcGIS REST 接口（AGSRestServlet） WFS 接口（WFSSServlet） WCS 接口（WCSServlet） |
rest 、arcgisrest1
wfs100、wfs200 wcs111、wcs112 |
| 影像服务组件
（ImageImpl） |
REST/JSR 接口（JaxrsServletForJersey） WMTS 接口（WMTSServlet） |
restjsr,wmts100 |
| 空间分析服务组件
（SpatialAnalystImpl） |
REST/JSR 接口（JaxrsServletForJersey）
WPS 接口（WPSServlet） |
restjsr
wps100 |
| 交通网络分析服务组件
（TransportationAnalystImpl） |
REST 接口（RestServlet）
ArcGIS REST 接口（AGSRestServlet） |
rest、arcgisrest1 |
| 交通换乘分析服务组件
（TrafficTransferAnalystImpl） |
REST/JSR 接口（JaxrsServletForJersey） | restjsr |
| 三维服务组件
（RealspaceImpl） |
REST 接口（RestServlet） | rest |
| 三维网络分析
（NetworkAnalyst3DImpl） |
REST/JSR 接口（JaxrsServletForJersey） | restjsr |
| 空间建模服务组件
（GeoprocessorComponent） |
GP 接口（GeoprocessorServlet） | gpserver |
| 动态标绘服务组件
（PlotImpl） |
REST接口（RestServlet） | rest |
| 地址匹配服务组件
（AddressMatchImpl） |
REST接口（RestServlet） | restjsr |
注1：iServer高级版和iEdge提供该接口。
<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>false</useCache> <tileCacheConfig class="com.supermap.services.tilesource.SMTilesTileSourceInfo"> <datastoretype>TILES</datastoretype> <outputPath>D:/supermap/soft/supermap_iserver/webapps/iserver/output/sqlite</outputPath> </tileCacheConfig> <utfGridCacheConfig class="com.supermap.services.tilesource.UTFGridTileSourceInfo"> <datastoretype>TILES</datastoretype> <type>UTFGrid</type> <outputPath>D:/supermap/soft/supermap_iserver/webapps/iserver/output/sqlite</outputPath> </utfGridCacheConfig> <vectorTileCacheConfig class="com.supermap.services.tilesource.SVTilesTileSourceInfo"> <datastoretype>TILES</datastoretype> <type>SVTiles</type> </vectorTileCacheConfig> <useUTFGridCache>false</useUTFGridCache> <useVectorTileCache>true</useVectorTileCache> <expired>0</expired> <cacheReadOnly>false</cacheReadOnly> </config> </component>
其中<component>节点的 class 属性标识的是地图组件的实现类；providers 属性是地图组件用到的服务提供者（集合），（参见：服务提供者层的配置）；interfaceNames 属性标识的是服务组件绑定的服务接口，多个服务接口之间用“,”分隔，参见：服务接口层的配置。<config>节点是该地图组件实现对应的配置项，对应接口配置类MapConfig，以下参数均为可选参数：
数据服务组件配置示例：
<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> <cacheStrategyConfig> <maxElementInMemory>100</maxElementInMemory> <timeToLiveSeconds>3</timeToLiveSeconds> <timeToIdleSeconds>3</timeToIdleSeconds> </cacheStrategyConfig> </config> </component>
其中，<component>节点的 class 属性标识组件类型，对应实现类 DataImpl，<config>节点是该 Data 组件对应的配置项，即接口配置类DataConfig。主要参数说明：
<editable>属性，表示是否可编辑。当 editable 为 true 时可编辑。
<cacheStrategyConfig>属性，表示数据查询缓存相关设置：
影像服务组件配置示例：
<component class="com.supermap.services.components.impl.ImageImpl" enabled="true" initPriority="0" instanceCount="0" interfaceNames="wmts100,restjsr" name="imageservice-ChinaImages" providers="imageservice-ChinaImages"> <config class="com.supermap.services.components.ImageConfig"> <editable>false</editable> <downloadable>false</downloadable> </config> </component>
其中，<component>节点的 class 属性标识组件类型，对应实现类 ImageImpl，<config>节点是该影像服务组件对应的配置项，即接口配置类ImageConfig。主要参数说明：
<editable>属性，表示是否可编辑。当 editable 为 true 时可编辑。
<downloadable>属性，表示影像数据资产是否可下载，当downloadable为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>
添加一个自定义组件类型，在系统配置文件（iserver-system.xml）中配置，示例如下：
<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>
以数据服务组件为例，示例如下：
<component name="data-world" class="com.supermap.services.components.impl.DataImpl" enabled="true" initOnCreate="true" initPriority="0" instanceCount="0" interfaceNames="rest,wfs100,wfs200,wcs111,wcs112" providers="ugcDataProvider-World"> <config class="com.supermap.services.components.DataConfig"> <editable>true</editable> </config> </component>
其中，对于<component>节点：
<initOnCreate>属性：该服务实例是否需要立即初始化。开启服务实例动态化功能后默认为 false。true 表示服务实例将随着 iServer 启动立即初始化；false 表示不立即初始化，即 iServer 启动后服务实例延迟初始化。
注意，只有开启服务实例动态化功能后，该参数才有效。