服务聚合的配置

SuperMap iServer 服务聚合是指将不同类型、不同来源的服务通过标准化流程整合到 SuperMap iServer 体系中，并通过统一的方式发布给 GIS 客户端。

SuperMap iServer 可以将不同来源的地图聚合成一幅地图展现给客户端，例如将来自 World.sxwu 工作空间的“世界地图”和来自 Jingjin.sxwu 工作空间的“京津地区人口分布图_专题图”，聚合成一幅地图“aggMap”，“aggMap”是一幅涵盖了“世界地图”和“京津地区人口分布图_专题图”所有内容的地图，客户端通过使用“aggMap”可以获取所有的地图功能，而不需要知道服务器端的实现细节。同样的，SuperMap iServer 还可以将不同类型的服务聚合，例如将来自一个 WMS 服务的“中国地图”聚合到上述“aggMap”中，使“aggMap” 涵盖“世界地图”、“京津地区人口分布图_专题图”和“中国地图”的所有内容。

SuperMap iServer 的服务聚合是在服务提供者层实现的，服务聚合的配置通过服务提供者的配置进行。SuperMap iServer 提供了聚合服务提供者（AggregationMapProvider 等）用于实现服务聚合。

基本流程

服务聚合的基本操作流程：

准备待聚合的服务提供者，需确保坐标系一致
创建聚合服务提供者（聚合器）
创建 GIS 服务组件
关联聚合服务发布的接口，如 REST

聚合地图服务

SuperMap iServer 提供了 AggregationMapProvider 用于实现地图功能的聚合，即聚合不同地图，提供完整的地图功能。不同类型、不同来源的地图在服务提供者层被组织为地图服务提供者，AggregationMapProvider 就是针对这些地图服务提供者进行聚合,AggregationMapProvider 支持聚合天地图地图服务提供者（即 TiandituMapProvider）。有关 SuperMap iServer 提供的地图服务提供者详细介绍，请参见：服务提供者。

AggregationMapProvider 可以通过管理界面和配置文件两种方式进行配置。

管理界面配置方式

打开服务管理器，在“服务/服务提供者”选项卡下，点击添加服务提供者，如下图所示：

在弹出的对话框的服务提供者类型一项选择“聚合地图服务提供者”，选择需要聚合的服务提供者名称（服务管理器会自动列出可以聚合的地图服务提供者供选择），添加到选中列表中，然后填写聚合后的地图名称、聚合名称、参与聚合的地图名称，即可以成功添加一个聚合地图服务提供者。

注意：这里的地图聚合顺序与“选中的服务提供者名称”顺序一致，聚合后的效果为京津地区地图在上，世界地图_Night 在下。若地图名称填写错误，则出图为对应 provider 发布的地图列表里的第一幅地图。

配置文件配置方式

iServer 支持通过修改用户自定义服务配置文件（iserver-services.xml）来添加聚合服务提供者，详见服务配置文件结构。

现以 iServer 提供的示例服务（iserver-services-samples.xml）为例，添加服务提供者需要为<providers>节点添加一个子节点<provider>，配置一个 AggregationMapProvider 的示例如下：

<!-- 地图聚合服务提供者，注意，目前使用地图聚合服务提供者的时候，
       所有涉及到的 Provider 和 MapImpl 的配置中，缓存图片访问路径的端口号都要固定，不能用{port}来代替。
-->
<provider name="jingjinworld" inner-providernames="ugcMapProvider-Jingjin,ugcMapProvider-World" class="com.supermap.services.providers.AggregationMapProvider">
        <config class="com.supermap.services.providers.AggregationMapProviderSetting">
                        <outputPath>../webapps/output</outputPath>
                        <outputSite>http://localhost:8090/output/</outputSite>
                        <name>jingjinworld</name>
                        <targetName>jingjinworld</targetName>
                        <mapNames>
                                <String>京津地区地图</String>
                                <String>世界地图_Night</String>
                        </mapNames>
        </config>
</provider>

在<provider>节点中，inner-providerNames 属性是配置文件中已经配置的、需要聚合的服务提供者的名称，可以有多个，以“,”分隔，class 属性是聚合服务提供者的实现类，为 AggregationMapProvider。聚合服务提供者对应的配置类为 AggregationMapProviderSetting，其配置项含义如下：

<outputPath>：图片的输出路径。
<outputSite>：访问图片的根目录 URI。
<name>：聚合服务提供者配置的名称。
<targetName>：聚合后的地图名称，这里为 jingjinworld。
<mapNames>：用于聚合的地图名称列表，这里为京津地区地图和世界地图_Night。
<expandScales>：默认值为 false。当该值为 true 时，表示对由瓦片发布的聚合服务浏览出图时能够以最大比例尺较大的瓦片为准放大其他瓦片的比例尺层级进行出图，最多支持放大两级。

注意：以配置文件方式配置时，在 inner-providernames 参数中，填写在前面的 provider 对应的地图在上，这里聚合后的效果为京津地区地图在上，世界地图_Night 在下。若地图名称填写错误，则出图为对应 provider 发布的地图列表里的第一幅地图。

聚合地图服务提供者可以被地图组件使用，发布地图服务。

聚合数据服务

SuperMap iServer 提供了 AggregationDataProvider 用于实现数据功能的聚合，即聚合不同的数据源。有关 SuperMap iServer 提供的数据服务提供者详细介绍，请参见：服务提供者。

AggregationDataProvider 可以通过管理界面和配置文件两种方式进行配置。

管理界面配置方式

打开服务管理器，在“服务/服务提供者”选项卡下，点击添加服务提供者，如下图所示：

在弹出的对话框的服务提供者类型一项选择“聚合数据服务提供者”，选择需要聚合的服务提供者名称（服务管理器会自动列出可以聚合的数据服务提供者供选择），添加到选中列表中，然后填写聚合后的数据源名称、数据源描述信息，即可以成功添加一个聚合数据服务提供者。

配置文件配置方式

iServer 支持通过修改用户自定义服务配置文件（iserver-services-user.xml）来添加聚合服务提供者，详见服务配置文件结构。

现以 iServer 提供的示例服务（iserver-services-samples.xml）为例，添加服务提供者需要为<providers>节点添加一个子节点<provider>，配置一个 AggregationDataProvider 的示例如下：

<provider name="aggDataProvider" inner-providerNames="ugcDataProvider-World,ugcDataProvider-Changchun"
                                class="com.supermap.services.providers.AggregationDataProvider">
        <config class="com.supermap.services.providers.AggregationDataProviderSetting">
                        <name>aggData</name>
                        <description></description>
        </config>
</provider>

在<provider>节点中，inner-providerNames 属性是配置文件中已经配置的、需要聚合的服务提供者的名称，可以有多个，以“,”分隔，class 属性是聚合服务提供者的实现类，为 AggregationDataProvider。聚合服务提供者对应的配置类为 AggregationDataProviderSetting，其配置项含义如下：

<name>：聚合服务提供者配置的名称。
<description>：聚合后的数据源描述，可以不加。