SpringBoot配置嵌入式服務(wù)器的實(shí)操演示
Servlet 三大組件是Java Web開發(fā)的核心基礎(chǔ),包括:Servlet、Filter 和 Listener。
Servlet:
- 用于處理客戶端請(qǐng)求并生成動(dòng)態(tài)響應(yīng)的Java類
- 運(yùn)行在服務(wù)器端的Java程序
Filter(過濾器):
- 用于對(duì)請(qǐng)求和響應(yīng)進(jìn)行預(yù)處理和后處理
- 在請(qǐng)求到達(dá)Servlet之前和響應(yīng)返回客戶端之前執(zhí)行
Listener(監(jiān)聽器):
- 用于監(jiān)聽Web應(yīng)用中的事件
- 當(dāng)特定事件發(fā)生時(shí)自動(dòng)執(zhí)行回調(diào)方法
| 組件 | 作用 | 生命周期 | 應(yīng)用場景 |
|---|---|---|---|
| Servlet | 處理請(qǐng)求和生成響應(yīng) | 請(qǐng)求-響應(yīng) | 業(yè)務(wù)邏輯處理 |
| Filter | 請(qǐng)求/響應(yīng)預(yù)處理 | 請(qǐng)求-響應(yīng) | 安全檢查、日志、編碼轉(zhuǎn)換 |
| Listener | 監(jiān)聽?wèi)?yīng)用事件 | 應(yīng)用/會(huì)話/請(qǐng)求生命周期 | 資源管理、統(tǒng)計(jì)、初始化 |

為什么需要特殊方式注冊(cè) Servlet 三大組件?
傳統(tǒng) Java Web 應(yīng)用(WAR 包部署)通過web.xml配置 Servlet、Filter、Listener:
<!-- 傳統(tǒng)web.xml配置Servlet -->
<servlet>
<servlet-name>myServlet</servlet-name>
<servlet-class>com.example.MyServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>myServlet</servlet-name>
<url-pattern>/myServlet</url-pattern>
</servlet-mapping>Spring Boot 默認(rèn)以jar 包方式啟動(dòng),使用嵌入式 Servlet 容器(如 Tomcat),沒有web.xml文件。因此,Spring Boot 提供了通過Java 配置類 + @Bean注解的方式注冊(cè)三大組件。
注冊(cè)方式詳解
Spring Boot 通過三個(gè) “注冊(cè)器類” 包裝三大組件,再通過@Bean將注冊(cè)器注入 Spring 容器,完成組件注冊(cè):
| 組件類型 | 注冊(cè)器類 | 作用 |
|---|---|---|
| Servlet | ServletRegistrationBean | 注冊(cè)自定義 Servlet,指定訪問路徑 |
| Filter | FilterRegistrationBean | 注冊(cè)自定義 Filter,指定過濾的路徑 |
| Listener | ServletListenerRegistrationBean | 注冊(cè)自定義 Listener,監(jiān)聽容器事件 |
DispatcherServlet 本身就是一個(gè) Servlet,是 Spring MVC 的前端控制器,負(fù)責(zé)接收所有請(qǐng)求并分發(fā)。Spring Boot 在DispatcherServletAutoConfiguration中自動(dòng)注冊(cè)它,無需手動(dòng)配置。
實(shí)操演示:注冊(cè)自定義三大組件
步驟 1:創(chuàng)建自定義 Servlet、Filter、Listener
// 1. 自定義Servlet:處理請(qǐng)求
public class MyServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
resp.getWriter().write("Hello MyServlet!"); // 響應(yīng)內(nèi)容
System.out.println("MyServlet處理了GET請(qǐng)求");
}
}
// 2. 自定義Filter:過濾請(qǐng)求
public class MyFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
System.out.println("MyFilter執(zhí)行前");
chain.doFilter(request, response); // 放行請(qǐng)求
System.out.println("MyFilter執(zhí)行后");
}
}
// 3. 自定義Listener:監(jiān)聽Servlet容器事件(如啟動(dòng)、關(guān)閉)
public class MyListener implements ServletContextListener {
@Override
public void contextInitialized(ServletContextEvent sce) {
System.out.println("MyListener:Servlet容器初始化完成");
}
@Override
public void contextDestroyed(ServletContextEvent sce) {
System.out.println("MyListener:Servlet容器銷毀");
}
}步驟 2:通過配置類注冊(cè)組件(SpringBoot 1.x的版本去掉泛型)
@Configuration
public class ServletConfig {
// 注冊(cè)Servlet
@Bean
public ServletRegistrationBean<MyServlet> myServlet() {
// 關(guān)聯(lián)自定義Servlet,并指定訪問路徑為/myServlet
ServletRegistrationBean<MyServlet> registrationBean = new ServletRegistrationBean<>(new MyServlet(), "/myServlet");
registrationBean.setLoadOnStartup(1); // 啟動(dòng)順序(數(shù)字越小越先啟動(dòng))
return registrationBean;
}
// 注冊(cè)Filter
@Bean
public FilterRegistrationBean<MyFilter> myFilter() {
FilterRegistrationBean<MyFilter> registrationBean = new FilterRegistrationBean<>();
registrationBean.setFilter(new MyFilter()); // 關(guān)聯(lián)自定義Filter
// 指定過濾路徑:攔截/hello和/myServlet的請(qǐng)求
registrationBean.setUrlPatterns(Arrays.asList("/hello", "/myServlet"));
return registrationBean;
}
// 注冊(cè)Listener
@Bean
public ServletListenerRegistrationBean<MyListener> myListener() {
// 關(guān)聯(lián)自定義Listener
ServletListenerRegistrationBean<MyListener> registrationBean = new ServletListenerRegistrationBean<>(new MyListener());
return registrationBean;
}
}步驟 3:創(chuàng)建測試控制器(輔助驗(yàn)證 Filter)
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class TestController {
// 該路徑會(huì)被MyFilter過濾(因?yàn)镕ilter配置了攔截/hello)
@GetMapping("/hello")
public String hello() {
System.out.println("TestController的/hello方法執(zhí)行");
return "hello";
}
}步驟 4:啟動(dòng)應(yīng)用并驗(yàn)證
1. 驗(yàn)證 Listener(容器啟動(dòng)時(shí))
啟動(dòng) Spring Boot 應(yīng)用,控制臺(tái)會(huì)輸出 Listener 的初始化日志:
MyListener:Servlet容器初始化完成
2. 驗(yàn)證 Servlet 和 Filter
訪問http://localhost:8080/myServlet:
- 瀏覽器顯示響應(yīng):
Hello MyServlet! - 控制臺(tái)輸出(Filter 先執(zhí)行,再到 Servlet):
MyFilter執(zhí)行前 MyServlet處理了GET請(qǐng)求 MyFilter執(zhí)行后
3. 驗(yàn)證 Filter 對(duì)其他路徑的攔截
訪問http://localhost:8080/hello:
- 瀏覽器顯示響應(yīng):
hello - 控制臺(tái)輸出(Filter 攔截 /hello 請(qǐng)求):
MyFilter執(zhí)行前 TestController的/hello方法執(zhí)行 MyFilter執(zhí)行后
4. 驗(yàn)證未被 Filter 攔截的路徑
訪問http://localhost:8080/other(假設(shè)存在該路徑且未被 Filter 配置):
- 控制臺(tái)不會(huì)輸出
MyFilter的日志(僅控制器方法日志)。
步驟 5:驗(yàn)證DispatcherServlet的默認(rèn)行為
DispatcherServlet默認(rèn)攔截/,負(fù)責(zé)處理 Spring MVC 的所有請(qǐng)求(如/hello)??梢酝ㄟ^以下方式驗(yàn)證:
- 在
application.properties中修改其攔截路徑:
server.servletPath=/app/* # 修改為攔截/app/*路徑
- 重啟應(yīng)用后,原
/hello需訪問/app/hello才能被 Spring MVC 處理,否則返回 404(證明DispatcherServlet的攔截路徑已生效)。
到此這篇關(guān)于SpringBoot配置嵌入式服務(wù)器的實(shí)操演示的文章就介紹到這了,更多相關(guān)SpringBoot配置嵌入式服務(wù)器內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
詳解Spring中@Valid和@Validated注解用法
本文將以新增一個(gè)員工為功能切入點(diǎn),以常規(guī)寫法為背景,慢慢烘托出?@Valid?和?@Validated?注解用法詳解,文中的示例代碼講解詳細(xì),感興趣的可以了解一下2022-07-07
SpringBoot3?Web編程開發(fā)的工程搭建攔截器及測試工具示例
這篇文章主要介紹了SpringBoot3?Web編程開發(fā)的工程搭建攔截器及測試工具示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-08-08
Mybatis的一級(jí)緩存和二級(jí)緩存原理分析與使用
mybatis-plus 是一個(gè) Mybatis 的增強(qiáng)工具,在 Mybatis 的基礎(chǔ)上只做增強(qiáng)不做改變,為簡化開發(fā)、提高效率而生,這篇文章帶你了解Mybatis的一級(jí)和二級(jí)緩存2021-11-11
SpringBoot自動(dòng)裝配注解的實(shí)現(xiàn)示例
本文主要介紹了SpringBoot自動(dòng)裝配注解的實(shí)現(xiàn)示例,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2026-04-04

