SpringMVC详解(全网最全)

打印 上一主题 下一主题

主题 942|帖子 942|积分 2836

起源

1. 三层架构:一个 Servlet 只能处理一个哀求,耦合度高,复用性差,整页刷新用户体验差


2. MVC 模式:部分解耦但后端仍负责 View层,高并发有限


3. 前后端分离:异步调用,复用性强,支持复杂交互,用户体验性强


概念


  • SpringMVC 是 Spring 框架中的一个模块,用于构建 Web 的 MVC 架构,提供了简洁、优雅的方式来开发 Web 程序,尤其是 HTTP 哀求和响应。
  • MVC:Model-View-Contorller,是一种软件设计模式,用于实现应用程序的分层和职责分离,达到解耦的目的。
1. Model(模子 )


  • 包含程序的业务逻辑和数据
  • 通常由 Service 层和 Dao 层支持。
  • 在 SpringMVC 中,Model 的数据可以通过 Model或 ModelAndView对象传递到 View 层。
2. View(视图)


  • 用户界面部分,负责展示页面和数据给用户。
  • SpringMVC 支持多种视图技能(之前的 JSP,Thymeleaf 等)
3. Controller(控制器)


  • 负责接受用户哀求,调用业务逻辑(Model),并将结果返回给 View。
  • SpringMVC 使用注解方式来定义控制器,如@Controller,@RestController等。
执行流程


组件

1. DispatchServlet


  • 职责:核心调度器,负责整个哀求处理流程的控制。
  • 功能:将哀求分发到具体的处理器。
2. HandlerMapping


  • 职责:根据 URL 映射到对应的 Handler
  • 功能:通过注解(@RequestMapping、@GetMapping等)或 XML 配置定义 URL 和 Handler 的映射关系。
3. HandlerAdapter


  • 职责:调用处理器的方法,完成哀求的核心业务处理。
  • 功能:提供机动性,支持多种范例的处理器(注解、接口等)
4. Handler(Controller)


  • 职责:接受哀求,执行具体的业务逻辑。
  • 功能:使用@Controller注解定义,Handler 方法负责调用业务逻辑层并返回结果。
5. ViewResolver


  • 职责:将逻辑视图解析为具体的 View。
  • 功能:支持 JSP、Thymeleaf 等多种视图技能。
6. View


  • 职责:负责将数据展示给用户。
  • 功能:渲染 Model 并返回给客户端。
包含的注解

SpringMVC 中常用的注解可以分为以下几类,分别对应不同的功能和场景:
1. 核心控制器注解

@Controller


  • 作用:标记一个类为控制器,用于处理 HTTP 哀求。
  • 示例
  1. @Controller
  2. public class MyController {
  3.     @RequestMapping("/hello")
  4.     public String hello() {
  5.         return "hello"; // 视图名
  6.     }
  7. }
复制代码
@RestController


  • 作用:组合注解,相当于 @Controller + @ResponseBody,用于返回 JSON 或 XML 数据,而不是视图。
  • 示例
  1. @RestController
  2. public class ApiController {
  3.     @GetMapping("/api/data")
  4.     public String getData() {
  5.         return "This is JSON response.";
  6.     }
  7. }
复制代码
2. 哀求映射干系注解

@RequestMapping


  • 作用:映射哀求路径,可以用于类或方法级别。
  • 示例
  1. @Controller
  2. @RequestMapping("/user")
  3. public class UserController {
  4.     @RequestMapping("/profile")
  5.     public String userProfile() {
  6.         return "profile";
  7.     }
  8. }
复制代码
@GetMapping / @PostMapping / @PutMapping / @DeleteMapping / @PatchMapping


  • 作用:对应 HTTP 哀求方法的快捷注解,等价于 @RequestMapping(method = RequestMethod.GET/POST/PUT/DELETE/PATCH)。
  • 示例
  1. @GetMapping("/getUser")
  2. public String getUser() {
  3.     return "getUser";
  4. }
复制代码
3. 哀求参数干系注解

在 SpringMVC 中,HTTP 哀求中的参数通常是简朴范例(如 String、int 等),使用其他范例时,最好加上 @RequestParam,日期格式使用@DateTimeFormat
@RequestParam


  • 作用:获取哀求参数(常见于查询参数)。
  • 示例
  1. @GetMapping("/search")
  2. public String search(@RequestParam("keyword") String keyword) {
  3.     return "Search for: " + keyword;
  4. }
复制代码
@PathVariable


  • 作用:获取路径中的动态参数。
  • 示例
  1. @GetMapping("/user/{id}")
  2. public String getUserById(@PathVariable("id") String id) {
  3.     return "User ID: " + id;
  4. }
复制代码
@RequestBody


  • 作用:解析哀求体中的 JSON 或 XML 数据,并将其绑定到对象。
  • 示例
  1. @PostMapping("/addUser")
  2. public String addUser(@RequestBody User user) {
  3.     return "User Name: " + user.getName();
  4. }
复制代码
@RequestHeader


  • 作用:获取 HTTP 哀求头的值。
  • 示例
  1. @GetMapping("/header")
  2. public String getHeader(@RequestHeader("Authorization") String auth) {
  3.     return "Auth: " + auth;
  4. }
复制代码
@CookieValue


  • 作用:获取 Cookie 值。
  • 示例
  1. @GetMapping("/cookie")
  2. public String getCookie(@CookieValue("sessionId") String sessionId) {
  3.     return "Session ID: " + sessionId;
  4. }
复制代码
4. 返回结果干系注解

@ResponseBody


  • 作用:将返回结果直接写入 HTTP 响应体(通常用于返回 JSON 或 XML 数据)。
  • 示例
  1. @ResponseBody
  2. @GetMapping("/json")
  3. public String jsonResponse() {
  4.     return "{"key":"value"}";
  5. }
复制代码
@ModelAttribute


  • 作用:将方法返回值或哀求参数绑定到模子中,在视图渲染时可用。
  • 示例
  1. @ModelAttribute
  2. public void addAttributes(Model model) {
  3.     model.addAttribute("message", "Hello World");
  4. }
复制代码
5. 数据验证干系注解

@Valid


  • 作用:对方法参数进行校验(需要配合 Java Bean Validation API)。
  • 示例
  1. @PostMapping("/save")
  2. public String saveUser(@Valid @RequestBody User user, BindingResult result) {
  3.     if (result.hasErrors()) {
  4.         return "Validation failed";
  5.     }
  6.     return "Success";
  7. }
复制代码
6. 其他注解

@SessionAttributes


  • 作用:将某些模子属性存储到会话中,便于后续访问。
  • 示例
  1. @SessionAttributes("user")
  2. @Controller
  3. public class SessionController {
  4.     @GetMapping("/setSession")
  5.     public String setSession(Model model) {
  6.         model.addAttribute("user", "John");
  7.         return "session";
  8.     }
  9. }
复制代码
@RequestPart


  • 作用:处理 multipart/form-data 哀求,常用于文件上传。
  • 示例
  1. @PostMapping("/upload")
  2. public String handleFileUpload(@RequestPart("file") MultipartFile file) {
  3.     return "Uploaded: " + file.getOriginalFilename();
  4. }
复制代码
总结

注解功能描述@Controller标记类为控制器,用于返回视图@RestController返回 JSON 或 XML 数据@RequestMapping映射哀求路径@RequestParam获取哀求参数@PathVariable获取路径参数@RequestBody获取哀求体数据@ResponseBody返回数据到响应体@ModelAttribute绑定模子数据@SessionAttributes生存会话属性@Valid数据校验@RequestHeader获取哀求头参数@CookieValue获取 Cookie 数据异常处理器

SpringMVC 中,异常处理器用于集中处理控制器方法中发生的异常,避免将异常直接暴露给用户,同时可以返回友好的提示信息或进行日志记录。以下是常见的异常处理方式:
1. 使用 @ExceptionHandler 注解

可以在控制器类中定义一个方法,通过 @ExceptionHandler 注解指定要捕获的异常范例。
示例:
  1. @Controller
  2. public class MyController {
  3.     @RequestMapping("/test")
  4.     public String test() {
  5.         throw new RuntimeException("测试异常");
  6.     }
  7.     @ExceptionHandler(RuntimeException.class)
  8.     @ResponseBody
  9.     public String handleRuntimeException(RuntimeException e) {
  10.         return "捕获到异常: " + e.getMessage();
  11.     }
  12. }
复制代码

  • 特点




    • 方法参数中可以获取异常对象。
    • 返回值支持视图名称或数据(配合 @ResponseBody 返回 JSON 数据)。

2. 使用 @ControllerAdvice

@ControllerAdvice 是一个全局异常处理器,实用于所有控制器。
示例:
  1. @ControllerAdvice
  2. public class GlobalExceptionHandler {
  3.     @ExceptionHandler(RuntimeException.class)
  4.     @ResponseBody
  5.     public String handleGlobalRuntimeException(RuntimeException e) {
  6.         return "全局异常处理器捕获: " + e.getMessage();
  7.     }
  8. }
复制代码

  • 特点




    • 集中管理异常处理逻辑。
    • 进步代码的可维护性。

3. 实现 HandlerExceptionResolver 接口

可以自定义异常处理器,通过实现 HandlerExceptionResolver 接口来捕获和处理异常。
示例:
  1. @Component
  2. public class MyExceptionResolver implements HandlerExceptionResolver {
  3.     @Override
  4.     public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
  5.         ModelAndView modelAndView = new ModelAndView();
  6.         modelAndView.addObject("error", ex.getMessage());
  7.         modelAndView.setViewName("error"); // 指向 error.jsp
  8.         return modelAndView;
  9.     }
  10. }
复制代码

  • 特点




    • 机动性高,可以处理不同范例的异常并返回不同的视图。
    • 适合需要自定义复杂逻辑的场景。

4. 使用 ResponseStatusExceptionResolver

通过在异常类上添加 @ResponseStatus 注解,指定 HTTP 状态码和原因。
示例:
  1. @ResponseStatus(value = HttpStatus.NOT_FOUND, reason = "资源未找到")
  2. public class ResourceNotFoundException extends RuntimeException {
  3. }
复制代码
在控制器中抛出该异常时,会返回对应的 HTTP 状态码和原因。
5. 基于 @RestControllerAdvice

@RestControllerAdvice 是 @ControllerAdvice 的变体,返回值默认是 JSON 格式(结合 @ResponseBody 的功能)。
示例:
  1. @RestControllerAdvice
  2. public class RestGlobalExceptionHandler {
  3.     @ExceptionHandler(RuntimeException.class)
  4.     public Map<String, Object> handleRuntimeException(RuntimeException e) {
  5.         Map<String, Object> response = new HashMap<>();
  6.         response.put("code", 500);
  7.         response.put("message", e.getMessage());
  8.         return response;
  9.     }
  10. }
复制代码

  • 特点




    • 专门用于 RESTful 风格的异常处理。
    • 返回 JSON 数据而非视图。

常见的异常范例处理


  • 404 Not Found




    • 可以通过 @ResponseStatus 或自定义异常处理器返回。


  • 参数校验异常(如 @Valid 或 @Validated):




    • 使用 MethodArgumentNotValidException 或 BindException 捕获。

  1. @ExceptionHandler(MethodArgumentNotValidException.class)
  2. public Map<String, Object> handleValidationException(MethodArgumentNotValidException e) {
  3.     Map<String, Object> errors = new HashMap<>();
  4.     e.getBindingResult().getFieldErrors().forEach(error ->
  5.         errors.put(error.getField(), error.getDefaultMessage())
  6.     );
  7.     return errors;
  8. }
复制代码
选择适合的方式


  • 简朴项目:使用 @ExceptionHandler。
  • 全局异常管理:使用 @ControllerAdvice 或 @RestControllerAdvice。
  • 复杂需求:实现 HandlerExceptionResolver 接口。
  • REST 风格接口:推荐使用 @RestControllerAdvice。
通过合理设计异常处理器,可以进步体系的健壮性和用户体验。
Rest 风格

Rest 风格简介

REST(Representational State Transfer,表述性状态转移)是一种基于资源的网络架构风格,由 Roy Fielding 在他的博士论文中提出。它是一种设计 API 的方法,使客户端和服务端之间的交互更加简朴、机动和高效。
Rest 风格的核心原则


  • 资源(Resource)




    • 一切皆资源,资源是 Web 体系中的核心概念。
    • 资源通常以 URL 表现。
    • 每个资源都有唯一的标识符(URI)。
      比方:
    • /users 表现用户资源集合。
    • /users/123 表现具体用户资源。


  • 无状态(Stateless)




    • 服务端不会存储客户端状态。
    • 每个哀求都包含所有须要的信息(如认证信息、上下文)。
    • 进步体系的可伸缩性,但需要客户端提供更多信息。


  • 统一接口(Uniform Interface)




    • 使用标准的 HTTP 方法和状态码。
    • REST 定义了操作资源的四种主要方法:







      • GET:读取资源。
      • POST:创建资源。
      • PUT:更新资源(通常是全量更新)。
      • DELETE:删除资源。



  • 表现层(Representation)




    • 资源的表现形式可以是 JSON、XML、HTML 等。
    • 不同的表现形式不会改变资源本身。
    • 通过 Content-Type 和 Accept 标头实现内容协商。


  • 客户端-服务器分离(Client-Server)




    • 客户端负责用户界面,服务端负责业务逻辑。
    • 松耦合的架构设计进步了可维护性和扩展性。


  • 可缓存性(Cacheable)




    • 服务端可以通过标头(如 Cache-Control)指示客户端是否可以缓存响应数据。
    • 减少网络传输,进步响应速率。

Rest 风格的 HTTP 哀求方法

HTTP 方法操作示例 URLGET获取资源/users 获取所有用户POST创建资源/users 创建新用户PUT更新资源(全量更新)/users/123 更新用户PATCH更新资源(部分更新)/users/123 更新部分信息DELETE删除资源/users/123 删除用户RESTful 状态码

状态码描述示例200乐成哀求乐成,返回资源数据201已创建乐成创建资源,通常用于 POST204无内容操作乐成,但不返回任何内容(如 DELETE)400客户端错误哀求参数有误401未授权缺少或无效的认证信息403禁止访问客户端无权访问资源404资源未找到哀求的资源不存在500服务器内部错误服务端处理哀求时发生错误示例:Rest 风格的 API

1. 获取所有用户(GET 哀求)
  1. GET /users HTTP/1.1
  2. Host: example.com
  3. Accept: application/json
复制代码
响应:
  1. [
  2.     {
  3.         "id": 1,
  4.         "name": "Alice",
  5.         "email": "alice@example.com"
  6.     },
  7.     {
  8.         "id": 2,
  9.         "name": "Bob",
  10.         "email": "bob@example.com"
  11.     }
  12. ]
复制代码
2. 创建新用户(POST 哀求)
  1. POST /users HTTP/1.1
  2. Host: example.com
  3. Content-Type: application/json
  4. {
  5.     "name": "Charlie",
  6.     "email": "charlie@example.com"
  7. }
复制代码
响应:
  1. HTTP/1.1 201 Created
  2. Location: /users/3
复制代码
3. 更新用户信息(PUT 哀求)
  1. PUT /users/3 HTTP/1.1
  2. Host: example.com
  3. Content-Type: application/json
  4. {
  5.     "name": "Charlie",
  6.     "email": "charlie.new@example.com"
  7. }
复制代码
响应:
  1. HTTP/1.1 200 OK
复制代码
4. 删除用户(DELETE 哀求)
  1. DELETE /users/3 HTTP/1.1
  2. Host: example.com
复制代码
响应:
  1. HTTP/1.1 204 No Content
复制代码
Rest 风格的优点


  • 简朴:基于 HTTP 标准协议,易于实现和理解。
  • 机动:支持多种数据格式(JSON、XML 等)。
  • 高扩展性:客户端和服务端解耦,便于扩展和维护。
  • 适合微服务:常用于构建微服务架构的 API。
Rest 风格的局限性


  • 无状态限定:需要客户端重复传递上下文信息,可能增加负担。
  • 复杂事务支持不足:分布式体系中,需要通过赔偿机制实现复杂事务。
  • 对实时性支持较弱:不实用于需要双向通信的场景(如 WebSocket 更适合)。
总结

Rest 风格是一种通用的、机动的 API 设计模式,广泛应用于 Web 服务和微服务架构。通过严酷遵守其原则,开发者可以构建出高效、易维护的体系。
拦截器

SpringMVC 中,拦截器(Interceptor)是一种动态拦截哀求并对其进行预处理和后处理的机制,雷同于 Servlet 的过滤器(Filter),但功能更强大且更风雅化。拦截器的核心是实现 HandlerInterceptor 接口或继续其实现类,并通过配置注册到应用程序中。
1. 拦截器的用途


  • 日志记录:记录哀求的处理时间或访问记录。
  • 权限校验:检查用户是否有权限访问某些资源。
  • 参数预处理:对哀求参数进行统一校验或修改。
  • 响应后处理:在响应数据返回之前进行修改或处理。
  • 全局异常处理:捕获和处理控制器未捕获的异常。
2. 拦截器的核心接口

HandlerInterceptor 接口定义了拦截器的三个核心方法,分别在不同的生命周期阶段调用。
接口方法:
  1. public interface HandlerInterceptor {
  2.     // 在处理请求之前调用
  3.     default boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  4.         return true;
  5.     }
  6.     // 在处理请求之后,渲染视图之前调用
  7.     default void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
  8.     }
  9.     // 在整个请求完成之后调用
  10.     default void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
  11.     }
  12. }
复制代码

  • preHandle:


    • 权限校验或认证:







      • 验证用户是否已登录或是否有权限访问某个资源。
      • 如果权限校验失败,可以直接返回 false,阻止哀求继续进入控制器。




    • 日志记录:







      • 记录哀求的基本信息,如 URL、参数、Headers 等。




    • 参数验证或处理:







      • 检查哀求中是否携带必需的参数。
      • 对某些参数进行预处理或转换。




    • 短路机制:







      • 如果 preHandle 返回 false,表现哀求被拦截,Spring MVC 不会继续调用后续拦截器、控制器方法和视图渲染逻辑。




  • postHandle:




    • 修改返回数据:







      • 可以通过操作 ModelAndView 对返回的数据或视图名称进行修改。
      • 比方,在 ModelAndView 中添加全局变量(如用户信息、体系时间等)。






    • 日志记录:







      • 记录控制器方法的执行结果。
      • 分析控制器方法的处理时间。






    • 动态调整视图:







      • 根据业务需求动态修改视图名称或数据(比方国际化处理)。






    • 扩展功能:







      • 在控制器返回数据后,进行某些业务逻辑处理(如数据格式化、敏感信息脱敏等)。




  • afterCompletion:




    • 资源整理:







      • 释放在 preHandle 或 postHandle 中分配的资源(如数据库连接、线程资源等)。
      • 清除 ThreadLocal 中绑定的变量,防止内存走漏。






    • 日志记录:







      • 记录整个哀求的执行情况,包括耗时、返回结果、是否发生异常等信息。
      • 如果 Exception ex 不为 null,可以记录错误日志或报警。






    • 性能监控:







      • 在 preHandle 中记录哀求开始时间,在 afterCompletion 中记录哀求结束时间,计算整个哀求的耗时。






    • 异常处理或赔偿:







      • 检查异常 ex 是否存在,根据异常范例执行赔偿逻辑。
      • 比方,在某些情况下发送告警关照或回滚某些已完成的操作。
      • 全局整理:
      • 无论哀求是否乐成处理,都确保执行某些全局整理操作,如关闭流、删除临时文件等。


3. 拦截器的实现

实现 HandlerInterceptor 接口或继续其默认实现类 HandlerInterceptorAdapter。
示例:简朴的日志拦截器
  1. @Component
  2. public class LoggingInterceptor implements HandlerInterceptor {
  3.     @Override
  4.     public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  5.         System.out.println("preHandle: 请求路径是 " + request.getRequestURI());
  6.         return true; // 返回 true 表示继续执行
  7.     }
  8.     @Override
  9.     public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
  10.         System.out.println("postHandle: 处理完成,但视图还未渲染");
  11.     }
  12.     @Override
  13.     public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
  14.         System.out.println("afterCompletion: 请求已完成,视图已渲染");
  15.     }
  16. }
复制代码
4. 拦截器的注册

拦截器需要注册到 SpringMVC 的拦截器链中,通过实现 WebMvcConfigurer 来完成。
注册示例:
  1. @Configuration
  2. public class WebConfig implements WebMvcConfigurer {
  3.     @Override
  4.     public void addInterceptors(InterceptorRegistry registry) {
  5.         registry.addInterceptor(new LoggingInterceptor())
  6.                 .addPathPatterns("/**") // 拦截所有路径
  7.                 .excludePathPatterns("/login", "/error"); // 排除路径
  8.     }
  9. }
复制代码

  • addPathPatterns:指定拦截的路径模式。
  • excludePathPatterns:指定不拦截的路径模式。
5. 多拦截器的执行顺序

多个拦截器按注册顺序执行:

  • preHandle:按注册顺序执行。
  • postHandle 和 afterCompletion:按注册顺序的逆序执行。
示例 1:


示例 2:
  1. @Override
  2. public void addInterceptors(InterceptorRegistry registry) {
  3.     registry.addInterceptor(new FirstInterceptor());
  4.     registry.addInterceptor(new SecondInterceptor());
  5. }
复制代码
执行顺序:

  • FirstInterceptor.preHandle
  • SecondInterceptor.preHandle
  • 控制器方法执行
  • SecondInterceptor.postHandle
  • FirstInterceptor.postHandle
  • SecondInterceptor.afterCompletion
  • FirstInterceptor.afterCompletion
小结:

  • 只要拦截器 X preHandle 返回 true ,Spring MVC 会确保在哀求生命周期结束时调用拦截器 X afterCompletion() ,无论后续的处理是正常结束还是发生异常。
  • preHandler执行顺序雷同队列,postHandler与 afterCompletion雷同栈。
6. 与过滤器的区别

特性拦截器(Interceptor)过滤器(Filter)工作层级SpringMVC 层Servlet 容器层拦截对象控制器(Handler)所有哀求(静态资源也可拦截)功能扩展可以访问 Spring 上下文,支持依赖注入无法直接访问 Spring 上下文配置方式Spring 配置类web.xml或 @WebFilter注解7. 常见场景


  • 登录校验拦截器
  1. @Component
  2. public class AuthInterceptor implements HandlerInterceptor {
  3.     @Override
  4.     public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
  5.         HttpSession session = request.getSession();
  6.         if (session.getAttribute("user") == null) {
  7.             response.sendRedirect("/login");
  8.             return false; // 阻止后续处理
  9.         }
  10.         return true;
  11.     }
  12. }
复制代码

  • 跨域拦截器: 动态设置跨域响应头。
  • 日志拦截器: 记录哀求和响应的具体信息。
通过合理设计和注册拦截器,可以明显提升应用的扩展性和机动性。

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

x
回复

使用道具 举报

0 个回复

倒序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

宁睿

金牌会员
这个人很懒什么都没写!

标签云

快速回复 返回顶部 返回列表