如何创建一个MapHandler



什么是MapHandler

MapHandler即AjaxHandlers ，它的作用就是接受客户端传递的参数，转由GIS服务器处理，最后将处理后的结果返回客户端。

处理流程

客户端

SuperMap IS .NET 的AjaxScripts 脚本对象将对GIS请求的参数通过XMLHttpRequest 对象，发送异步请求到服务器端的AjaxHandlers。当AjaxHandlers返回GIS请求的处理结果时，AjaxScripts对象会执行onComplete或者onError对应的回调函数接受并处理返回结果。

Web服务端

1.       Web.config文件：在web服务端会有这样的文件，在该文件中配置有AjaxHanlder的映射信息，如

  <httpHandlers>

     <add verb="*" path="common.ashx" type="SuperMap.IS.Ajax.CommonHandler SuperMap.IS.AjaxLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=753ce5cde00ec9b6" />

  </httpHandlers>

这样当客户端发出请求时，如“common.ashx?map=xxx&method=XXX…”，请求会转由SuperMap.IS.Ajax.CommonHandler这个类来进行处理。

2.       AjaxHandlers类接收客户端请求/返回处理结果：前面已经介绍了AjaxHandlers的几个处理器的类。当客户端的请求发送到某一个类时，该类以ProcessRequest方法为入口来处理客户端的请求，即获取xxx.ashx?map=xxx&method=XXX…中相关的GIS请求参数，返回处理结果。

3.       AjaxHandlers 类的GIS功能的处理：实际上，AjaxHandlers是不具有对GIS数据的处理能力的，它获取客户端的GIS请求后，会进一步向GIS服务器提交请求，并获取GIS服务器返回的处理结果，再将该结果返回客户端。GIS服务器的访问地址和端口从web.config文件中获取，位置如下：

  <appSettings>

    <add key="MapServer_Address" value="localhost" />

    <add key="MapServer_Port" value="8800" />

  </appSettings>

SuperMap IS.NET提供的Handler类型

l  CommonHandler（SuperMap.IS.Ajax.CommonHandler 类）是用于处理基础地图服务的Handler，主要处理获取所有地图名称、量算功能、查询功能、制作专题图、操作数据源以及更新图层、几何对象、清除缓存等功能；

l  EditHandler（SuperMap.IS.Ajax.EditHandler类）是用于处理地图编辑操作的Handler，包含数据集编辑、图层锁定等功能；

l  MapHandler（SuperMap.IS.Ajax.MapHandler类）是用于处理地图图片操作的Handler, 包含获取高亮图片、获取资源图片、获取几何对象的图片、图片透明处理等功能；

l  PathHandler（SuperMap.IS.Ajax.PathHandler 类）是用于处理各种GIS分析功能的Handler，包含路径分析、公交换乘功能、栅格分析等功能；

l  QueryHandler（SuperMap.IS.Ajax.QueryHandler类）是用于处理查询功能的Handler，包括空间查询、统计查询等；

l  TileHandlerBase（SuperMap.IS.Ajax.TileHandlerBase 类）是用于处理图幅请求的AjaxHandlers基类。该基类提供给用户做关于图幅请求的AjaxHandlers的扩展开发。通过扩展该基类，可以向任意第三方地图服务（如WMS、WFS等）请求某一范围的GIS数据，这个范围是基于SuperMap IS .NET 分幅规则划分的图幅范围，这样，请求到的GIS数据可以与SuperMap IS .NET GIS服务器提供的GIS数据进行叠加，实现将多种服务聚合，为GIS请求者提供更加强大的处理能力。

如何创建独立的MapHandler

从上面的讲解我们知道MapHandler就是一些映射到处理类库的信息，所以我们想要创建独立的MapHandler，需要有两个部分，一个是WebConfig配置文件，一个是Bin文件夹（IS.NET的动态链接库）。

新建WebConfig添加如下代码（或者修改配置文件添加相应节点- appSettings，httpHandlers和handlers中的相关配置）：

<?xml version="1.0"?>

<!-- 

    注意: 除了手动编辑此文件以外，您还可以使用 

    Web 管理工具来配置应用程序的设置。可以使用 Visual Studio 中的

     “网站”->“Asp.Net 配置”选项。

    设置和注释的完整列表在 

    machine.config.comments 中，该文件通常位于 

    \Windows\Microsoft.Net\Framework\v2.x\Config 中

-->

<configuration>

     <configSections>

         <sectionGroup name="system.web.extensions" type="System.Web.Configuration.SystemWebExtensionsSectionGroup, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35">

              <sectionGroup name="scripting" type="System.Web.Configuration.ScriptingSectionGroup, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35">

                   <section name="scriptResourceHandler" type="System.Web.Configuration.ScriptingScriptResourceHandlerSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" requirePermission="false" allowDefinition="MachineToApplication"/>

                   <sectionGroup name="webServices" type="System.Web.Configuration.ScriptingWebServicesSectionGroup, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35">

                       <section name="jsonSerialization" type="System.Web.Configuration.ScriptingJsonSerializationSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" requirePermission="false" allowDefinition="Everywhere"/>

                       <section name="profileService" type="System.Web.Configuration.ScriptingProfileServiceSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" requirePermission="false" allowDefinition="MachineToApplication"/>

                       <section name="authenticationService" type="System.Web.Configuration.ScriptingAuthenticationServiceSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" requirePermission="false" allowDefinition="MachineToApplication"/>

                       <section name="roleService" type="System.Web.Configuration.ScriptingRoleServiceSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" requirePermission="false" allowDefinition="MachineToApplication"/>

                   </sectionGroup>

              </sectionGroup>

         </sectionGroup>

     </configSections>

  <appSettings>

    <add key="MapServer_Address" value="localhost" />

    <add key="MapServer_Port" value="8800" />

  </appSettings>

     <connectionStrings/>

     <system.web>

         <!-- 

            设置 compilation debug="true" 可将调试符号插入

            已编译的页面中。但由于这会 

            影响性能，因此只在开发过程中将此值 

            设置为 true。

        -->

         <trace enabled="true" mostRecent="true" />

  <compilation debug="true">

              <assemblies>

                   <add assembly="System.Core, Version=3.5.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>

                   <add assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

                   <add assembly="System.Data.DataSetExtensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>

                   <add assembly="System.Xml.Linq, Version=3.5.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>

              </assemblies>

         </compilation>

         <!--

            通过 <authentication> 节可以配置 ASP.NET 用来 

            识别进入用户的

            安全身份验证模式。 

        -->

         <authentication mode="Windows"/>

         <!--

            如果在执行请求的过程中出现未处理的错误，

            则通过 <customErrors> 节可以配置相应的处理步骤。具体说来，

            开发人员通过该节可以配置

            要显示的 html 错误页

            以代替错误堆栈跟踪。

 

        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">

            <error statusCode="403" redirect="NoAccess.htm" />

            <error statusCode="404" redirect="FileNotFound.htm" />

        </customErrors>

        -->

         <pages>

              <controls>

                   <add tagPrefix="asp" namespace="System.Web.UI" assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

                   <add tagPrefix="asp" namespace="System.Web.UI.WebControls" assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

              </controls>

         </pages>

         <httpHandlers>

              <remove verb="*" path="*.asmx"/>

              <add verb="*" path="*.asmx" validate="false" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

              <add verb="*" path="*_AppService.axd" validate="false" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

              <add verb="GET,HEAD" path="ScriptResource.axd" type="System.Web.Handlers.ScriptResourceHandler, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" validate="false"/>

      <add verb="*" path="common.ashx" type="SuperMap.IS.Ajax.CommonHandler, SuperMap.IS.AjaxLib"/>

      <add verb="*" path="path.ashx" type="SuperMap.IS.Ajax.PathHandler, SuperMap.IS.AjaxLib"/>

      <add verb="*" path="map.ashx" type="SuperMap.IS.Ajax.MapHandler, SuperMap.IS.AjaxLib"/>

      <add verb="*" path="edit.ashx" type="SuperMap.IS.Ajax.EditHandler, SuperMap.IS.AjaxLib"/>

      <add verb="*" path="query.ashx" type="SuperMap.IS.Ajax.QueryHandler, SuperMap.IS.AjaxLib"/>

    </httpHandlers>

         <httpModules>

              <add name="ScriptModule" type="System.Web.Handlers.ScriptModule, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

         </httpModules>

     </system.web>

     <system.codedom>

         <compilers>

              <compiler language="c#;cs;csharp" extension=".cs" warningLevel="4" type="Microsoft.CSharp.CSharpCodeProvider, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">

                   <providerOption name="CompilerVersion" value="v3.5"/>

                   <providerOption name="WarnAsError" value="false"/>

              </compiler>

              <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" warningLevel="4" type="Microsoft.VisualBasic.VBCodeProvider, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">

                   <providerOption name="CompilerVersion" value="v3.5"/>

                   <providerOption name="OptionInfer" value="true"/>

                   <providerOption name="WarnAsError" value="false"/>

              </compiler>

         </compilers>

     </system.codedom>

     <!-- 

        在 Internet 信息服务 7.0 下运行 ASP.NET AJAX 需要 system.webServer

        节。对早期版本的 IIS 来说则不需要此节。

    -->

     <system.webServer>

         <validation validateIntegratedModeConfiguration="false"/>

         <modules>

              <remove name="ScriptModule"/>

              <add name="ScriptModule" preCondition="managedHandler" type="System.Web.Handlers.ScriptModule, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

         </modules>

         <handlers>

              <remove name="WebServiceHandlerFactory-Integrated"/>

              <remove name="ScriptHandlerFactory"/>

              <remove name="ScriptHandlerFactoryAppServices"/>

              <remove name="ScriptResource"/>

              <add name="ScriptHandlerFactory" verb="*" path="*.asmx" preCondition="integratedMode" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

              <add name="ScriptHandlerFactoryAppServices" verb="*" path="*_AppService.axd" preCondition="integratedMode" type="System.Web.Script.Services.ScriptHandlerFactory, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

              <add name="ScriptResource" preCondition="integratedMode" verb="GET,HEAD" path="ScriptResource.axd" type="System.Web.Handlers.ScriptResourceHandler, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>

      <add name="common" verb="*" path="common.ashx" type="SuperMap.IS.Ajax.CommonHandler, SuperMap.IS.AjaxLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=753ce5cde00ec9b6" preCondition="integratedMode" />

      <add name="path" verb="*" path="path.ashx" type="SuperMap.IS.Ajax.PathHandler, SuperMap.IS.AjaxLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=753ce5cde00ec9b6" preCondition="integratedMode" />

      <add name="map" verb="*" path="map.ashx" type="SuperMap.IS.Ajax.MapHandler, SuperMap.IS.AjaxLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=753ce5cde00ec9b6" preCondition="integratedMode" />

      <add name="edit" verb="*" path="edit.ashx" type="SuperMap.IS.Ajax.EditHandler, SuperMap.IS.AjaxLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=753ce5cde00ec9b6" preCondition="integratedMode" />

      <add name="query" verb="*" path="query.ashx" type="SuperMap.IS.Ajax.QueryHandler, SuperMap.IS.AjaxLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=753ce5cde00ec9b6" preCondition="integratedMode" />

    </handlers>

     </system.webServer>

     <runtime>

         <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">

              <dependentAssembly>

                   <assemblyIdentity name="System.Web.Extensions" publicKeyToken="31bf3856ad364e35"/>

                   <bindingRedirect oldVersion="1.0.0.0-1.1.0.0" newVersion="3.5.0.0"/>

              </dependentAssembly>

              <dependentAssembly>

                   <assemblyIdentity name="System.Web.Extensions.Design" publicKeyToken="31bf3856ad364e35"/>

                   <bindingRedirect oldVersion="1.0.0.0-1.1.0.0" newVersion="3.5.0.0"/>

              </dependentAssembly>

         </assemblyBinding>

     </runtime>

</configuration>

发布MapHandler
通过IIS发布MapHandler的文件夹，例如发布路径为http://localhost/MapHandler/，在工程中只需指定Maphandler=“http://localhost/MapHandler/”即可。

部署MapHandler到本工程
         通常一个GIS工程的MapHandler是随本工程配置的，这样只需将相应的节点添加到本工程的WebConfig中，并且修改MapHandler为“./”即可。

【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/yuxichina/p/1785819.html