com.supermap.web.iServerJava6R.networkAnalystServices
public class FindMTSPPathsService
继承 FindMTSPPathsService Inheritance com.supermap.web.service.ServiceBase

多旅行商分析服务类.

多旅行商分析属于网络分析的一种,也称为物流配送,是指在网络数据集中,给定 M 个配送中心点和 N 个配送目的地(M,N 为大于零的整数),查找经济有效的配送路径,并给出相应的行走路线。物流配送功能就是解决如何合理分配配送次序和送货路线,使配送总花费达到最小或每个配送中心的花费达到最小。
例如:现在有50个报刊零售地(配送目的地),和4个报刊供应地(配送中心),现寻求这4个供应地向报刊零售地发送报纸的最优路线,属物流配送问题。下面的示意图展示了这个例子的情况以及进行多旅行商分析后的简图。
如下图所示,左图中粉色大圆点代表4个报刊供应地(配送中心),而其他小圆点代表报刊零售地(配送目的地),共有50个;每一类颜色代表一个配送中心的配送方案,包括它所负责的配送目的地、配送次序以及配送线路。
右图为左图中矩形框圈出的第2号配送中心的配送方案:蓝色的标有数字的小圆点是2号配送中心所负责的配送目的地(共有18个),2号配送中心将按照配送目的地上标有数字的顺序依次发送报纸,即先送1号报刊零售地,再送2号报刊零售地,依次类推,并且沿着分析得出的蓝色线路完成配送,回到配送中心。
该类负责将客户端指定的多旅行商分析参数传递给服务端,并接收服务端返回的结果数据,将最终结果存放于 FindMTSPPathsResult 类中。用户若需获取服务端返回的原始结果,需监听 FindMTSPPathsEvent.PROCESS_COMPLETE 事件,该事件中即存有原始结果,又存有可在客户端显示的最终结果。



公共方法
  方法 定义方
   
使用网络分析服务地址 URL 初始化 FindMTSPPathsService 的新实例。
FindMTSPPathsService
   
processAsync(parameters:FindMTSPPathsParameters, responder:IResponder = null):AsyncToken
将客户端指定的多旅行商分析参数传递给服务端,与服务端完成异步通讯。.
FindMTSPPathsService
事件
  事件 Summary 定义方
    当与服务端交互失败时触发该事件。 FindMTSPPathsService
    当与服务端交互成功时触发该事件。 FindMTSPPathsService
构造函数详细信息
FindMTSPPathsService () 构造函数
public function FindMTSPPathsService(url:String)

使用网络分析服务地址 URL 初始化 FindMTSPPathsService 的新实例。

参数
url:String — 网络分析服务地址。请求网络分析服务,URL应为:
http://{服务器地址}:{服务端口号}/iserver/services/{网络分析服务名}/rest/networkanalyst/{网络数据集@数据源};
例如:"http://localhost:8090/iserver/services/components-rest/rest/networkanalyst/RoadNet@Changchun"。
方法详细描述
processAsync () 方法
public function processAsync(parameters:FindMTSPPathsParameters, responder:IResponder = null):AsyncToken

将客户端指定的多旅行商分析参数传递给服务端,与服务端完成异步通讯。.

与服务端异步通讯成功后,触发 FindMTSPPathsEvent.PROCESS_COMPLETE 事件。获取返回的结果有两种方式:
1. 通过 AsyncResponder 类获取(推荐使用);
2. 通过监听 FindMTSPPathsEvent.PROCESS_COMPLETE 事件获取。

参数

parameters:FindMTSPPathsParameters — 多旅行商分析参数类。
 
responder:IResponder (default = null) — 由 AsyncResponder 类实现。远程或异步请求服务完成时将调用的处理函数。使用方法为
AsyncResponder(result:Function, fault:Function, token:Object = null)
result:Function — 成功完成请求时应调用的函数。必须具有以下签名:
public function (result:Object, token:Object = null):void;
fault:Function — 请求完成但出错时应调用的函数。必须具有以下签名:
public function (error:FaultEvent, token:Object = null):void;
token:Object (default = null) — 与此请求相关的其他信息。
有关 AsyncResponder 类的详细信息请参见 “ActionScript 语言帮助文档”。

返回
AsyncToken — 返回 AsyncToken 对象,它为异步 RPC 操作提供设置额外数据或标记级别数据的位置。它也允许为单独的调用附加 IResponder。可从 token 属性的 ResultEvent 和 FaultEvent 中引用 AsyncToken。有关 AsyncToken 类的详细信息请参见 “ActionScript 语言帮助文档”。
事件详细信息
fault 事件
Event Object Type: mx.rpc.events.FaultEvent

当与服务端交互失败时触发该事件。

processComplete 事件  
Event Object Type: com.supermap.web.iServerJava6R.serviceEvents.FindMTSPPathsEvent

当与服务端交互成功时触发该事件。