当前位置： 首页 > news >正文

SpringMVC Day 11 : 零 xml 配置

news 来源：原创 2024/5/20 11:39:44

前言

欢迎来到《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类中还有两个成员变量userName和password，它们都使用了@NotEmpty注解。@NotEmpty注解是Hibernate Validator库中的一个注解，用于验证字符串不能为空。在这个例子中，如果userName或password为空，将会抛出一个包含特定错误消息的异常。

总体而言，这段代码定义了一个简单的用户类，在进行数据校验时，要求用户名和密码均不能为空。通过使用@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对象中的userName或password为空，将会抛出包含特定错误消息的异常。如果数据校验成功，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. 注释掉了@Autowired和private 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)

相关文章：

  • Docker Tomcat 搭建文件服务器
  • 历年网规上午真题笔记（2016年）
  • 为什么汽车行业普遍选择使用CATIA？
  • lua-web-utils库
  • Java算法：二分查找
  • MPLAB X IDE 仿真打断点提示已中断的断点？
  • 十年JAVA搬砖路——Linux搭建Ldap服务器。
  • GaussDB SQL基础语法示例-数组表达式
  • 【Jenkins】新建任务FAQ
  • 软考高项-49个项目管理过程输入、输出和工具技术表
  • 使用treq库下载Python程序
  • 批量采集各类自媒体平台内容为word文档带图片软件【支持18家自媒体平台的爬取采集】
  • 用pd.DataFrame.to_sql方法插入万行数据耗时21秒
  • 【经典面试】87 字符串解码
  • yum 命令
  • 《Java8实战》-第四章读书笔记（引入流Stream）
  • 2017-08-04 前端日报
  • ES学习笔记(10)--ES6中的函数和数组补漏
  • Git初体验
  • JAVA SE 6 GC调优笔记
  • js算法-归并排序（merge_sort）
  • Nacos系列：Nacos的Java SDK使用
  • nodejs实现webservice问题总结
  • Octave 入门
  • 极限编程 (Extreme Programming) - 发布计划 (Release Planning)
  • 蓝海存储开关机注意事项总结
  • 浏览器缓存机制分析
  • 前端技术周刊 2018-12-10：前端自动化测试
  • 前端学习笔记之原型——一张图说明`prototype`和`__proto__`的区别
  • 扫描识别控件Dynamic Web TWAIN v12.2发布，改进SSL证书
  • 微信端页面使用-webkit-box和绝对定位时，元素上移的问题
  • 一些关于Rust在2019年的思考
  • - 转 Ext2.0 form使用实例
  • LIGO、Virgo第三轮探测告捷，同时探测到一对黑洞合并产生的引力波事件 ...
  • ​一帧图像的Android之旅 :应用的首个绘制请求
  • #define MODIFY_REG(REG, CLEARMASK, SETMASK)
  • #ubuntu# #git# repository git config --global --add safe.directory
  • （C语言）逆序输出字符串
  • （Matalb时序预测）PSO-BP粒子群算法优化BP神经网络的多维时序回归预测
  • (NSDate) 时间 (time )比较
  • （Oracle）SQL优化技巧（一）：分页查询
  • （Redis使用系列） SpringBoot 中对应2.0.x版本的Redis配置 一
  • （待修改）PyG安装步骤
  • （机器学习的矩阵）（向量、矩阵与多元线性回归）
  • （五）Python 垃圾回收机制
  • (转)socket Aio demo
  • (转)视频码率,帧率和分辨率的联系与区别
  • .java 9 找不到符号_java找不到符号
  • .NET Compact Framework 多线程环境下的UI异步刷新
  • .NET I/O 学习笔记：对文件和目录进行解压缩操作
  • .NET 回调、接口回调、 委托
  • .NET(C#) Internals: as a developer, .net framework in my eyes
  • .NETCORE 开发登录接口MFA谷歌多因子身份验证
  • .NET多线程执行函数
  • .net知识和学习方法系列（二十一）CLR-枚举