《SOE介绍以及开发部署.docxVIP

ArcGIS 10.1 for ServerSOE介绍及开发Esri中国信息技术有限公司2012年6月《版权声明》本文档版权为Esri中国信息技术有限公司所有。未经本公司书面许可，任何单位和个人不得以任何形式摘抄、复制本文档的部分或全部，并以任何形式传播。——制定及修订记录——版本完成日期编写/修订纪要编写者备 注V0.12012-6-4刘宇V0.22012-6-11刘宇目 录SOE介绍及开发1第一章SOE由来1第二章SOE使用31.1必选接口31.1.1IRESTRequestHandler 接口31.1.2IServerObjectExtension41.2可选接口51.2.1IObjectConstruct51.2.2IObjectActivate51.3创建SOE61.4部署SOE111.5使用SOE18SOE由来在ArcGIS 10.1中ArcGIS Server不在支持DCOM方式的连接，这也就意味着我们不能通过本地方式的连接使用ArcObjects提供的更多功能，所以我们推荐一种新的方式来实现这些功能，这种方式就是SOE服务器对象扩展，一个SOE（Server Object Extension）就是一个包含一组方法的类，这个类可以在SOC(ArcGIS 10.1 for Server进程，全称是ArcSOC.exe)中运行，并且可以被web应用程序调用。Server Objects是粗粒度的AO组件，是一个可以执行特定操作的高级对象，它隐藏了细粒度的ArcObject。Server Objects的粗粒度接口支持对于像绘制地图或地理编码等整体性任务。Server objects也有SOAP接口，可以把server objects暴露成Web Service，从而可以被客户端使用。　SOE是开发者的一个高级选项，使您能够将ArcGIS Server服务基本功能进行扩展。SOE具有两大优势：　1.SOE可以作为SOAP或REST Web服务，使得用ArcGIS Web APIs建立的客户（用于JavaScript、Flex、Silverlight、iOS等）以便调用这些应用程序。事实上，您的SOE将出现在ArcGIS Services Directory之内，并将提供特性设置、基本类型等ArcGIS APIs能够理解的典型对象类型。　2.SOE能够对ArcObjects进行有效封装，提供理想环境以快速执行您的指令。　.可以建立一个SOE，使用动态分段获取里程标志位置,或者实现几何网络分析（在ArcGIS 10的时候，因为工具箱中没有提供几何网络的GP，因此要实现几何网络的分析，可以通过这种办法）　SOE开发需要ArcObjects、.NET或Java以及REST与SOAP等Web服务通信技术的知识。ArcObjects SDK具有多种可供您进行校验的样本，即可用于Java也可用于.NET。　在SOE的开发过程中，我们必须清楚，我们需要在SOE中将请求获取，然后将传入的参数转化为AO,然后通过AO处理，再将处理的结果转成json格式，传给客户端，客户端得到json格式的结果，然后解析。下图描述了请求响应的整个过程，如下图：下图描述了请求回复的整个过程，如下图：SOE使用必选接口IRESTRequestHandler 接口该接口主要有下面两个方法： string GetSchema(); byte[] HandleRESTRequest()IRESTRequestHandler.handleRESTREquest() 方法主要有下面两个作用：回调资源和操作的方法获取资源在实例级别的描述该方法在识别这两个作用的时候是通过operationName参数，如果该参数是空字符产那就是第二个作用，否则是第一个作用。该方法的参数如下： String capabilities:一组被资源授权的操作，可以为空字符串 String resourceName: 资源名称. 空字符串表示根级别，子资源会通过‘/’ 表示 String operationName: 操作名称String operationInput: 操作的参数，JSON格式String outputFormat:客户端请求的输出格式，如JSON,AMF String[] responseProperties: 通过操作返回的一组键值对，逗号分开IRESTRequestHandler.getSchema() 方法以JSON格式返回SOE的资源列表IServerObjectExtension该接口主要有个方法：Init(IServerObjectHelper pSOH)和void Shutdown();当Server启动的时候会调用该方法，并将IServerObjectHelp