ServletComponentScan 注解的作用
@ServletComponentScan 注解是 Spring Boot 提供的一个非常方便的注解，它的主要作用是启用对 Servlet 3.0+ 规范中定义的标准 Servlet 组件（如 Servlets, Filters, Listeners）的扫描和自动注册。
具体来说，当你使用这个注解时，Spring Boot 会自动扫描指定包（或默认包）下带有以下标准注解的类，并将它们注册到嵌入式的 Servlet 容器中（如 Tomcat, Jetty, Undertow）：
@WebServlet: 用于定义一个 Servlet。@WebFilter: 用于定义一个 Filter。@WebListener: 用于定义一个 Listener (如ServletContextListener,HttpSessionListener,ServletRequestListener等)。
如何使用？
通常，你会将 @ServletComponentScan 注解添加到你的主 Spring Boot 应用类上（即带有 @SpringBootApplication 注解的类）：
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletComponentScan;@SpringBootApplication
@ServletComponentScan // 启用 Servlet 组件扫描
public class MyApplication {public static void main(String[] args) {SpringApplication.run(MyApplication.class, args);}
}
然后，你就可以在你的项目中像下面这样定义 Servlet、Filter 或 Listener：
示例：定义一个 Servlet
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;@WebServlet(urlPatterns = "/myServlet", name = "myCustomServlet")
public class MyServlet extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {resp.getWriter().write("Hello from MyServlet!");}
}
示例：定义一个 Filter
import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import java.io.IOException;@WebFilter(urlPatterns = "/*", filterName = "myCustomFilter")
public class MyFilter implements Filter {@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)throws IOException, ServletException {System.out.println("MyFilter: Before processing request");chain.doFilter(request, response);System.out.println("MyFilter: After processing request");}// init() 和 destroy() 方法可以按需实现
}
示例：定义一个 Listener
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;@WebListener
public class MyContextListener implements ServletContextListener {@Overridepublic void contextInitialized(ServletContextEvent sce) {System.out.println("MyContextListener: ServletContext initialized!");}@Overridepublic void contextDestroyed(ServletContextEvent sce) {System.out.println("MyContextListener: ServletContext destroyed!");}
}
@ServletComponentScan 的属性：
value或basePackages: 字符串数组，用于指定需要扫描的包。例如：@ServletComponentScan(basePackages = "com.example.webcomponents")。basePackageClasses: Class 类型数组，用于指定一些类，Spring Boot 会扫描这些类所在的包。例如：@ServletComponentScan(basePackageClasses = MyServlet.class)。
如果这两个属性都没有指定，Spring Boot 会默认扫描添加了 @ServletComponentScan 注解的类所在的包及其子包。
为什么需要 @ServletComponentScan？
- 简化配置：在没有 Spring Boot 或这个注解之前，你需要在
web.xml文件中显式配置 Servlet、Filter 和 Listener，或者使用 Servlet 3.0+ 的编程式注册方式（通过ServletContext）。@ServletComponentScan使得使用注解驱动的方式更加便捷。 - 与 Spring Boot 集成：虽然这些是标准的 Servlet 组件，但
@ServletComponentScan确保它们能被 Spring Boot 的自动配置机制正确识别和集成到嵌入式 Servlet 容器中。 - 依赖注入：Spring Boot 也会尝试对通过
@ServletComponentScan扫描到的组件进行依赖注入（例如，你可以在 Filter 或 Servlet 中@AutowiredSpring管理的 Bean）。
与通过 Spring Bean 注册的区别：
你也可以通过 Spring 的 ServletRegistrationBean, FilterRegistrationBean, ServletListenerRegistrationBean 等 Bean 来注册 Servlet 组件。这种方式的好处是你可以更细致地控制它们的属性（如顺序、初始化参数等），并且它们本身就是 Spring Bean，完全由 Spring 管理。
使用 @ServletComponentScan 注册的组件，它们主要是由 Servlet 容器直接管理，Spring Boot 提供了桥梁让容器能够发现它们，并辅助进行依赖注入。
总结：
@ServletComponentScan 是 Spring Boot 中用于自动发现和注册使用标准 @WebServlet, @WebFilter, @WebListener 注解声明的 Servlet、Filter 和 Listener 的便捷方式。它简化了配置，使得我们在开发过程中可以专注于业务逻辑，而不是繁琐的 XML 配置或编程式注册。