servlet的url-pattern匹配规则

---

前言

在利用servlet进行url请求的匹配时，很关键的一点就是匹配规则，但servlet容器中的匹配规则既不是简单的通配，也不是正则表达式，而是有自己的规则，比较容易混淆。某不才进行举例介绍。下面的说明都在tomcat服务器中得到验证。

一、什么是servlet的url匹配？

在一个web.xml文件中，有如下信息：

<servlet>
    <servlet-name>ServletDemo</servlet-name>
    <servlet-class>com.wmh.ServletDemo</servlet-class>
  </servlet>
  
  <servlet-mapping>
    <servlet-name>ServletDemo</servlet-name>
    <url-pattern>/servletDemo</url-pattern>
    <url-pattern>xxxxxxx</url-pattern>
  </servlet-mapping>

上面的配置信息，其中<servlet>标签首先配置声明一个servlet，包括servlet的名字和对应的java类名。
其中<servlet-mapping>标签声明了与该servlet相应的匹配规则，每个<url-pattern>标签代表1个匹配规则。
当浏览器发起一个url请求后，该请求发送到servlet容器的时候，容器先会将请求的url减去当前应用上下文的路径作为servlet的映射url，比如url是http://localhost:8080/z2020052055_01_servletDemo/servletdemo01，其应用上下文是z2020052055_01_servletDemo，容器会将http://localhost:8080/z2020052055_01_servletDemo去掉，剩下的/servletdemo01部分拿来做servlet的映射匹配。

二、各类匹配规则

1.精确匹配

代码如下（示例）：

<servlet-mapping>
    <servlet-name>ServletDemo</servlet-name>
    <url-pattern>/servletDemo/servletDemo01</url-pattern>
    <url-pattern>/servletDemo01</url-pattern>
    <url-pattern>/xxxxxx</url-pattern>
</servlet-mapping>

当在浏览器中输入如下几种url时，都会被匹配到该servlet
http://localhost:8080/z2020052055_01_servletDemo/servletDemo/servletDemo01
http://localhost:8080/z2020052055_01_servletDemo/servletDemo01
http://localhost:8080/z2020052055_01_servletDemo/xxxxxx
注意：

http://localhost:8080/z2020052055_01_servletDemo/xxxxxx/ 是非法的url，不会被当作http://localhost:8080/z2020052055_01_servletDemo/xxxxxx识别

另外上述url后面可以跟任意的查询条件，都会被匹配，如:
http://localhost:8080/z2020052055_01_servletDemo/xxxxxx?hello 这个请求就会被匹配到ServletDemo。

2.拓展名匹配

代码如下（示例）：

<servlet-mapping>
    <servlet-name>ServletDemo</servlet-name>
    <url-pattern>*.jsp</url-pattern>
</servlet-mapping>

则任何扩展名为jsp（文件名和路径任意）的url请求都会匹配，比如下面的url都会被匹配
http://localhost:8080/z2020052055_01_servletDemo/index.jsp
http://localhost:8080/z2020052055_01_servletDemo/readme.jsp

3.路径匹配

代码如下（示例）：

<servlet-mapping>
    <servlet-name>ServletDemo</servlet-name>
    <url-pattern>/servlet/*</url-pattern>
</servlet-mapping>

则请求的ulr只要前面（myapp之后）的路径是/kata，而后面的路径可以任意。比如下面的url都会被匹配。
http://localhost:8080/z2020052055_01_servletDemo/servletDemo/demo
http://localhost:8080/z2020052055_01_servletDemo/servletDemo/test.jsp

注意：
路径和扩展名匹配无法同时设置，比如下面的三个<url-pattern>都是非法的，如果设置，启动tomcat服务器会报错。

<url-pattern>/kata/*.jsp</url-pattern>

<url-pattern>/*.jsp</url-pattern>

<url-pattern>he*.jsp</url-pattern>

另外注意：

<url-pattern>/aa/*/bb</url-pattern>

这个是精确匹配，url必须是 /aa/*/bb，这里的*不是通配的含义

---

总结

拙作简单介绍了servlet的url-patttern匹配规则，总的来说就是分为精确、路径和拓展名匹配三种匹配方式。
晚生初识javaee，才疏学浅，不足之处，敬请斧正。

鸣谢

某不才立于巨人之肩（排名不分先后）：
servlet与url匹配规则详细介绍
Sping容器和应用上下文理解