Servlet中/和/*的區(qū)別詳解
本文提綱

版本約定
- JDK:8
- Servlet:4.x
- tomcat:9.x
✍正文
什么樣的答案終身難忘?學(xué)生時(shí)代關(guān)于記憶經(jīng)常能聽見兩種論調(diào):
- 死記硬背:見效快,但也忘得快,且一般不會(huì)靈活運(yùn)用(指標(biāo)不治本)
- 理解性記憶:見效慢,但記憶持久且會(huì)靈活運(yùn)用(治標(biāo)又治本)
如果是你,你愿意pick哪種?
正所謂授人以魚不如授人以漁,后者方能形成永久記憶。不謀而合,本文將采用后種講述方式,幫你記憶持久化。
關(guān)于/和/*的區(qū)別這個(gè)問題,依稀記得2015年我自學(xué)那會(huì)就能把它倆搞得明明白白,并且通過理解形成了“永久記憶”,所以至那會(huì)其就從來沒有犯過迷糊,難道我就這么重視基礎(chǔ)么(md,又在吹牛。。。)
點(diǎn)撥“市面上”的錯(cuò)誤答案
如果用谷歌百度一下關(guān)鍵字:/和/*的區(qū)別,搜索出來的答案不客氣的說,基本全錯(cuò)?。。?/strong> 錯(cuò)誤的姿勢(shì)基本還一模一樣,原因你懂的。
各種錯(cuò)誤case,且聽我娓娓道來。搜集了下有如下4種主流答案,一一點(diǎn)撥。
環(huán)境說明:使用原生Servlet,war包方式部署至外置Tomcat作為服務(wù)器,端口號(hào)8080,context-path為:appcontext

1、/用于Servlet,/*用于Filter
反例:
@WebFilter(urlPatterns = {"/*"})
public class FakeServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println("FakeServlet收到請(qǐng)求:" + req.getRequestURI());
}
}
啟動(dòng)服務(wù)器,瀏覽器訪問:http://localhost:8080/appcontext/api/demo1,控制臺(tái)輸出:
FakeServlet收到請(qǐng)求:/appcontext/api/demo1
一般來講/確實(shí)用于Servlet,/*用于Filter,但并不代表這是正確的。
說明:Filter路徑模式使用
/無效
2、/不會(huì)匹配.jsp請(qǐng)求,而/*可以匹配到.jsp請(qǐng)求
這個(gè)結(jié)論表面上看沒有問題,但是往深了想一步,是否能夠推導(dǎo)出這個(gè)結(jié)論:“/不會(huì)匹配.html請(qǐng)求,而/*可以匹配到.html請(qǐng)求”。試試看:
@WebServlet(urlPatterns = {"/"})
public class FakeServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println("FakeServlet收到請(qǐng)求:" + req.getRequestURI());
}
}
@WebFilter(urlPatterns = {"/*"})
public class FakeFilter extends HttpFilter {
@Override
protected void doFilter(HttpServletRequest req, HttpServletResponse res, FilterChain chain) throws IOException, ServletException {
System.out.println("FakeFilter收到請(qǐng)求:" + req.getRequestURI());
super.doFilter(req, res, chain);
}
}
啟動(dòng)服務(wù)器,瀏覽器訪問:http://localhost:8080/appcontext/api/demo1.jsp,控制臺(tái)輸出:
FakeFilter收到請(qǐng)求:/appcontext/api/demo1.jsp
servlet并未匹配上,似乎符合此結(jié)論:/不會(huì)匹配.jsp請(qǐng)求,而/*可以。
瀏覽器再訪問:http://localhost:8080/appcontext/api/demo1.html,控制臺(tái)輸出:
FakeFilter收到請(qǐng)求:/appcontext/api/demo1.html
FakeServlet收到請(qǐng)求:/appcontext/api/demo1.html
Filter和Servlet都匹配成功,破功了吧!
所以說,局限于該回答本身沒有問題,而問題在于.jsp后綴是一種特殊的請(qǐng)求,拿特殊案例當(dāng)做通用結(jié)論肯定是站不住腳的。
3、/*匹配范圍比/大
通過本文下面的講解你就會(huì)知道:/屬于最大的的匹配范圍,而/*恰好是范圍和/一樣了而已,但/*的優(yōu)先級(jí)比/高,并不是它的匹配范圍比/大。
4、/匹配所有url(路徑+后綴),/*只匹配路徑型
用一句話反駁:/*也能匹配上/api/demo1.html這種后綴型url(其實(shí)上面已經(jīng)給出示例了)
這4個(gè)結(jié)論搜索排名非??壳?,不知誤導(dǎo)了多少小朋友呀。與其每次將信將疑,倒不如花點(diǎn)時(shí)間寫代碼自己做個(gè)試驗(yàn)來得靠譜。我一向推崇的代碼多動(dòng)手,人云亦云不如自己來上一發(fā)。
帶著這幾個(gè)❌結(jié)論,接下來開始發(fā)大招啦:從根本上帶你理解Servlet規(guī)范的URL匹配機(jī)制,從而理解到/和/*的區(qū)別,授之以漁讓你終身難忘。
Servlet的urlPatterns路徑映射
說明:本文所指的Servlet是廣義的(規(guī)范),所以也包含F(xiàn)ilter的urlPatterns
Servlet/Filter是服務(wù)端的一段小程序,用于處理Http請(qǐng)求。每個(gè)Servlet可以映射1個(gè)or多個(gè)路徑,在xml時(shí)代這么寫(url-pattern標(biāo)簽可寫多個(gè)):
<servlet-mapping> <servlet-name>Demo1Servlet</servlet-name> <url-pattern>/api/demo1</url-pattern> <url-pattern>/api/demo2</url-pattern> </servlet-mapping>
@WebServlet注解方式這么寫:
@WebServlet(urlPatterns = {"/api/demo1", "/api/demo2"})
public class Demo1Servlet extends HttpServlet { ... }
此時(shí),該Servlet就能處理這兩種 URL了。
問題來了,如果希望本Servlet處理某一類請(qǐng)求,該怎么破呢?
一類請(qǐng)求顯然是無法一一枚舉出來的,這時(shí)就需要用到Servlet的模式匹配了。urlPatterns除了寫字面量的字符串,還支持pattern模式的字符串(從該屬性的命名你應(yīng)該也能看出來)。
接下來聚焦于Servlet的匹配方式展開詳細(xì)講解,這是本文的核心內(nèi)容。
Servlet四種匹配方式
在Servlet規(guī)范中一共約定了四種匹配方式,無一例外,每種方式都非常重要和常用,下面逐一介紹。
1. 精確匹配
顧名思義,urlPatterns是個(gè)無通配符的精確字符串,如:
@WebServlet(urlPatterns = {"/api/demo1", "/api/demo2"}) // 精確匹配
public class UrlPatternDemoServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.printf("收到請(qǐng)求:%s ServletPath:%s PathInfo:%s\n", req.getRequestURI(), req.getServletPath(), req.getPathInfo());
}
}
打印里輸出servletPath和pathInfo信息,讓日志更具對(duì)比性
瀏覽器訪問http://localhost:8080/appcontext/api/demo1和/api/demo2均能收到該請(qǐng)求,控制臺(tái)分別打?。?/p>
收到請(qǐng)求:/appcontext/api/demo1 ServletPath:/api/demo1 PathInfo:null
收到請(qǐng)求:/appcontext/api/demo2 ServletPath:/api/demo2 PathInfo:null
2. 路徑匹配
pattern規(guī)則:以/開頭,且以/*結(jié)尾。如:
@WebServlet(urlPatterns = {"/api/*", "/*"}) // 路徑匹配
public class UrlPatternDemoServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 同上
}
}
瀏覽器訪問http://localhost:8080/appcontext/api/demo1,控制臺(tái)輸出(匹配的/api/*):
收到請(qǐng)求:/appcontext/api/demo1 ServletPath:/api PathInfo:/demo1
訪問http://localhost:8080/appcontext/apiapi/demo1,控制臺(tái)輸出(匹配的/*:
收到請(qǐng)求:/appcontext/apiapi/demo1 ServletPath: PathInfo:/apiapi/demo1
關(guān)注點(diǎn):當(dāng)匹配上/*模式時(shí),ServletPath的值為空串,但PathInfo的值更為“豐富”了。
3. 后綴名匹配
patten規(guī)則:以*.開頭(注意是開頭,所以/api/*.jsp這么寫是非法的)。如:
@WebServlet(urlPatterns = {"*.jsp", "*.*"}) // 后綴名匹配
public class UrlPatternDemoServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 同上
}
}
訪問http://localhost:8080/appcontext/api/demo1,結(jié)果404,因?yàn)闆]有后綴嘛;
訪問http://localhost:8080/appcontext/api/demo1.jsp,控制臺(tái)輸出(匹配*.jsp):
收到請(qǐng)求:/appcontext/api/demo1.jsp ServletPath:/api/demo1.jsp PathInfo:null
訪問http://localhost:8080/appcontext/api/demo1.servlet,結(jié)果404,因?yàn)閡rlPatterns里沒有匹配.servlet后綴的模式;
訪問http://localhost:8080/appcontext/api/demo1.,結(jié)果404,原因同上
訪問http://localhost:8080/appcontext/api/demo1.*,控制臺(tái)打?。ㄆヅ?code>*.*):
收到請(qǐng)求:/appcontext/api/demo1.* ServletPath:/api/demo1.* PathInfo:null
發(fā)現(xiàn)沒,這種匹配方式還蠻“特殊”的,需要注意這兩點(diǎn):
- 該模式以
*.開頭,后面的均是常量,即使是*也是常量。比如*.*匹配的后綴必須是.*而不能是其它 - 該匹配方式下,pathInfo永遠(yuǎn)是null,servletPath永遠(yuǎn)是“全部”
4. 缺省匹配
pattern規(guī)則:固定值/。如:
想一想,這不就是我們熟悉的DispatcherServlet的匹配路徑么?
@WebServlet(urlPatterns = "/") // 缺省匹配
public class UrlPatternDemoServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
// 同上
}
}
這個(gè)時(shí)候匹配任意路徑。
訪問http://localhost:8080/appcontext,控制臺(tái)打?。?/p>
收到請(qǐng)求:/appcontext/ ServletPath:/ PathInfo:null
訪問http://localhost:8080/appcontext/api/demo1,控制臺(tái)打?。?/p>
收到請(qǐng)求:/appcontext/api/demo1 ServletPath:/api/demo1 PathInfo:null
訪問http://localhost:8080/appcontext/api/demo1.html,控制臺(tái)打印:
收到請(qǐng)求:/appcontext/api/demo1.html ServletPath:/api/demo1.html PathInfo:null
此匹配規(guī)則下,pathInfo永遠(yuǎn)是null,servletPath永遠(yuǎn)是“全部”。
關(guān)于pathInfo:pathInfo只有當(dāng)Servlet是路徑匹配時(shí),才有值。其它情況永遠(yuǎn)為null
URL匹配注意事項(xiàng)
Servlet對(duì)URL的匹配既不是Ant風(fēng)格,也不是Regex。特殊符號(hào)只有單個(gè)的*,且使用位置有強(qiáng)約束,切忌想當(dāng)然的隨意拼湊。
舉例兩種典型的錯(cuò)誤理解,應(yīng)該能幫助到你:
/api/*.jsp:該urlPatterns是非法的,啟動(dòng)時(shí)會(huì)報(bào)錯(cuò)“IllegalArgumentException: servlet映射中的[/api/*.jsp]無效”。原因?yàn)椋?- 若當(dāng)路徑匹配,
/*后面不能再有任何東西 - 若當(dāng)后綴名匹配,
*.必須是最前面
- 若當(dāng)路徑匹配,
/api/*/demo:這個(gè)urlPatterns是合法的。只不過它屬于精確匹配,也就是說別看它中間有*,仍舊有且僅能匹配/api/*/demo這個(gè)請(qǐng)求路徑
匹配順序
有時(shí)候一個(gè)URL會(huì)被多個(gè)urlPatterns所匹配,這時(shí)誰優(yōu)先呢?
Servlet同樣遵循“國(guó)際慣例”:越精確越優(yōu)先,越模糊越靠后。站在pattern模式的角度換句話講就是:范圍越小越優(yōu)先,范圍越大越靠后。
因此Servlet四種匹配方式順序按范圍從小到大(優(yōu)先級(jí)從高到底)排序?yàn)椋?strong>精確匹配 > 路徑匹配 > 后綴名匹配 > 缺省匹配。
/和/*的區(qū)別
終于,來到了今天的主菜。
從上至下的閱讀到這里,再看這個(gè)問題,是不是覺得答案已經(jīng)浮出水面?那么,最后我還是來總結(jié)一下它倆的異同點(diǎn):
相同點(diǎn)
絕大部分場(chǎng)景下具有相同的表現(xiàn):匹配所有。
不同點(diǎn)
就是由于它們的相同點(diǎn)(如此相似),所以才讓我們難以區(qū)分。
關(guān)于/:
- servlet中特殊的匹配模式(用在Filter中無效),
- 因?yàn)槭侨笔∑ヅ浯砥ヅ渌新窂?,所以只可能存在一個(gè)實(shí)例(若存在多個(gè)就覆蓋)
- 優(yōu)先級(jí)最低(兜底),這是和/*的最大區(qū)別。它不會(huì)覆蓋任何其它的url-pattern,只會(huì)覆蓋Servlet容器(如Tomcat)內(nèi)建的DefaultServlet
關(guān)于/*:
- 屬于4中匹配模式中的路徑匹配,可用于Servlet和Filter
- 優(yōu)先級(jí)很高(僅次于精確匹配)。所以它會(huì)覆蓋所有的后綴名匹配,從而很容易引起404問題,所以這種模式的“傷害性”是非常強(qiáng)的,一般有且僅用在Filter上
DispatcherServlet不攔截.jsp請(qǐng)求根因分析
/只能用于Servlet上,/*一般只用于Filter上。
大家熟悉的Spring MVC的DispatcherServlet的匹配路徑默認(rèn)就是/,它會(huì)攔截各種各樣的請(qǐng)求,諸如下面這種請(qǐng)求都會(huì)攔截:
- /api/demo1
- /html/demo1.html
- /static/main.js
但是,它不會(huì)攔截/api/demo1.jsp這種以.jsp結(jié)尾的請(qǐng)求。據(jù)此現(xiàn)象就出現(xiàn)了:/不攔.jsp請(qǐng)求而/*攔截(/*的范圍比/大)這種“錯(cuò)誤”言論。
下面告訴你此現(xiàn)象的根因:Servlet容器(如Tomcat)內(nèi)置有專門匹配.jsp這種請(qǐng)求的Servlet處理器,如下圖所示:

而后綴名匹配優(yōu)先級(jí)高于缺省匹配,所以.jsp結(jié)尾的請(qǐng)求不會(huì)被DispatcherServlet所“截胡”而是交給了JspServlet處理。
有了這波分析后,就問你,是不是就不用死記答案了?是不是就終身難忘啦?
✍總結(jié)
Servlet的urlPatterns匹配方式是學(xué)習(xí)Java Web的重要一環(huán),也是深入理解Spring MVC原理的大門,畢竟Spring MVC依舊是做業(yè)務(wù)開發(fā)的首選,而且還會(huì)持續(xù)很久、很久。
本文對(duì)Servlet的匹配方式做了全覆蓋講解,包括:
四種匹配方式匹配順序(優(yōu)先級(jí))Servlet和Filter匹配的區(qū)別模式匹配中/和/*區(qū)別的根本原因
通過本文希望能讓你不再被Servlet的模式匹配所困擾,更不要被一些似可非可的結(jié)論所迷惑,搖擺不定時(shí)大不了編碼驗(yàn)證一下嘛。
本文通過授人以漁的方式道出/和/*的區(qū)別,期待能成為你的永久記憶,我做到了嗎?
到此這篇關(guān)于Servlet中/和/*的區(qū)別詳解的文章就介紹到這了,更多相關(guān)Servlet中/和/*的區(qū)別內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Java Mybatis框架增刪查改與核心配置詳解流程與用法
MyBatis 是一款優(yōu)秀的持久層框架,它支持自定義 SQL、存儲(chǔ)過程以及高級(jí)映射。MyBatis 免除了幾乎所有的 JDBC 代碼以及設(shè)置參數(shù)和獲取結(jié)果集的工作。MyBatis 可以通過簡(jiǎn)單的 XML 或注解來配置和映射原始類型、接口和 Java POJO為數(shù)據(jù)庫(kù)中的記錄2021-10-10
Java代碼實(shí)現(xiàn)對(duì)properties文件有序的讀寫的示例
本篇文章主要介紹了Java代碼實(shí)現(xiàn)對(duì)properties文件有序的讀寫的示例,小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2017-11-11
Java虛擬機(jī)JVM性能優(yōu)化(一):JVM知識(shí)總結(jié)
這篇文章主要介紹了Java虛擬機(jī)JVM性能優(yōu)化(一):JVM知識(shí)總結(jié),本文是系列文章的第一篇,后續(xù)篇章請(qǐng)繼續(xù)關(guān)注腳本之家,需要的朋友可以參考下2014-09-09
idea遠(yuǎn)程Debug部署在服務(wù)器上的服務(wù)
在開發(fā)的時(shí)候我們通常在本地代碼上debug程序,但是服務(wù)部署到了開發(fā)環(huán)境服務(wù)器上,如何遠(yuǎn)程調(diào)試,本文主要介紹了idea遠(yuǎn)程Debug部署在服務(wù)器上的服務(wù),具有一定的參考價(jià)值,感興趣的可以了解一下2023-12-12
SpringBoot參數(shù)校驗(yàn)之@Valid的使用詳解
這篇文章主要通過示例為大家詳細(xì)介紹一下介紹了SpringBoot參數(shù)校驗(yàn)中@Valid的使用方法,文中的示例代碼講解詳細(xì),需要的可以參考一下2022-06-06
Java JDK動(dòng)態(tài)代理(AOP)的實(shí)現(xiàn)原理與使用詳析
所謂代理,就是一個(gè)人或者一個(gè)機(jī)構(gòu)代表另一個(gè)人或者另一個(gè)機(jī)構(gòu)采取行動(dòng)。下面這篇文章主要給大家介紹了關(guān)于Java JDK動(dòng)態(tài)代理(AOP)實(shí)現(xiàn)原理與使用的相關(guān)資料,文中通過示例代碼介紹的非常詳細(xì),需要的朋友可以參考借鑒,下面來一起看看吧。2017-07-07

