17、Spring MVC 框架：构建强大的 Java Web 应用程序

嘿，Java 开发者们！今天我们将深入探讨 Spring MVC 框架，它是 Spring 框架中专门用于构建 Web 应用程序的一个强大模块。Spring MVC 遵循经典的 MVC（Model-View-Controller）设计模式，让我们能够轻松地开发出清晰、可维护和可扩展的 Web 应用程序。让我们一起探索 Spring MVC 的世界，看看如何利用它来处理 HTTP 请求和响应，构建出色的 Web 服务和网站吧！

一、Spring MVC 概述

1. 什么是 Spring MVC？

Spring MVC 是 Spring 框架的一部分，它是一个基于 Java 的 Web 开发框架，旨在帮助我们构建灵活、可扩展和可维护的 Web 应用程序。它采用了经典的 MVC 设计模式，将应用程序分为三个核心部分：

• Model：存储数据，通常是业务逻辑处理的结果，将数据提供给视图进行展示。
• View：负责呈现数据，通常是 JSP、Thymeleaf 等模板，或者是 JSON、XML 等数据格式。
• Controller：处理用户请求，调用相应的业务逻辑，将数据存储在 Model 中，并将请求转发给适当的视图。

2. Spring MVC 的优势

• 轻量级：Spring MVC 是一个轻量级框架，不依赖于其他复杂的技术，易于学习和使用。
• 松耦合：将业务逻辑、数据和视图分离，提高代码的可维护性和可扩展性。
• 强大的配置选项：可以通过 XML 或 Java 代码进行配置，提供了高度的灵活性。
• 支持多种视图技术：可以使用 JSP、Thymeleaf、Freemarker 等多种视图技术。

二、搭建 Spring MVC 项目

1. 配置依赖

使用 Maven 或 Gradle 引入 Spring MVC 依赖，以下是一个 Maven 项目的依赖配置示例：

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.10</version>
    </dependency>
    <!-- 其他依赖，如 Servlet API 等 -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

2. 配置 Spring MVC 框架

2.1 基于 Java 的配置

可以使用 @Configuration 和 @EnableWebMvc 注解进行配置：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.ViewResolver;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.view.InternalResourceViewResolver;

@Configuration
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
    @Bean
    public ViewResolver viewResolver() {
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("/WEB-INF/views/");
        resolver.setSuffix(".jsp");
        return resolver;
    }
}

2.2 基于 XML 的配置

使用 web.xml 和 spring-servlet.xml 进行配置：

web.xml：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
    <servlet>
        <servlet-name>spring</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/spring-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>spring</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

spring-servlet.xml：

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <context:component-scan base-package="com.example.controller"/>
    <mvc:annotation-driven/>
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

三、创建 Controller

1. 使用 @Controller 注解

使用 @Controller 注解标识控制器类，使用 @RequestMapping 注解处理请求。

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

@Controller
@RequestMapping("/hello")
public class HelloController {
    @RequestMapping("/greet")
    public String greet(@RequestParam(name = "name", required = false, defaultValue = "World") String name, Model model) {
        model.addAttribute("message", "Hello, " + name + "!");
        return "hello";
    }
}

2. 处理不同类型的请求

使用不同的请求方法注解，如 @GetMapping、@PostMapping、@PutMapping、@DeleteMapping 等。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.servlet.ModelAndView;

@Controller
@RequestMapping("/user")
public class UserController {
    @GetMapping("/login")
    public String loginForm() {
        return "login";
    }

    @PostMapping("/login")
    public ModelAndView login(@RequestParam String username, @RequestParam String password) {
        ModelAndView modelAndView = new ModelAndView();
        if ("admin".equals(username) && "password".equals(password)) {
            modelAndView.addObject("message", "Login successful");
            modelAndView.setViewName("success");
        } else {
            modelAndView.addObject("message", "Invalid credentials");
            modelAndView.setViewName("login");
        }
        return modelAndView;
    }
}

四、使用 Model 和 View

1. Model 的使用

使用 Model 或 ModelAndView 将数据传递给视图。

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

@Controller
@RequestMapping("/data")
public class DataController {
    @GetMapping("/show")
    public String showData(Model model) {
        model.addAttribute("data", "Some data to display");
        return "dataView";
    }
}

2. 视图解析器

视图解析器将逻辑视图名解析为实际的视图，例如将 hello 解析为 /WEB-INF/views/hello.jsp。

五、数据绑定和验证

1. 数据绑定

Spring MVC 可以自动将请求参数绑定到方法参数或对象上。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ModelAttribute;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("/form")
public class FormController {
    @GetMapping("/submit")
    public String showForm(Model model) {
        model.addAttribute("user", new User());
        return "form";
    }

    @PostMapping("/submit")
    public String submitForm(@ModelAttribute User user) {
        // 处理用户对象
        return "result";
    }
}

2. 数据验证

使用 @Valid 注解和 BindingResult 进行数据验证。

import javax.validation.Valid;
import org.springframework.stereotype.Controller;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
@RequestMapping("/form")
public class FormController {
    @GetMapping("/submit")
    public String showForm(Model model) {
        model.addAttribute("user", new User());
        return "form";
    }

    @PostMapping("/submit")
    public ModelAndView submitForm(@Valid @ModelAttribute User user, BindingResult result) {
        ModelAndView modelAndView = new ModelAndView();
        if (result.hasErrors()) {
            modelAndView.setViewName("form");
        } else {
            modelAndView.setViewName("result");
        }
        return modelAndView;
    }
}

六、异常处理

使用 @ExceptionHandler 注解处理异常。

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class ExceptionController {
    @GetMapping("/error")
    public String throwException() {
        throw new RuntimeException("Something went wrong");
    }

    @ExceptionHandler(RuntimeException.class)
    public ModelAndView handleException(RuntimeException ex) {
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("error", ex.getMessage());
        modelAndView.setViewName("error");
        return modelAndView;
    }
}

七、总结与实践

Spring MVC 是一个功能强大的 Java Web 开发框架，它提供了丰富的功能和灵活的配置选项，帮助我们开发高质量的 Web 应用程序。通过使用控制器、模型和视图，我们可以处理各种 HTTP 请求，进行数据绑定和验证，并处理异常。

现在，你可以开始构建自己的 Spring MVC 项目啦 尝试创建一个简单的网站，包含表单提交、用户登录、数据展示等功能，你会更深入地理解 Spring MVC 的强大之处。如果你在开发过程中遇到任何问题，欢迎在评论区留言，让我们一起探索如何使用 Spring MVC 构建出色的 Web 应用程序，为我们的用户提供优质的 Web 服务。