UrlRewriteFilter使用说明

一、Urlrewritefilter说明及优势

       Urlrewritefilter，通过java的Filter过滤器对URL进行重写，用户得到的全部都是经过处理后的URL地址，本质上通过伪地址进行页面跳转，隐藏真实地址，达到掩人耳目的目的。

有以下优势：
1：提高安全性，可以有效的避免一些参数名、ID等完全暴露在用户面前，如果用户随便乱输的话，不符合规则的话直接会返回个404或错误页面，这比直接返回500或一大堆服务器错误信息要好的多 
2：美化URL，去除了那些比如*.do，*.action之类的后缀名、长长的参数串等，可以自己组织精简更能反映访问模块内容的URL 

3：更有利于搜索引擎的收入，通过对URL的一些优化，可以使搜索引擎更好的识别与收录网站的信息

 

二、网络资源

 1、下载地址 官网：http://tuckey.org/urlrewrite/   google code ：https://code.google.com/p/urlrewritefilter/

 2、文档使用说明：http://urlrewritefilter.googlecode.com/svn/trunk/src/doc/manual/4.0/index.html

 

三、使用步骤

1、下载urlrewrite-3.2.0.jar 并将其放到WEB-INF/lib目录下

2、配置web.xml，注意：Url重写过滤器配置要放在struts过滤器配置之前，因为先要将请求url转换成真实路径后，在再交由strus处理

<filter>  
    <filter-name>UrlRewriteFilter</filter-name>  
    <filter-class>org.tuckey.web.filters.urlrewrite.UrlRewriteFilter</filter-class>  
</filter>  
<filter-mapping>  
    <filter-name>UrlRewriteFilter</filter-name>  
    <url-pattern>/*</url-pattern>  
    <dispatcher>REQUEST</dispatcher>  
    <dispatcher>FORWARD</dispatcher>  
</filter-mapping>  

在struts2的过滤器中添加<dispatcher>REQUEST</dispatcher>、<dispatcher>FORWARD</dispatcher>和<dispatcher>INCLUDE</dispatcher>。

<filter>
    <filter-name>struts2</filter-name>
    <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>struts2</filter-name>
    <url-pattern>*.action</url-pattern>
    <span style="color:#ff0000;"><dispatcher>REQUEST</dispatcher>
    <dispatcher>FORWARD</dispatcher> 
    <dispatcher>INCLUDE </dispatcher></span>   
  </filter-mapping>

3、配置urlrewrite.xml文件，进行地址规则映射（使用正则表达式），将urlrewrite.xml文件放置到WEB-INF目录下

注意：因为在org.tuckey.web.filters.urlrewrite.UrlRewriteFilter类中：

public static final String DEFAULT_WEB_CONF_PATH = "/WEB-INF/urlrewrite.xml";

指定了urlrewrite.xml文件的名称及存放的位置

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE urlrewrite PUBLIC "-//tuckey.org//DTD UrlRewrite 3.2//EN"
        "http://tuckey.org/res/dtds/urlrewrite3.2.dtd">
<urlrewrite>
    <rule>

<span style="white-space:pre">	<note></span>此处可写文字说明<span style="white-space:pre"></note></span>
        <!-- 地址栏显示的地址 -->
        <from>/anything</from>
        <!-- 真实的请求地址 -->
        <to>/url/test.action</to>
    </rule>
</urlrewrite>

以上只是简单的实现，具体的替换需要用到正则表达式。

如下例：

<from>/content/([0-9]+)/list</from>
<to type="forward">/IssuedContentAction.do?dispatch=vContentListBySubid&amp;scope=vmcontent&amp;columninfoid=$1</to>

需要注意的地方是：用括号括起来的正则表达式为变量，如to标签里面的$1表示的是上面from里面的第一个括号内容。url里面的参数间隔符 ‘&’应该写为‘&amp;’。

<span style="font-family:Verdana, Arial, Helvetica, sans-serif;"><!--请求输入： /world/usa/nyc   输出为  /world.jsp   -->  
<!--应用java 的正则表达式，match-type默认为regex-->  
<rule match-type="regex">  
       <from>^/world/([a-z]+)/([a-z]+)$</from>  
       <to>/world.jsp</to>  
    </rule>  
<!--应用wildcard表达式，该表达式后面会介绍-->  
 <rule match-type="wildcard">  
       <from>/world/*/*</from>  
       <to>/world.jsp</to>  
    </rule></span>

四、常见问题

1、使用URL重写后，跳转页面报404错误。

这里要注意的是：

在struts2的过滤器中

如果没有配置<dispatcher>REQUEST</dispatcher>，redirect方式是不可用的。

如果没有添加<dispatcher>FORWARD</dispatcher>，forward方式是不可用的。

解决方式：在跳转的jsp页面中，资源的路径位置使用绝对路径。

2，使用redirect方式，相比forward方式，性能较低。所以如果系统到处都要使用URL美化器，要慎重选择使用redirect。
解决方式：不要在不同目录之间使用forward做请求转发，保证当前路径不发生变化。

3，如果使用forward方式，则要处理好路径方面的问题。因为如果经过美化，URL的路径中多了或者少了几个目录，其跳转后的页面中，使用相对路径的资源（例如图片），就会请求不到，原因就是路径是以当前的URL路径为基础进行计算位置的。
解决方式：改用redirect方式