[SpringBoot] Spring Boot注册Web原生组件/拦截器HandlerInterceptor
创始人
2024-03-31 10:42:20
0

 ✨✨个人主页:沫洺的主页

 📚📚系列专栏: 📖 JavaWeb专栏📖 JavaSE专栏 📖 Java基础专栏📖vue3专栏 

                           📖MyBatis专栏📖Spring专栏📖SpringMVC专栏📖SpringBoot专栏

💖💖如果文章对你有所帮助请留下三连✨✨

🍊Spring Boot注册Web原生组件

由于 Spring Boot 默认以 Jar 包方式部署的,默认没有 web.xml,因此无法再像以前一样通过 web.xml 配置来使用 Servlet 、Filter、Listener,但 Spring Boot 提供了 2 种方式来注册这些 Web 原生组件

  • 通过组件扫描注册(注解)

  • 使用 RegistrationBean 注册

🍒通过组件扫描注册

Servlet 3.0 提供了以下 3 个注解:

  • @WebServlet:用于声明一个 Servlet;

  • @WebFilter:用于声明一个 Filter;

  • @WebListener:用于声明一个 Listener

这些注解可直接标注在对应组件上,它们与在 web.xml 中的配置意义相同。每个注解都具有与 web.xml 对应的属性,可直接配置,省去了配置 web.xml 的繁琐。

想要在 SpringBoot 中注册这些原生 Web 组件,可以使用 @ServletComponentScan 注解实现,该注解可以扫描标记 @WebServlet、@WebFilter 和 @WebListener 三个注解的组件类,并将它们注册到容器中。

注意:@ServletComponentScan 注解只能标记在启动类或配置类上。

注解注册---Servlet

@WebServlet("/loginServlet")
public class LoginServlet extends HttpServlet {@Overrideprotected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {response.setContentType("text/html;charset=utf-8");response.getWriter().write("登录测试");}@Overrideprotected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {doGet(request, response);}
}

启动类

@SpringBootApplication
@ServletComponentScan
public class App2 {public static void main(String[] args) {SpringApplication.run(App2.class, args);}
}

注解注册---过滤器Filter

@WebFilter(filterName = "loginFilter")
public class LoginFilter implements Filter {@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws ServletException, IOException {String token = request.getParameter("token");if("123".equals(token)){chain.doFilter(request,response);} else{HttpServletResponse httpServletResponse = (HttpServletResponse) response;httpServletResponse.sendError(HttpServletResponse.SC_UNAUTHORIZED, "令牌不正确");}}public void init(FilterConfig config) throws ServletException {}public void destroy() {System.out.println("过滤器被销毁时调用的方法...");}
}

启动类同上还是使用@ServletComponentScan

注解注册---监听器Listener

@Slf4j
@WebListener
public class ServletListener implements ServletRequestListener {@Overridepublic void requestInitialized(ServletRequestEvent sre) {log.info("-----请求进来-----");}@Overridepublic void requestDestroyed(ServletRequestEvent sre) {log.info("-----请求结束-----");}
}

启动类同上还是使用@ServletComponentScan

🍎使用 RegistrationBean 注册

我们还可以在配置类中使用 RegistrationBean 来注册原生 Web 组件,不过这种方式相较于注解方式要繁琐一些。使用这种方式注册的原生 Web 组件,不再需要使用 @WebServlet 、@WebListener 和 @WebListener 等注解。(可将@ServletComponentScan注解注释掉,就无法识别这三种注解了)

RegistrationBean 是个抽象类,负责将组件注册到 Servlet 容器中,Spring 提供了三个它的实现类,分别用来注册 Servlet、Filter 和 Listener。

  • ServletRegistrationBean:Servlet 的注册类

  • FilterRegistrationBean:Filter 的注册类

  • ServletListenerRegistrationBean:Listener 的注册类

我们可以在配置类中,使用 @Bean 注解将 ServletRegistrationBean、FilterRegistrationBean 和 ServletListenerRegistrationBean 添加 Spring 容器中,并通过它们将我们自定义的 Servlet、Filter 和 Listener 组件注册到容器中使用。

通过ServletRegistrationBean注册---servlet

@Configuration
public class ServletConfig {@Beanpublic ServletRegistrationBean servletServletRegistrationBean(){ServletRegistrationBean bean = new ServletRegistrationBean<>();bean.setServlet(new LoginServlet());bean.addUrlMappings("/loginServlet");return bean;}
}

通过FilterRegistrationBean注册---Filter

@Configuration
public class ServletConfig {@Beanpublic FilterRegistrationBean filterFilterRegistrationBean(){FilterRegistrationBean bean = new FilterRegistrationBean<>();bean.setFilter(new LoginFilter());bean.addUrlPatterns("/*");bean.setName("loginFilter");bean.setOrder(1);return bean;}
}

通过ServletListenerRegistrationBean注册---Listener

@Configuration
public class ServletConfig {@Beanpublic ServletListenerRegistrationBean servletListenerServletListenerRegistrationBean(){ServletListenerRegistrationBean bean = new ServletListenerRegistrationBean();bean.setListener(new ServletListener());return bean;}
}

🍈拦截器HandlerInterceptor

🍋Spring Boot拦截器

拦截器主要应用于登陆校验、权限验证、乱码解决、性能监控和异常处理等功能,Spring Boot 同样提供了拦截器功能。

🍍定义拦截器

在 Spring Boot 中定义拦截器十分的简单,只需要创建一个拦截器类,并实现 HandlerInterceptor 接口即可。

HandlerInterceptor 接口中定义以下 3 个方法,如下表。

返回值类型方法声明描述
booleanpreHandle(HttpServletRequest request, HttpServletResponse response, Object handler)该方法在控制器处理请求方法前执行,其返回值表示是否中断后续操作,返回 true 表示继续向下执行,返回 false 表示中断后续操作。
voidpostHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)该方法在控制器处理请求方法调用之后、解析视图之前执行,可以通过此方法对请求域中的模型和视图做进一步修改。
voidafterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)该方法在视图渲染结束后执行,可以通过此方法实现资源清理、记录日志信息等工作。

创建拦截器SexIntercepor

@Slf4j
public class SexInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {String requestURI = request.getRequestURI();log.info("请求的URI: "+requestURI);String sex = request.getParameter("sex");if(sex==null||!sex.equals("girl")){response.sendError(response.SC_UNAUTHORIZED,"你不是女生,出去!!!");}return true;}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {}
}

注册拦截器

创建一个实现了 WebMvcConfigurer 接口的配置类(使用了 @Configuration 注解的类),重写 addInterceptors() 方法,并在该方法中调用 registry.addInterceptor() 方法将自定义的拦截器注册到容器中。

@Configuration
public class MyWebMvcConfigurer implements WebMvcConfigurer {@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new SexInterceptor()).addPathPatterns("/api/**");}
}

指定拦截规则

@Configuration
public class MyWebMvcConfigurer implements WebMvcConfigurer {@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new SexInterceptor()).addPathPatterns("/api/**")//拦截所有请求,包括静态资源文件//放行登录页,登陆操作,静态资源.excludePathPatterns("/","/loginServlet","/css/**","/images/**","/js/**");}
}

在指定拦截器拦截规则时,调用了两个方法,这两个方法的说明如下:

  • addPathPatterns:该方法用于指定拦截路径,例如拦截路径为"/**",表示拦截所有请求,包括对静态资源的请求。

  • excludePathPatterns:该方法用于排除拦截路径,即指定不需要被拦截器拦截的请求。

创建接口测试拦截器

@RestController
@RequestMapping("/api")
public class LoginController {@GetMapping("/login")public String test(@RequestParam String token,@RequestParam String sex){return token+sex;}
}

相关内容

热门资讯

保存时出现了1个错误,导致这篇... 当保存文章时出现错误时,可以通过以下步骤解决问题:查看错误信息:查看错误提示信息可以帮助我们了解具体...
汇川伺服电机位置控制模式参数配... 1. 基本控制参数设置 1)设置位置控制模式   2)绝对值位置线性模...
不能访问光猫的的管理页面 光猫是现代家庭宽带网络的重要组成部分,它可以提供高速稳定的网络连接。但是,有时候我们会遇到不能访问光...
不一致的条件格式 要解决不一致的条件格式问题,可以按照以下步骤进行:确定条件格式的规则:首先,需要明确条件格式的规则是...
本地主机上的图像未显示 问题描述:在本地主机上显示图像时,图像未能正常显示。解决方法:以下是一些可能的解决方法,具体取决于问...
表格列调整大小出现问题 问题描述:表格列调整大小出现问题,无法正常调整列宽。解决方法:检查表格的布局方式是否正确。确保表格使...
表格中数据未显示 当表格中的数据未显示时,可能是由于以下几个原因导致的:HTML代码问题:检查表格的HTML代码是否正...
Android|无法访问或保存... 这个问题可能是由于权限设置不正确导致的。您需要在应用程序清单文件中添加以下代码来请求适当的权限:此外...
【NI Multisim 14...   目录 序言 一、工具栏 🍊1.“标准”工具栏 🍊 2.视图工具...
银河麒麟V10SP1高级服务器... 银河麒麟高级服务器操作系统简介: 银河麒麟高级服务器操作系统V10是针对企业级关键业务...