環(huán)境：SpringBoot2.7.16

1. Servlet/Filter/*Listener注冊

任何Spring bean的Servlet、Filter或 *Listener實例都會自動注冊到容器中。如果你想從應(yīng)用程序中引用一個值，@Value獲取application.properties值。

@Component
public class DemoServlet extends HttpServlet {
  @Override
  protected void service(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
    resp.getWriter().println("demo servlet") ;
  }
}

直接將Servlet注冊為Bean，容器會自動注冊。有一點需要注意：如果僅僅只有一個Servlet，那它的訪問url是 '/' 。這會與默認的DispatcherServlet路徑一樣。如果你有多個Servlet，那么訪問路徑將是：'/beanName/'，如上面的DemoServlet默認的訪問路徑：'/demoServlet/'。

如果基于約定的映射不夠靈活，可以使用ServletRegistrationBean、FilterRegistrationBean和ServletListenerRegistrationBean類進行完全控制。

過濾器Filter默認映射路徑是：'/*'。

提示：

若要查看應(yīng)用程序中每個Filter的順序，請為web日志記錄組啟用調(diào)試級別日志記錄（logging.level.web=debug）。注冊過濾器的詳細信息，包括它們的順序和URL模式，將在啟動時記錄下來。

2. Servlet Conetxt初始化

嵌入式Servlet容器不會直接執(zhí)行Servlet3.0+ javax.servlet.ServletContainerInitializer接口或Spring的org.springframework.web.WebApplicationInitializer接口。這樣做是有意為之，目的是降低在war中運行的第三方庫破壞Spring Boot應(yīng)用程序的風(fēng)險。

如果需要在Spring Boot應(yīng)用程序中執(zhí)行Servlet上下文初始化，應(yīng)該注冊一個實現(xiàn)org.springframework.boot.web.servlet.ServletContextInitializer接口的bean。onStartup方法提供了對ServletContext的訪問，如果有必要，可以很容易地將其用作現(xiàn)有WebApplicationInitializer的適配器。

3. 掃描Servlet/Filter/*Listener

在使用嵌入式容器時，可以通過使用@ServletComponentScan來啟用自動注冊帶有@WebServlet、@WebFilter和@WebListener注解的類。

@ServletComponentScan在獨立容器中沒有效果，取而代之的是容器的內(nèi)置發(fā)現(xiàn)機制。

4. ServletWebServerApplicationContext

在底層，Spring Boot使用了另一種類型的ApplicationContext來支持嵌入式servlet容器。ServletWebServerApplicationContext是一種特殊類型的WebApplicationContext，它通過搜索單個ServletWebServerFactory bean來引導(dǎo)自己。通常TomcatServletWebServerFactory、jetttyservletwebserverfactory或UndertowServletWebServerFactory都是自動配置的。

在嵌入式容器設(shè)置中，ServletContext被設(shè)置為服務(wù)器啟動的一部分，該啟動發(fā)生在應(yīng)用程序上下文初始化期間。因此，ApplicationContext中的bean不能可靠地用ServletContext進行初始化。解決這個問題的一種方法是注入ApplicationContext作為bean的依賴項，并僅在需要時訪問ServletContext。另一種方法是在服務(wù)器啟動后使用回調(diào)函數(shù)。這可以使用ApplicationListener來監(jiān)聽ApplicationStartedEvent，如下所示:

public class PackContext implements ApplicationListener<ApplicationStartedEvent> {
  private ServletContext servletContext;
  @Override
  public void onApplicationEvent(ApplicationStartedEvent event) {
      ApplicationContext applicationContext = event.getApplicationContext() ;
      this.servletContext = ((WebApplicationContext) applicationContext).getServletContext() ;
  }
}

5. 自定義Servlet容器

可以使用Spring Environment屬性來配置常見的Servlet容器設(shè)置。通常，會在application.properties或application.yaml文件中定義屬性。

常見的服務(wù)器設(shè)置包括：

• 網(wǎng)絡(luò)設(shè)置：偵聽傳入HTTP請求的端口（server.port）、綁定到server.address的接口地址等。
• 會話設(shè)置:會話是否持久(server.servlet.session.persistent)，會話超時(server.servlet.session.timeout)，會話數(shù)據(jù)的位置(server.servlet.session.store-dir)，以及會話cookie配置(server.servlet.session.cookie.*)。
• 錯誤管理：錯誤頁的位置（server.error.path）等等。
• SSL
• HTTP compression

Spring Boot盡可能地嘗試公開通用設(shè)置，但并不總是可行。對于這些情況，專用的命名空間提供特定于服務(wù)器的自定義(請參見server.tomcat和server.undertow)。例如，可以用嵌入式Servlet容器的特定功能配置訪問日志。

字符編碼

用于請求和響應(yīng)處理的嵌入式servlet容器的字符編碼行為可以使用server.servlet.encoding.*配置屬性進行配置。

當(dāng)請求的Accept-Language頭指示請求的區(qū)域設(shè)置時，servlet容器將自動將其映射到字符集。每個容器都提供默認的區(qū)域設(shè)置到字符集映射，您應(yīng)該驗證它們是否滿足應(yīng)用程序的需要。如果沒有，請使用server.servlet.encoding.mapping配置屬性自定義映射，如下：

server:
  servlet:
    encoding:
      mapping:
        ko: "UTF-8"

通過編程自定義

如果需要以編程方式配置嵌入式servlet容器，可以注冊一個實現(xiàn)WebServerFactoryCustomizer接口的Spring bean。WebServerFactoryCustomizer提供對ConfigurationServletWebServerFactory的訪問，其中包括許多自定義setter方法。示例：

@Component
public class MyWebServerFactoryCustomizer implements WebServerFactoryCustomizer<ConfigurableServletWebServerFactory> {
  @Override
  public void customize(ConfigurableServletWebServerFactory server) {
    // 設(shè)置服務(wù)端口
    server.setPort(9000) ;
    // 設(shè)置異步超時時間
    server.addConnectorCustomizers((connector) -> connector.setAsyncTimeout(Duration.ofSeconds(20).toMillis())) ; 
  }
}

直接自定義ConfigurableServletWebServerFactory

對于需要從ServletWebServerFactory進行擴展的更高級的用例，你可以自己公開此類類型的bean。該接口提供如下配置

public interface ConfigurableServletWebServerFactory extends ConfigurableWebServerFactory, ServletWebServerFactory, WebListenerRegistry 
  void setContextPath(String contextPath);
  void setDisplayName(String displayName);
  void setSession(Session session);
  void setRegisterDefaultServlet(boolean registerDefaultServlet);
  void setMimeMappings(MimeMappings mimeMappings);
  void setDocumentRoot(File documentRoot);
  void setInitializers(List<? extends ServletContextInitializer> initializers);
  void addInitializers(ServletContextInitializer... initializers);
  void setJsp(Jsp jsp);
  void setLocaleCharsetMappings(Map<Locale, Charset> localeCharsetMappings);
  void setInitParameters(Map<String, String> initParameters);
  void setCookieSameSiteSuppliers(List<? extends CookieSameSiteSupplier> cookieSameSiteSuppliers);
  void addCookieSameSiteSuppliers(CookieSameSiteSupplier... cookieSameSiteSuppliers);
}

6. JSP限制

當(dāng)運行使用嵌入式servlet容器（并打包為可執(zhí)行歸檔文件）的Spring Boot應(yīng)用程序時，JSP支持存在一些限制。

• 使用Jetty和Tomcat，如果你使用war打包，它應(yīng)該可以正常工作。當(dāng)使用java -jar啟動時，可執(zhí)行war可以正常工作，也可以部署到任何標準容器。在使用可執(zhí)行jar時，不支持jsp。
• Undertow不支持JSP。
• 創(chuàng)建自定義error.jsp頁面不會覆蓋錯誤處理的默認視圖。應(yīng)該使用自定義錯誤頁面。

以上是本篇文章的全部內(nèi)容，希望對你有所幫助。