ArcGIS服务对象扩展SOE新手自学笔记：初识SOE.docVIP

1.SOE介绍 　　在ArcGIS 10.1中ArcGIS Server不在支持DCOM方式的连接，这也就意味着我们不能通过本地方式的连接使用ArcObjects提供的更多功能，所以我们推荐一种新的方式来实现这些功能，这种方式就是SOE服务器对象扩展。SOE存在于整个服务对象的生存期内，可以利用服务对象的资源并对其进行扩展。一个SOE通常在服务对象创建是初始化，并且在整个服务对象的生存期内只会被创建一次。SOE支持SOAP和REST两种访问方式，其通过强大的AO来扩展服务对象，并可以运行在一个没有AO的客户端中。 　　SOE特别适用于那些使用ArcGIS APIs无法完成的复杂业务逻辑功能。SOE可以提供粗粒度的接口，一次完成复杂的工作，而不是向服务器端发送大量的请求。目前大多数Gis公司都有管网项目，而ArcGIS APIs并没有为我们提供几何网络的有关内容，工程师们大多数通过利用AE在后台完成分析操作，然后返回json格式数据。这样每个公司可能会有一套自己的函数库用来完成以上问题，SOE的出现刚好可以用来提供统一的方法来解决这个问题，且其执行速度很快。 　　SOE比较适合那些有多种平台工作经验的开发者，开发一个SOE通常会用到AO、.NET或Java、REST或SOAP Web服务通信技术。 2.重要接口 　　首先我们来介绍几个必要的接口（REST方式）：IServerObjectExtension、IObjectConstruct（可选）、IRESTQuestHandler 　　IServerObjectExtension接口主要由两个方法： 　　Init---该函数有一个IServerObjectHelper类型的参数。该函数在服务启动时被调用， 并将IServerObjectHelper对象传入，此接口是对Server对象弱引用，可以通过其ServerObject属性得到Server对象。 　　Shutdown---该方法用在服务器关闭时调用，经常我们在该方法中释放SOE中使用的资源。 ? 　　IObjectConstruct只有一个方法：Construct（）；该方法在Init方法执行后立即执行，该方法也只会执行一次，通常用来配置SOE属性，也可以将比较耗费资源的逻辑放在这个方法中。比如获取地图代码，或者获取一个每次请求都会被操作的图层。 ? 　　IRESTQuestHandler接口主要有以下两个方法： 　　GetSchema() ---以JSON格式返回SOE的资源列表 　　HandleRESTREquest() 方法主要有两个作用：回调资源和操作的方法、获取资源在实例级别的描述。 该方法在识别这两个作用的时候是通过operationName参数，如果该参数是空字符产那就是第二个作用，否则是第一个作用。　　　　该方法的参数如下： 　　　　　　（1）.String capabilities:一组被资源授权的操作，可以为空字符串 　　　　　　（2）.String resourceName: 资源名称. 空字符串表示根级别，子资源会通过‘/’ 表示 　　　　　　（3）.String operationName: 操作名称　　　　　　（4）.String operationInput: 操作的参数，JSON格式　　　　　　（5）.String outputFormat:客户端请求的输出格式，如JSON,AMF 　　　　　　（6）.String[] responseProperties: 通过操作返回的一组键值对，逗号分开 3.大致流程 　　（1）编写代码。通常使用ESRI提供的REST SOE模板 　　（2）在每台SOC机器上注册SOE COM组件 　　（3）将SOE注册到ArcGISServer中 　　（4）为ArcCatalog或者Manager编写并部署一个属性页（可选） 　　（5）在Server中启动SOE，并测试 1.REST SOE 　　当客户端使用REST方式发送SOE请求时，实际上是利用HTTP协议发送了一个请求字符串，ArcServer获得该字符串后会将其解析成一系列命令执行，并返回JSON数据。 　　返回的JSON格式数据如下： ? 2.创建REST SOE 　　（1）提醒 　　　　为了确保你创建的REST SOE能够成功执行，你需要仔细考虑一下向服务器端发送请求的数据类型和你希望返回的数据。 　　　　一个REST SOE通常包含资源和操作两部分（Resource和Operation）： 　　　　Resource---可以从服务器端获取的一系列信息。它类似于类中暴露出的某一个属性； 　　　　Operation---服务器端根据发送的请求进行一系列的操作。在Operation执行完后，你