Tomcat 下配置OpenLayers proxy.cgi代理

摘要：在OpenLayers访问WFS服务时，会遇到跨域的问题而导致服务无法访问。此时，需要在应用程序中设置代理，通过代理进行访问。本文介绍在tomcat进行proxy.cgi文件配置，以及在调用代理过程中如何设置其访问路径。

1.获取代理文件proxy.cgi

如果你下载了openLayers包，在OpenLayers-2.13.1examples文件夹下，可以发现cgi文件。还可以去下载（http://trac.osgeo.org/openlayers/browser/trunk/openlayers/examples/proxy.cgi）。

2.在你的工程中引用proxy.cgi文件

将获得的cgi文件拷贝至当前应用的目标路径下，当前应用中的路径可以自己指定。

添加远程访问的url地址，在cgi文件中的allowedHosts数组中添加远程地图服务所在机器的IP。

allowedHosts = ['www.openlayers.org', 'openlayers.org',

                'labs.metacarta.com', 'world.freemap.in',

                'prototype.openmnnd.org', 'geo.openplans.org',

                'sigma.openplans.org', 'demo.opengeo.org',

                'www.openstreetmap.org', 'sample.azavea.com',

                'v2.suite.opengeo.org', 'v-swe.uni-muenster.de:8080',

                'vmap0.tiles.osgeo.org', 'www.openrouteservice.org',

                'maps.wien.gv.at','mapserverIP:8080']

3.配置proxy.cgi映射路径

在应用程序的web.xml文件中配置cgi文件的映射路径，将下列代码拷贝至当前应用的web.xml文件中，同时修改sevlet初始化参数cgiPathPrefix和executable，其中参数cgiPathPrefix指得是cgi在当前应用中的路径，参数executable指应用程序运行的电脑上的python.exe文件所在物理路径，如果电脑上没有安装python，则需要进行安装。

个人认为OpenLayers 中的通过代理执行请求的方式，是通过当前工程默认的default servlet将proxy.cgi文件映射到web.xml文件中配置的python可执行程序中执行，proxy.cgi实际上一段python代码，在执行python代码的过程中进行代理访问。

<servlet>

    <servlet-name>cgi</servlet-name>

　 <servlet-class>org.apache.catalina.servlets.CGIServlet</servlet-class>

      　<init-param>

           　<param-name>debug</param-name>

           　<param-value>0</param-value>

       　</init-param>

      　 <init-param>

           　<param-name>cgiPathPrefix</param-name>

　　　　  <param-value>media/js/openLayers_/2.13.1/cgi-bin</param-value>

       　</init-param>

          <init-param>

               <param-name>executable</param-name>

               <param-value>c:/Python26/ArcGIS10.0/python.exe</param-value>

         </init-param>

         <init-param>

             <param-name>passShellEnvironment</param-name>

             <param-value>true</param-value>

         </init-param>

        <load-on-startup>5</load-on-startup>

 </servlet>

 <!-- The mapping for the default servlet-->

 <servlet-mapping>

    <servlet-name>default</servlet-name>

    <url-pattern>/</url-pattern>

  </servlet-mapping>

  <servlet-mapping>

     <servlet-name>cgi</servlet-name>

     <url-pattern>/cgi/*</url-pattern>

  </servlet-mapping>

4.设置tomcat的context.xml文件

context.xml文件位于tomcat/conf文件夹下，建议将其拷贝一份该文件至但当前应用程序的META-INF文件夹中，并为该文件的<Context>节点增加属性

<Context privileged="true">

至此，openLayers的代理proxy设置完成，启动tomcat在浏览器地址栏中输入

http://localhost:8080/应用程序名称/cgi/proxy.cgi

如果成功的话，将会显示OpenLayers主页

否则会显示404错误

   注意：在未连接互联网的情况下通过上述路径访问proxy.cgi时，会显示如下异常信息。

5.调用代理

在地图初始化的最前面添加如下代码，以调用代理proxy。

OpenLayers.ProxyHost = "cgi/proxy.cgi?url=";

配置好的代理文件，默认处于应用程序根目录下，在调用过程中需要根据其加载页面与根目录的相对路径，设置其路径。即上述语句中“cgi/proxy.cgi?url=”实际上应为“relativeUrl+cgi/proxy.cgi?url=”，其中relativeUrl为加载该语句所在js文件的页面与应用程序根目录之间的相对路径。 

按照上述设置，要确保“运行过程中调用代理的页面url”+ OpenLayers.ProxyHost路径应为“应用程序名称/cgi/proxy.cgi”，若不符合这种要求，应当调整运行页面与代理之间的相对路径。

在运行过程中，代理的路径默认情况下为加载 “其设置语句”（即上述语句）所在js文件的页面url+ cgi/proxy.cgi，特别需要注意地方是，如果加载 “代理设置语句”所在js文件的页面不在应用程序的根目录下，即webcontent或webroot目录下（如webcontent/index.html），而是在其子文件夹下（如webcontent/gis/map.html）下，那么在指定代理路径的时候如果将其设置为“cgi/proxy.cgi?url=”就会出现代理无法访问的错误，因为程序运行过程中会将代理的路径映射为“应用程序名/gis/cgi/proxy.cgi”，而实际上我们配置的代理路径为“应用程序名/cgi/proxy.cgi”，解决这个问题需要在设置代理路径时，将其指定为其加载页面的上一级目录，即：

OpenLayers.ProxyHost = "../cgi/proxy.cgi?url=";

题外话：web应用程序中的路径有三种情况

（1）“cgi/proxy.cgi”指当前url+”/”+ cgi/proxy.cgi

（2）“/cgi/proxy.cgi”指应用程序根目录下的cgi/proxy.cgi

（3）“../cgi/proxy.cgi”指当前url的上一级目录下的cgi/proxy.cgi