Tomcat 下配置OpenLayers proxy.cgi代理

2022-11-18,,,,

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

1.获取代理文件proxy.cgi

如果你下载了openLayers包,在OpenLayers-2.13.1\examples文件夹下,可以发现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

Tomcat 下配置OpenLayers proxy.cgi代理的相关教程结束。

《Tomcat 下配置OpenLayers proxy.cgi代理.doc》

下载本文的Word格式文档,以方便收藏与打印。