ToB企服应用市场:ToB评测及商务社交产业平台

标题: 关于tomcat中servlet的url-pattern匹配规则 [打印本页]

---

作者: 老婆出轨    时间: 2024-6-5 08:23
标题: 关于tomcat中servlet的url-pattern匹配规则
　　首先需要明确几点容易混淆的规则：

• servlet容器中的匹配规则既不是简单的通配，也不是正则表达式，而是特定的规则。以是不要用通配符或者正则表达式的匹配规则来对待servlet的url-pattern
  
• Servlet 2.5开始，一个servlet可以使用多个url-pattern规则，标签声明了与该servlet相应的匹配规则，每个标签代表1个匹配规则
  
• 当servlet容器接收到浏览器发起的一个url请求后，容器会用url减去当前应用的上下文路径，以剩余的字符串作为servlet映射，如果url是http://localhost:8080/appDemo/index.html，其应用上下文是appDemo，容器会将http://localhost:8080/appDemo去掉，用剩下的/index.html部分拿来做servlet的映射匹配
  
• url-pattern映射匹配过程是有优先顺序的
  
• 而且当有一个servlet匹配成功以后，就不会去理会剩下的servlet了
  

一、四种匹配规则

1 精确匹配

　　中配置的项必须与url完全精确匹配。

1. <servlet-mapping>
2.     <servlet-name>MyServlet</servlet-name>
3.     <url-pattern>/user/users.html</url-pattern>
4.     <url-pattern>/index.html</url-pattern>
5.     <url-pattern>/user/addUser.action</url-pattern>
6. </servlet-mapping>

复制代码

　　当在浏览器中输入如下几种url时，都会被匹配到该servlet
　　http://localhost:8080/appDemo/user/users.html
　　http://localhost:8080/appDemo/index.html
　　http://localhost:8080/appDemo/user/addUser.action
　　注意：
　　http://localhost:8080/appDemo/user/addUser.action/ 黑白法的url，不会被看成 http://localhost:8080/appDemo/user/addUser.action 识别
　　另外上述url后面可以跟任意的查询条件（即参数），都会被匹配，如
　　http://localhost:8080/appDemo/user/addUser.action?username=Tom&age=23 会被匹配到MyServlet。
2 路径匹配

　　以“/”字符开头，并以“/*”结尾的字符串用于路径匹配

1. <servlet-mapping>
2.     <servlet-name>MyServlet</servlet-name>
3.     <url-pattern>/user/*</url-pattern>
4. </servlet-mapping>

复制代码

　　路径以/user/开始，后面的路径可以任意。比如下面的url都会被匹配。
　　http://localhost:8080/appDemo/user/users.html
　　http://localhost:8080/appDemo/user/addUser.action
　　http://localhost:8080/appDemo/user/updateUser.actionl
3 扩展名匹配

　　以“*.”开头的字符串被用于扩展名匹配

1. <servlet-mapping>
2.     <servlet-name>MyServlet</servlet-name>
3.     <url-pattern>*.jsp</url-pattern>
4.     <url-pattern>*.action</url-pattern>
5. </servlet-mapping>

复制代码

　　则任何扩展名为jsp或action的url请求都会匹配，比如下面的url都会被匹配
　　http://localhost:8080/appDemo/user/users.jsp
　　http://localhost:8080/appDemo/toHome.action
4 缺省匹配

1. <servlet-mapping>
2.     <servlet-name>MyServlet</servlet-name>
3.     <url-pattern>/</url-pattern>
4. </servlet-mapping>

复制代码

二、匹配顺序

• 精确匹配：
  ​        servlet-mapping1：/user/users.html
  ​        servlet-mapping2：/*
  ​        当一个请求 http://localhost:8080/appDemo/user/users.html 来的时间，servlet-mapping1匹配到，不再用servlet-mapping2匹配
  
• 路径匹配：
  ​        先最长路径匹配，再最短路径匹配
  ​        servlet-mapping1：/user/*
  ​        servlet-mapping2：/*
  ​        当一个请求 http://localhost:8080/appDemo/user/users.html 来的时间，servlet-mapping1匹配到，不再用servlet-mapping2匹配
  
• 扩展名匹配：
  ​        servlet-mapping1：/user/*
  ​        servlet-mapping2：*.action
  ​        当一个请求 http://localhost:8080/appDemo/user/addUser.action 来的时间，servlet-mapping1匹配到，不再用servlet-mapping2匹配
  
• 缺省匹配：
  ​        以上都找不到servlet，就用默认的servlet，配置为/
  

三、需要注意的标题

1 路径匹配和扩展名匹配无法同时设置

　　匹配方法只有三种，要么是路径匹配（以“/”字符开头，并以“/*”结尾），要么是扩展名匹配（以“*.”开头），要么是精确匹配，三种匹配方法不能进行组合，不要想当然使用通配符或正则规则。
　　如/user/*.action黑白法的
　　另外注意：/aa/*/bb是精确匹配，合法，这里的*不是通配的含义，就是字面实体含义
2 "/*"和"/"含义并不相同

　　“/*”属于路径匹配，而且可以匹配所有request，由于路径匹配的优先级仅次于精确匹配，以是“/*”会覆盖所有的扩展名匹配，许多404错误均由此引起，以是这是一种特别恶劣的匹配模式，一样平常只用于filter的url-pattern
　　“/”是servlet中特别的匹配模式，切该模式有且仅有一个实例，优先级最低，不会覆盖其他任何url-pattern，只是会更换tomcat容器的内建default servlet ，该模式同样会匹配所有request。
　　配置“/”后，一种大概的征象是myServlet会拦截诸如 http://localhost:8080/appDemo/user/addUser.action 、 http://localhost:8080/appDemo/user/updateUser 的格式的请求，但是并不会拦截 http://localhost:8080/appDemo/user/users.jsp 、 http://localhost:8080/appDemo/index.jsp ，这是应为servlet容器有内置的“*.jsp”匹配器，而扩展名匹配的优先级高于缺省匹配，以是才会有上述征象。
　　Tomcat在%CATALINA_HOME%\conf\web.xml文件中配置了默认的Servlet，配置代码如下

1.     <servlet>
2.         <servlet-name>default</servlet-name>
3.         <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
4.         <init-param>
5.             <param-name>debug</param-name>
6.             <param-value>0</param-value>
7.         </init-param>
8.         <init-param>
9.             <param-name>listings</param-name>
10.             <param-value>false</param-value>
11.         </init-param>
12.         <load-on-startup>1</load-on-startup>
13.     </servlet>
14.    
15.     <servlet>
16.         <servlet-name>jsp</servlet-name>
17.         <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
18.         <init-param>
19.             <param-name>fork</param-name>
20.             <param-value>false</param-value>
21.         </init-param>
22.         <init-param>
23.             <param-name>xpoweredBy</param-name>
24.             <param-value>false</param-value>
25.         </init-param>
26.         <load-on-startup>3</load-on-startup>
27.     </servlet>
28.    
29.     <servlet-mapping>
30.         <servlet-name>default</servlet-name>
31.         <url-pattern>/</url-pattern>
32.     </servlet-mapping>
33.     <servlet-mapping>
34.         <servlet-name>jsp</servlet-name>
35.         <url-pattern>*.jsp</url-pattern>
36.         <url-pattern>*.jspx</url-pattern>
37.     </servlet-mapping>

复制代码

• 可以阅读 http://stackoverflow.com/questions/4140448/difference-between-and-in-servlet-mapping-url-pattern
  
• “/*”和“/”均会拦截静态资源的加载，需要特别注意
  

四、举例

映射的URL	对应的Servlet
/hello	servlet1
/bbs/admin/*	servlet2
/bbs/*	servlet3
*.jsp	servlet4
/	servlet5

实际请求映射的结果

去掉上下文路径的剩余路径	处理请求的Servlet
/hello	servlet1
/bbs/admin/login	servlet2
/bbs/admin/index.jsp	servlet2
/bbs/display	servlet3
/bbs/index.jsp	servlet3
/bbs	servlet3
/index.jsp	servler4
/hello/index.jsp	servlet4
/hello/index.html	servlet5
/news	servlet5

补充：

1、”缺省“ 的意思就是默认，这是古早盘算机翻译的锅，将英文单词 'default' 翻译成了这个词
2、web应用程序的根目录是一个特别的目录，当它被default servlet(即url-pattern配置为”/“)匹配时，不会先进入到这个servlet，而是被转发到欢迎页面，如果找不到欢迎页面，才会进入default servlet
tomcat源码片断：
[code][/code]<blockquote>
大意
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。

---

欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/)

Powered by Discuz! X3.4