SpringMVC Day 11 : 零 xml 配置

前言

欢迎来到《Spring MVC Day 11: 零XML配置》!在之前的学习中,我们已经掌握了如何使用Spring MVC框架构建灵活、高效的Web应用程序。然而,我们可能还记得那些繁琐的XML配置文件,它们是我们在过去几天中使用的方式。

好消息是,今天我们将告别这种繁琐的XML配置文件!在本文中,我们将介绍如何在Spring MVC中实现零XML配置,通过使用全注解和Java配置类来代替传统的XML配置文件。这将使我们的代码更加简洁、可读性更强,并且更加符合现代化的开发模式。

我们将逐步学习如何使用注解来替代XML配置文件的各个方面,包括控制器、请求映射、视图解析器等。通过这种新的方式,你会发现编写和维护Spring MVC应用程序将变得更加轻松和高效。

一、前期准备

1、新建项目,结构如下

2、导入依赖
    <dependencies><!-- springmvc 依赖,会将spring的核心包一并添加进来 --><!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc --><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>5.3.23</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>1.18.30</version></dependency><dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId><version>1.4.5</version></dependency><!-- 集成 hibernata bean 验证器 --><dependency><groupId>org.hibernate.validator</groupId><artifactId>hibernate-validator</artifactId><version>6.0.13.Final</version></dependency><!-- 上传组件 --><dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.3.1</version></dependency></dependencies>
3、在 resources 包下新建一个 message.properties 
user.username = 请输入用户名
user.password = 请输入密码

 用于表单验证,非空判断的信息。

4、新建一个 User 类
@Data
public class User {@NotEmpty(message = "{user.userName}")private String userName;@NotEmpty(message = "{user.password}")private String password;}

该类使用了@Data注解,这个注解是Lombok库中的一个注解,它自动为类生成了一些通用的方法,如equals()hashCode()toString()等。

此外,User类中还有两个成员变量userNamepassword,它们都使用了@NotEmpty注解。@NotEmpty注解是Hibernate Validator库中的一个注解,用于验证字符串不能为空。在这个例子中,如果userNamepassword为空,将会抛出一个包含特定错误消息的异常。

总体而言,这段代码定义了一个简单的用户类,在进行数据校验时,要求用户名和密码均不能为空。通过使用@Data@NotEmpty注解,我们可以简化代码,并且在需要验证用户输入时提供了方便的方式。

5、编写一个登录拦截器 LoginInterceptor

@Slf4j
public class LoginInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {log.info("执行拦截器的 preHandle 方法");return true;}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {log.info("执行拦截器的 postHandle 方法");}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {log.info("执行拦截器的 afterCompletion 方法");}}

在拦截器的postHandle方法中,通过重写postHandle方法,你可以在请求处理之后、渲染视图之前执行一些操作。在这个例子中,拦截器又打印了一条日志信息,表示正在执行postHandle方法。

在拦截器的afterCompletion方法中,通过重写afterCompletion方法,你可以在请求完成之后执行一些操作。在这个例子中,拦截器同样打印了一条日志信息,表示正在执行afterCompletion方法。

需要注意的是,拦截器需要注册到Spring MVC的配置中才能生效。你可以通过配置WebMvcConfigurer或者使用@Configuration注解的配置类来注册拦截器。

在实际应用中,你可以根据具体需求在拦截器的各个方法中编写自己的业务逻辑,例如登录验证、权限控制等。拦截器是一种强大的工具,可以用于在请求处理过程中进行预处理和后处理操作。

6、编写一个 Controler 
@RestController
public class UserController {@PostMapping("/add")public Integer add(@Valid User user){return HttpStatus.OK.value();}}

 在方法上,使用了@PostMapping("/add")注解来指定对应的请求路径和请求类型。同时,你还使用了@Valid注解,表示需要对User对象进行数据校验。

如果User对象中的userNamepassword为空,将会抛出包含特定错误消息的异常。如果数据校验成功,add方法将返回HTTP状态码200,表示请求处理成功。

 二、创建 MvcConfig、WebConfig 配置类

1、MvcConfig 配置类
1)静态资源处理,方式一
// 声明为配置类
@Configuration
// 启用包扫描
@ComponentScan(basePackages = "edu.nf.ch11")
// 启用 mvc 注解驱动(等效于<mvc:annotation-driven/>)
@EnableWebMvc
// 实现 WebMvcConfigurer 接口用于覆盖默认的配置
public class MvcConfig implements WebMvcConfigurer {/***  配置类支持依赖注入,配置类也是容器管理的*/
//    @Autowired
//    private LoginInterceptor loginInterceptor;/*** 静态资源处理方式一:使用容器默认的 servlet 来处理* 注意:重写 WebMvcConfig 接口方法时不需要使用 @Bean*      注解来装配*/@Overridepublic void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {// enable() 方法表示启用容器默认 servlet 处理静态资源configurer.enable();}
}

这段代码是Spring MVC的配置类,具体功能和作用如下:

  1. @Configuration注解表示这是一个配置类,会被Spring容器扫描并进行管理。

  2. @ComponentScan注解启用包扫描,指定要扫描的基础包路径为"edu.nf.ch11"。这个注解让Spring自动扫描并注入带有特定注解的组件,使得它们能够被容器管理。

  3. @EnableWebMvc注解启用MVC注解驱动,相当于XML配置文件中的<mvc:annotation-driven/>标签。这个注解会自动注册一些默认的组件,例如处理器映射、参数解析器和视图解析器等,以支持使用注解来简化开发。

  4. 实现WebMvcConfigurer接口用于覆盖默认的配置。通过实现这个接口,可以对Spring MVC的配置进行个性化定制。

  5. configureDefaultServletHandling方法重写了WebMvcConfigurer接口的方法,通过调用configurer.enable()启用容器默认的servlet来处理静态资源。这样,不需要再额外配置静态资源的处理,容器会自动处理静态资源的访问请求。

  6. 注释掉了@Autowiredprivate LoginInterceptor loginInterceptor部分代码。这部分代码可能是用于注入并配置一个登录拦截器,但在这个配置类中被注释掉了,可能是因为其他原因。

总之,这段代码是Spring MVC的配置类,用于配置和定制Spring MVC的行为和功能,包括启用包扫描、启用MVC注解驱动以及处理静态资源等。可以根据具体需求进行个性化配置和定制。

 2)静态资源处理,方式二
    /*** 静态资源处理方式二:由 springmvc 处理静态资源* 页面上以 page 开头的页面都放到 static 管理* @param registry*/@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {registry.addResourceHandler("/page/**").addResourceLocations("/static/");}

具体功能和作用如下:

  1. 创建一个ResourceHandlerRegistry对象实例,该类是Spring MVC提供的静态资源处理注册器,用于注册和配置静态资源的处理方式。

  2. 使用.addResourceHandler("/page/**")设置映射的URL路径模式,即当请求路径符合/page/**的格式时,将会被映射到静态资源处理器进行处理。

  3. 使用.addResourceLocations("/static/")设置静态资源的存放位置,即指定静态资源文件所在的目录。在这个例子中,将会把以/page/开头的请求映射到/static/目录下的对应静态资源文件。

通过这种方式,可以方便地处理和管理静态资源,使得在页面上以/page/开头的请求能够正常访问对应的静态资源文件。

 

3)装配 Bean 验证器
 /*** 装配 Bean 验证器*/@Overridepublic Validator getValidator() {LocalValidatorFactoryBean factoryBean = new LocalValidatorFactoryBean();// 使用 Hibernate 框架提供的 Bean 验证器factoryBean.setProviderClass(HibernateValidator.class);// 指定资源文件ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource();messageSource.setBasename("classpath:message");messageSource.setDefaultEncoding("UTF-8");// 装配给 factoryBeanfactoryBean.setValidationMessageSource(messageSource);return factoryBean;}

 具体功能和作用如下:

  1. 创建一个LocalValidatorFactoryBean实例,该类是Spring提供的验证器工厂类,用于创建验证器对象。

  2. 使用factoryBean.setProviderClass(HibernateValidator.class)设置验证器的提供者为Hibernate Validator。Hibernate Validator是一个基于Hibernate框架的验证器实现,提供了丰富的验证规则和错误消息。

  3. 创建一个ReloadableResourceBundleMessageSource实例,用于指定验证器的错误消息资源文件。setBasename("classpath:message")指定了资源文件的路径为"classpath:message",即在classpath下的message.properties文件中查找错误消息。

  4. 使用setDefaultEncoding("UTF-8")设置资源文件的编码格式为UTF-8,确保正确读取错误消息中的中文字符。

  5. 将上述创建的messageSource对象通过factoryBean.setValidationMessageSource(messageSource)方法装配给factoryBean,将资源文件配置到验证器中。

  6. 最后返回factoryBean,即返回了一个已经配置好的Hibernate Validator作为Bean验证器。

通过这种方式,可以使用Hibernate Validator作为验证器,并配置自定义的错误消息资源文件,从而实现对请求参数进行校验,并返回相应的错误信息。

4) 装配 commons-upload 上传解析器
  /*** 装配 commons-upload 上传解析器*/@Beanpublic CommonsMultipartResolver multipartResolver(){CommonsMultipartResolver resolver = new CommonsMultipartResolver();// 设置文件上传的大小resolver.setMaxUploadSize(104857600);// 设置编码resolver.setDefaultEncoding("UTF-8");return resolver;}

具体功能和作用如下:

  1. 创建一个CommonsMultipartResolver对象实例,该类是Spring提供的文件上传解析器,用于解析客户端传来的Multipart请求,即包含文件流的请求。

  2. 使用setMaxUploadSize(104857600)设置最大上传文件的大小,单位为字节。在这个例子中,最大允许上传100MB的文件。

  3. 使用setDefaultEncoding("UTF-8")设置编码格式为UTF-8,确保正确解析文件名和文件内容中的中文字符。

  4. 将创建好的resolver对象返回,作为配置好的上传解析器Bean。

通过这种方式,可以方便地配置和管理文件上传解析器,以便处理文件上传相关的请求。

5)装配拦截器
/*** 装配拦截器*/@Overridepublic void addInterceptors(InterceptorRegistry registry) {registry.addInterceptor(new LoginInterceptor()).addPathPatterns("/**").excludePathPatterns("/static/login.html","/static/js/**","/static/css/**","/login");}

 具体功能和作用如下:

  1. 创建一个InterceptorRegistry对象实例,该类是Spring提供的拦截器注册器,用于注册拦截器。

  2. 使用registry.addInterceptor(new LoginInterceptor())将自定义的LoginInterceptor拦截器添加到拦截器注册器中。

  3. 使用.addPathPatterns("/**")设置需要拦截的请求路径,即所有请求都需要被该拦截器拦截。

  4. 使用.excludePathPatterns()设置不需要拦截的请求路径,即在该拦截器之外的请求,这里排除了静态资源文件和登录页面等请求。

  5. 最后的效果是,当有请求时,会先进入LoginInterceptor拦截器,进行判断是否已经登录。如果未登录,则将请求转发到登录页面进行登录;如果已经登录,则放行请求继续处理。

通过这种方式,可以方便地配置和管理拦截器,以便对请求进行统一处理和验证。

6)跨域配置
/*** 跨域配置*/@Overridepublic void addCorsMappings(CorsRegistry registry) {registry.addMapping("/**").allowedOrigins("*").allowedMethods("*").allowedHeaders("*").exposedHeaders("*");// 跨域时时候允许传递 cookie,默认是不允许的//.allowCredentials(true);}

具体功能和作用如下:

  1. 创建一个CorsRegistry对象实例,该类是Spring提供的跨域配置注册器,用于注册跨域请求的配置。

  2. 使用.addMapping("/**")设置需要进行跨域配置的请求路径模式,这里使用通配符/**表示所有请求都需要跨域配置。

  3. 使用.allowedOrigins("*")设置允许的来源,即允许跨域请求的来源域名。在这个例子中,使用通配符*表示允许任何域名发起跨域请求。

  4. 使用.allowedMethods("*")设置允许的HTTP方法,即允许跨域请求的HTTP方法。在这个例子中,使用通配符*表示允许任何HTTP方法。

  5. 使用.allowedHeaders("*")设置允许的请求头,即允许跨域请求携带的请求头。在这个例子中,使用通配符*表示允许任何请求头。

  6. 使用.exposedHeaders("*")设置允许暴露的响应头,即允许跨域请求返回的响应头信息。在这个例子中,使用通配符*表示允许任何响应头。

  7. 可选的,使用.allowCredentials(true)设置是否允许跨域请求携带cookie。默认情况下,浏览器在跨域请求中是不会发送cookie的,需要显示地设置为true才能够携带cookie。

通过这种方式,可以方便地配置和管理跨域请求的相关参数,以便应对跨域请求场景。

 7)配置内部资源解析器
 /*** 配置内部资源视图解析器*/@Beanpublic InternalResourceViewResolver viewResolver(){InternalResourceViewResolver viewResolver = new InternalResourceViewResolver();viewResolver.setPrefix("/WEN-INF/jsp/");viewResolver.setSuffix(".jsp");return viewResolver;}

具体功能和作用如下:

  1. 使用@Bean注解将该方法声明为一个Spring Bean。

  2. 创建一个InternalResourceViewResolver对象实例,该类是Spring MVC提供的视图解析器,用于解析JSP视图。

  3. 使用.setPrefix("/WEN-INF/jsp/")设置JSP文件所在的目录路径,即指定模板文件的存放位置。在这个例子中,将会在/WEB-INF/jsp/目录下查找JSP文件。

  4. 使用.setSuffix(".jsp")设置JSP文件的后缀名,即指定JSP文件的文件类型。在这个例子中,将会查找后缀名为.jsp的文件。

  5. 返回InternalResourceViewResolver对象实例。

通过这种方式,可以方便地进行JSP视图解析,使得在控制器中返回的逻辑视图名能够正确解析对应的JSP视图文件。

2、配置 WebConfig
/*** @Date 2023-10-30* @Author qiu* webConfig 配置类,用于取代 web.xml* 在继承的父类中已经帮我们创建了 dispatcherServlet 并初始化* 只需要在重写的 getServletMappings 方法中指定映射的地址即可* 相当于 web.xml  中的 <url-pattern>/</url-pattern>*/
public class WebConfig extends AbstractAnnotationConfigDispatcherServletInitializer {/*** 加载主配置类* @return*/@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class[0];}/*** 加载 MVC 的配置类* @return*/@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class[]{MvcConfig.class};}/*** 给 dispatcherServlet 配置 url-pattern* @return*/@Overrideprotected String[] getServletMappings() {return new String[]{"/"};}}

 具体作用和功能如下:

  1. 继承自AbstractAnnotationConfigDispatcherServletInitializer,这是Spring提供的一个抽象类,用于帮助我们进行基于注解的Spring MVC配置。

  2. 重写getRootConfigClasses()方法,用于加载主配置类。在这个例子中,返回一个空数组,表示没有额外的根配置类需要加载。

  3. 重写getServletConfigClasses()方法,用于加载MVC的配置类。在这个例子中,返回一个包含MvcConfig类的数组,表示加载MvcConfig类作为MVC的配置类。

  4. 重写getServletMappings()方法,用于给dispatcherServlet配置URL映射。在这个例子中,返回一个包含"/"的字符串数组,表示将所有请求都映射到dispatcherServlet上。

通过这种方式,可以在Java代码中灵活配置Spring MVC,取代传统的使用web.xml进行配置的方式。这样可以更方便地管理和维护项目的配置,并且提高了代码的可读性和可维护性。

三、使用配置类配置 springMvc 有什么好处 

使用配置类来配置Spring MVC有以下好处:

  1. 基于JavaConfig,无需XML:使用配置类可以完全基于Java代码来完成Spring MVC的配置,不再需要使用XML文件来进行配置。

  2. 可以使用更加面向对象的方式:通过配置类,可以使用更加面向对象的方式来进行配置,而不是XML中的标签式配置,这样更加符合Java开发者的习惯和编码风格。

  3. 代码结构清晰:使用配置类可以将不同功能的配置分离到不同的类中,使得代码结构更加清晰,易于维护和扩展。

  4. 更加灵活:使用配置类可以方便地实现条件化配置、根据环境变量或系统属性动态调整配置等功能,从而让配置更加灵活。

  5. 与其他Spring特性集成:使用配置类可以方便地与其他Spring特性如Spring Boot、Actuator、Security等集成,从而让整个应用程序更加协调和一致。

总之,使用配置类配置Spring MVC可以提高代码的可读性、可维护性和可扩展性,并且可以更好地与其他Spring特性集成,是目前推荐的一种配置方式。

四、gitee 案例

地址:ch11 · qiuqiu/SpringMVC - 码云 - 开源中国 (gitee.com)

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/157374.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

企业服务总线ESB有什么作用?和微服务有什么区别?会如何发展?

企业服务总线ESB是什么 下面这张图&#xff0c;稍微了解些IT集成的朋友应该不陌生。 随着信息化发展不断深入&#xff0c;企业在不同的阶段引入了不同的应用、系统和软件。这些原始的应用系统互不连通&#xff0c;如同一根根独立的烟囱。 但是企业业务是流程化的&#xff0c;…

分享一下商城小程序怎么做

随着移动互联网的普及&#xff0c;越来越多的用户开始使用商城小程序进行购物。商城小程序不仅方便快捷&#xff0c;还能享受更多的优惠和福利。本文将探讨如何打造一个成功的商城小程序&#xff0c;并分享一些实用的策略和案例。 了解用户需求是打造商城小程序的第一步。我们需…

python实现MC协议(SLMP 3E帧)的TCP服务端(篇二)

python实现MC协议&#xff08;SLMP 3E帧&#xff09;的TCP服务端是一件稍微麻烦点的事情。它不像modbusTCP那样&#xff0c;可以使用现成的pymodbus模块去实现。但是&#xff0c;我们可以根据协议帧进行组包&#xff0c;自己去实现帧的格式&#xff0c;而这一切可以基于socket模…

Spring学习笔记

文章目录 Spring框架Spring入门Spring第一个程序启用Log4j2日志框架 Spring对IoC的实现set注入构造注入set注入专题p命名空间注入c命名空间注入util命名空间基于XML的自动装配spring引入外部属性配置文件 Bean的作用域GoF之工厂模式工厂模式的三种形态 Bean的获取方式Bean的生命…

Java Soce

1.Server and client server 我们经常需要关闭一些实例&#xff0c;比如server&#xff0c;所以我们使用这个接口&#xff0c;来实现自动关闭。 我们可以这样写&#xff0c;手动关闭server public class Server {public static void main(String args[]){try {ServerSocket…

HTTP和HTTPS本质区别——SSL证书

HTTP和HTTPS是两种广泛使用的协议&#xff0c;尽管它们看起来很相似&#xff0c;但是它们在网站数据传输的安全性上有着本质上的区别。 HTTP是明文传输协议&#xff0c;意味着通过HTTP发送的数据是未经加密的&#xff0c;容易受到拦截、窃听和篡改的风险。而HTTPS通过使用SSL或…

笔记本电脑怎么录屏?超简单的步骤教你轻松搞定

随着信息技术的发展&#xff0c;笔记本电脑已经成为了人们日常工作和学习的重要组成部分。而录屏功能作为笔记本电脑的一项重要功能&#xff0c;可以帮助我们录制电脑上的画面和声音&#xff0c;以便演示、教学或保存重要信息。可是笔记本电脑怎么录屏呢&#xff1f;接下来&…

Java SE 学习笔记(十七)—— 单元测试、反射

目录 1 单元测试1.1 单元测试概述1.2 单元测试快速入门1.3 JUnit 常用注解 2 反射2.1 反射概述2.2 获取类对象2.3 获取构造器对象2.4 获取成员变量对象2.5 获取常用方法对象2.6 反射的作用2.6.1 绕过编译阶段为集合添加数据2.6.2 通用框架的底层原理 1 单元测试 1.1 单元测试概…

【Tomcat Servlet】如何在idea上部署一个maven项目?

目录 1.创建项目 2.引入依赖 3.创建目录 4.编写代码 5.打包程序 6.部署项目 7.验证程序 什么是Tomcat和Servlet? 以idea2019为例&#xff1a; 1.创建项目 1.1 首先创建maven项目 1.2 项目名称 2.引入依赖 2.1 网址输入mvnrepository.com进入maven中央仓库->地址…

基于深度学习的人脸性别年龄识别 - 图像识别 opencv 计算机竞赛

文章目录 0 前言1 课题描述2 实现效果3 算法实现原理3.1 数据集3.2 深度学习识别算法3.3 特征提取主干网络3.4 总体实现流程 4 具体实现4.1 预训练数据格式4.2 部分实现代码 5 最后 0 前言 &#x1f525; 优质竞赛项目系列&#xff0c;今天要分享的是 &#x1f6a9; 毕业设计…

Vue2实现别踩白块(第一种)

实际效果:可选模式 开始按钮 游戏界面 游戏失败(不点击任何黑块) 游戏中(点击黑块变灰色) 功能简介: 1、点击无尽模式,就是常规速度,定时器20毫秒,然后无限计分 2、急速模式,比常规快一倍,定时器8毫秒 3、计时模式,限时60秒,定时器20毫秒,计分 以上所有模式,点击…

Java使用pdfbox进行pdf和图片之间的转换

简介 pdfbox是Apache开源的一个项目,支持pdf文档操作功能。 官网地址: Apache PDFBox | A Java PDF Library 支持的功能如下图.引入依赖 <dependency><groupId>org.apache.pdfbox</groupId><artifactId>pdfbox-app</artifactId><version>…