【Spring 篇】走进SpringMVC的世界：舞动Web的激情

在这里插入图片描述

嗨，亲爱的小白们！欢迎来到这篇关于SpringMVC的博客，让我们一起探索这个舞动Web的框架，感受它带来的激情和便利。在这个世界里，我们将学到SpringMVC的概述、开发步骤以及如何快速入门，一切都是如此的令人兴奋。

踏上舞台：SpringMVC概述

在我们深入了解SpringMVC之前，让我们先简单了解一下它是什么。SpringMVC是Spring框架的一个模块，用于构建Web应用程序。它采用了经典的MVC（Model-View-Controller）设计模式，将应用程序划分为三个主要的组件：

Model（模型）：负责处理数据逻辑，与数据库交互，提供数据给View展示。
View（视图）：负责用户界面的展示，将Model提供的数据呈现给用户。
Controller（控制器）：负责处理用户请求，调用Model获取数据，并将数据传递给View展示。

SpringMVC通过这种分层的方式，使得我们能够更清晰地组织和管理代码，提高了应用程序的可维护性。

舞动的步伐：SpringMVC开发步骤

1. 项目初始化

首先，我们需要创建一个新的SpringMVC项目。可以使用Spring Initializr（https://start.spring.io/）来初始化一个基本的Spring Boot项目。选择你需要的配置，点击"Generate"下载项目压缩包，解压后导入到你喜欢的集成开发环境中。

2. 添加SpringMVC依赖

在pom.xml文件中，添加SpringMVC的依赖：

<dependencies>
    <!-- ...其他依赖 ... -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

这个依赖包含了构建基本的SpringMVC应用所需的一切。

3. 创建一个简单的Controller

在src/main/java/com/example/demo目录下，创建一个名为DemoController.java的类，用于处理Web请求：

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class DemoController {

    @GetMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("message", "Hello, SpringMVC!");
        return "hello";
    }
}

这个简单的Controller定义了一个/hello的GET请求，返回一条简单的问候语。

4. 创建一个显示结果的View

在src/main/resources/templates目录下，创建一个名为hello.html的HTML文件，用于展示Controller返回的数据：

<!DOCTYPE html>
<html>
<body>

<h2 th:text="${message}"></h2>

</body>
</html>

5. 启动应用

在项目的根目录下执行以下命令启动应用：

./mvnw spring-boot:run

或者在集成开发环境中直接运行DemoApplication.java中的main方法。

打开浏览器访问：http://localhost:8080/hello，你将看到页面上显示着"Hello, SpringMVC!"。

至此，我们已经成功完成了一个简单的SpringMVC应用的开发。接下来，让我们更深入地了解一下SpringMVC的一些核心概念。

感受激情：快速入门SpringMVC

1. 请求映射

在SpringMVC中，我们通过@RequestMapping注解来定义Controller处理的请求映射。例如，我们想要处理一个路径为/greet的GET请求，可以这样写：

@GetMapping("/greet")
public String greet() {
    return "greet";
}

这里，我们使用了@GetMapping注解，表示处理GET请求。返回值为字符串"greet"，它将会被解析为视图名称，系统将会找到名为greet.html的模板文件。

2. 请求参数

在处理请求时，我们常常需要从URL中获取参数。SpringMVC提供了多种方式来接收请求参数，最简单的方式是直接将参数添加到方法的参数中：

@GetMapping("/greet")
public String greet(@RequestParam String name, Model model) {
    model.addAttribute("message", "Hello, " + name + "!");
    return "greet";
}

在这个例子中，我们通过@RequestParam注解将name参数绑定到方法的参数中。当我们访问/greet?name=John时，name参数将被设置为"John"。

3. 路径变量

有时候，我们希望从URL路径中提取参数。这时，我们可以使用路径变量（Path Variable）。例如，我们想要处理类似/greet/{name}的URL：

@GetMapping("/greet/{name}")
public String greetWithPathVariable(@PathVariable String name, Model model) {
    model.addAttribute("message", "Hello, " + name + "!");
    return "greet";
}

在这个例子中，我们使用@PathVariable注解将路径中的name提取出来，传递给方法参数。当我们访问/greet/John时，name参数将被设置为"John"。

4. 请求体

有时候，我们需要从请求体中获取数据。例如，处理POST请求时，我们可以通过@RequestBody注解将请求体的内容绑定到方法参数：

@PostMapping("/update")
public String update(@RequestBody User user) {
    // 处理User对象
    return "update-success";
}

在这个例子中，我们期望客户端发送一个JSON格式的User对象到/update路径。SpringMVC将自动将请求体中的JSON数据转换为User对象，传递给方法。

5. 视图解析器

SpringMVC使用视图解析器来将Controller返回的逻辑视图名称解析为实际的视图。默认情况下，Spring Boot使用Thymeleaf作为模板引擎，所以我们可以在src/main/resources/templates目录下创建相应的HTML文件，Spring Boot会自动识别并渲染。

6. 拦截器

拦截器允许我们在Controller处理请求前或者请求后执行一些额外的逻辑。我们可以创建一个拦截器类，实现HandlerInterceptor接口，并在配置中注册。

public class DemoInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // 在请求到达Controller之前执行
        System.out.println("Pre Handle method is Calling");
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) {
        // 在请求处理之后但视图未渲染前执行
        System.out.println("Post Handle method is Calling");
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        // 在视图渲染之后执行
        System.out.println("Request and Response is completed");
    }
}

在配置类中注册拦截器：

@Configuration
public class WebConfig extends WebMvcConfigurerAdapter {

    @Bean
    public DemoInterceptor demoInterceptor() {
        return new DemoInterceptor();
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(demoInterceptor());
    }
}

7. 异常处理

在SpringMVC中，我们可以通过@ExceptionHandler注解来处理Controller内部抛出的异常。在全局范围内，我们可以创建一个@ControllerAdvice注解的类，用于集中处理所有Controller的异常。

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public String handleException(Exception e) {
        // 处理异常并返回错误页面
        return "error";
    }
}

8. 文件上传

处理文件上传是Web应用中常见的需求。SpringMVC提供了MultipartFile类来接收上传的文件，同时我们可以使用@RequestParam注解来绑定文件参数。

@PostMapping("/upload")
public String handleFileUpload(@RequestParam("file") MultipartFile file, Model model) {
    // 处理文件上传逻辑
    return "upload-success";
}

9. 表单验证

在SpringMVC中，我们可以使用@Valid和@ModelAttribute注解来进行表单验证。定义一个简单的实体类，加上验证注解，如@NotNull、@Size等，然后在Controller方法参数上使用@Valid注解。

@PostMapping("/register")
public String register(@Valid @ModelAttribute User user, BindingResult bindingResult) {
    if (bindingResult.hasErrors()) {
        // 处理验证失败的逻辑
        return "registration-form";
    }
    // 处理注册逻辑
    return "registration-success";
}