SOI简单体验

导语

arcgis for server10.3.1中提供了一个新的功能叫做soi。本文简单的介绍soi概念&＃xff0c;实现&＃xff0c;在使用过程中的注意事项。阅读本文和使用soi需要以下先决条件

1. SOI是ArcGIS Server 10.3.1中新增加的功能。故开发和部署SOI需要安装ArcObject sdk 10.3.1 和 ArcGIS Server 10.3.1。

2. 了解SOE开发的流程。

什么是SOI

SOI是server object interceptors的缩写。从字面意思&＃xff0c;是服务对象捕获器。esri对其的介绍是&＃xff0c;用来捕获触发地图服务和影像服务内置操作的请求。

也即是任何调用server服务功能的前端&＃xff0c;发送的请求&＃xff0c;都能在服务器端被自定义的soi应用程序捕获到。soi可以过滤到达的请求&＃xff0c;也可以在response中添加内容返回前端。如下示意图&＃xff1a;

在网络开发中&＃xff0c;有个常见的功能&＃xff0c;就是开发防盗链。即在图片上加logo等水印。在server的出图操作中&＃xff0c;可以运用soi&＃xff0c;捕获每次export map返回的结果。给结果图片加上水印。

除了这种情形&＃xff0c;还有一些&＃xff0c;比如&＃xff0c;针对图层和功能级别的控制都可以使用soi。

与SOE

定位上&＃xff0c;SOE是Server Object Extension 的缩写&＃xff0c;其旨在丰富sever服务器端能够提供的功能。而SOI旨在对每次到达服务器端的请求处理。

实现上&＃xff0c;两种的底层的实现原理其实是一样的&＃xff0c;编写dll&＃xff0c;注册到服务器端。且两者的开发和部署的方式一样。安装了AO sdk 10.3.1的版本&＃xff0c;在编辑中&＃xff0c;新建项目可以看到多了一个SOI的模板。

soi开发编译完后&＃xff0c;也是生成soe文件&＃xff0c;在site中部署即可。可以直接说SOI即是一个SOE的功能子集。在SOE的开发模板中可以实现soi的这种功能。只不过使用SOE获取参数的过程&＃xff0c;soi直接给你参数变量。具体怎么实现&＃xff0c;这里就按下不表。

SOI的开发与实现

SOI支持 以下三种请求的捕捉&＃xff1a;

• REST 请求
• SOAP请求
• OGC请求

根据请求类型的不一样&＃xff0c;其需要实现的接口是不一样的&＃xff0c;上面三种请求类型&＃xff0c;对应需要实现的接口如下&＃xff1a;

• IRESTRequestHandler-rest的请求
• IRequestHandler2-soap包括arcmap发送的请求
• IWebRequestHandler

三种都隶属于命名空间Esri.ArcGIS.esriSystem

需要注意的是&＃xff0c;不管你想捕获的请求是上面的那一种&＃xff0c;这三个接口的是必须实现。如你只想捕获rest请求&＃xff0c;但是在模板除了添加IRESTRequestHandler的实现方法&＃xff0c;其他两个接口的方法也必须实现。 而你在其他两个接口方法中&＃xff0c;不编写任何的处理代码。 看完这段话&＃xff0c;也许会感到诧异&＃xff0c;为何只需要控制一种请求&＃xff0c;而需要实现三种方式&＃xff0c;考虑下面的情形&＃xff1a;

arcgis server发布的地图服务&＃xff0c;既通过rest也通过soap对外提供服务能力。如果在开发某一个功能&＃xff0c;特别是安全方面的控制的时候&＃xff0c;如果只在rest的实现方式中添加控制代码而soap中不添加&＃xff0c;就soap这端会存在安全漏洞。这个时候的建议就是在三种实现中都处理所有的请求

三种实现方式中&＃xff0c;rest是最为简单的实现方式。所有的参数都是json的形式。其中有两个必须实现的方式&＃xff0c;其中下面的方法&＃xff0c;是需要开发人员处理的&＃xff1a;

public byte[] HandleRESTRequest(string capabilities, string resourceName, stringoperationName, string operationInput, string outputFormat, stringrequestProperties, ref string responseProperties);

看下这个方法的中的输入参数名&＃xff0c;是不是对soi的实现一目了然。在这个方法中&＃xff0c;通过对传递过来的参数就行判断&＃xff0c;就可以对请求进行过滤。

那怎么对输出&＃xff0c;返回到前端的结果进行处理呢&＃xff1f;

如果需要对结果进行处理&＃xff0c;需要捕获response。在模板中&＃xff0c;上面函数的返回结果就是response。

可以声明一个response变量&＃xff0c;来接受返回。可以把模板中的return改为var response


var response &＃61; restRequestHandler.HandleRESTRequest(Capabilities, resourceName, operationName, operationInput,outputFormat, requestProperties, out responseProperties);

获取到response变量后对response的变量进行处理操作。

最后&＃xff0c;在该函数的末尾自己&＃xff0c;写一个序列化的函数return回去。可以参考ESRI.ArcGIS.SoeSupport中关于序列化与反序列化的内容。

开发完了就是部署了。需要注意的是&＃xff0c;一个服务只能启用一个soi。 本人也思索了下这种情形的原因&＃xff0c;因为soi本身没有增加服务的能力。在rest上&＃xff0c;功能通过url提供&＃xff0c;么有功能增加&＃xff0c;url就保持不变。一个服务的多个soi的url是完全一样。

另外两种接口的实现的思路差不多&＃xff0c;不同的是&＃xff0c;处理的参数的类型不同。如soap的二进制等。

总结

如果有SOE的开发经历&＃xff0c;开发SOI还是很易上手的。一开始费了劲读模板中Utilities的实现&＃xff0c;其实这部分的内容自己完全无需了解。直接用即可。

更多内容和示例&＃xff0c;参考AO的开发帮助。