协同标绘在SuperMap中实现思路的探索

作者：爱古德拉

	最近经常有客户来咨询协同标绘相关的问题，咨询实现思路。从功能应用上讲，协同标绘在军事指挥决策、作战规划、行动部署和执行监视、公共安全处理等方面具有重要的意义和作用。但是，功能实现并不是太复杂，主要可以分成两个部分：标绘展示部分、信息传递部分。
	标绘展示部分，可以使用SuperMap iClient for Flash客户端，提供了大量的标绘接口及丰富的展示效果。同时在github上SuperMap也开源了基于SuperMap iClient for Flash客户端扩展的军标产品供大家使用。
	信息传递部分，我们必须要解决的问题就是我标绘的地物如何传递给其他的人，按照以往的请求/响应方式，无法满足我们的需求。那这里我们需要用另一种模式，也就是订阅/广播。Flash本身的服务器技术，就提供了这一功能。由于SuperMap iServer Java是使用Java语言编写，那我们也使用Java语言，在Flex项目的服务器配置里面可以看到支持的服务端技术。我们选择BlazeDS来作为我们的Flex服务器。

	简单说一下，什么是BlazeDS？BlazeDS是一个基于消息的框架，可以实现Java远程调用（remoting）和Web消息传递（messaging），主要运用两种模式：请求/响应模式、订阅/广播模式。
	基本的结构已经差不多了，接下来我们再具体分析一下程序的实现流程。首先我们需要使用Flash 客户端完成标绘功能，标绘的产物就是Feature对象，Feature对象包含三个主要属性：Geometer、Attributes、Style。要想其他人能看到我标绘的内容，那么我至少要将Feature的Geometry传递过去，这个也就是我们要广播的内容。要想收到广播的内容，我们必须要先订阅。接下来我们就开始动手实现这个功能。
	1.服务端实现
	创建一个javaweb工程，导入BlazeDS的jar包和配置文件。修改messaging-config.xml，添加一个我们要使用的订阅目标，然后将新建的javaweb项目发布到中间件中，启动服务就可以了，服务端的实现就这么简单。

<destination id="give-my-feature">
		<properties>
 			<server>
 				<allow-subtopics>true</allow-subtopics>
 				<subtopic-separator>.</subtopic-separator>
 			</server>
 		</properties>
 		<channels>
 			<channel ref="my-polling-amf" />
 			<channel ref="my-streaming-amf"/>
		</channels>
	</destination>

	2.Flex客户端实现
	第一步我们必须给Flex项目添加Flex服务器设置，如上图。我们需要填写所使用的中间件的根文件夹、根URL，其他的内容会自动生成。验证配置后点击应用即可。
	页面初始化完成后，我们就要订阅我们的服务。相关代码如下：

var consumer:Consumer = new Consumer(); 
	consumer.destination ="give-my-feature"; 
	consumer.subtopic = "feature"; 
	consumer.channelSet = new ChannelSet(["my-streaming-amf"]);			  consumer.addEventListener(MessageEvent.MESSAGE,messageHandler); 
	consumer.subscribe();

	destination属性必须和服务端配置的一样。
	在标绘的完成函数里，我们要将我们所标绘的对象广播出去。相关代码如下：

private function addFeature(event:DrawEvent):void
		{
			fl.addFeature(event.feature);
			var json:String = ServerGeometry.toJson(ServerGeometry.fromGeometry(event.feature.geometry));
			var producor:Producer = new Producer();  
			producor.destination = "give-my-feature";  
			producor.channelSet=new ChannelSet(["my-streaming-amf"]);
			producor.subtopic = "feature"; 
			var asyncMessage:AsyncMessage = new AsyncMessage();  
			asyncMessage.body.content = json;  
			producor.send(asyncMessage);
	     }

	同样，destination属性必须和服务端配置的一样。Subtopic属性，订阅和广播也必须保持一致。在这里我只传递了Geometry信息，使用的Json形式。根据SuperMap Flash API提供的方法，我先把Geometry对象转为ServerGeometry对象，然后调用ServerGeometry的方法将ServerGeometry生成了Json。
	当收到了订阅的消息后，我们需要读取消息，然后进行展示。相关代码如下：

private function messageHandler(event:MessageEvent):void 
	{ 
		var json:String = event.message.body.content as String;
		var jd:JSONDecoder = new JSONDecoder(json,true);
		var sergeo:ServerGeometry = ServerGeometry.fromJson(jd.getValue());
		var geo:Geometry = ServerGeometry.toGeometry(sergeo);
		var feature:Feature = new Feature(geo);
		fl.addFeature(feature);
	}

	收到的信息内容是ServerGeometry的Json，这里我们需要将ServerGeometry对象转换回Geometry对象，用于创建Feature并进行展示。		
	至此整个协同标绘的实现就完成了，大家可以自动动手试试了。协同标绘实现的方法有很多，我也只是给大家引导一个思路。