ArcGIS 服务对象扩展(SOE)新手自学笔记(1):初识SOE
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,并测试
![](http://images2017.cnblogs.com/blog/412020/201712/412020-20171216224224593-1205430224.png)