SpringMVC 响应数据和结果视图从环境搭建到实战全解析

<properties>
    <!-- 统一 Spring 版本 -->
    <spring.version>5.0.2.RELEASE</spring.version>
</properties>
<dependencies>
    <!-- 1. Spring 核心依赖 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <!-- 2. Servlet/JSP 依赖（scope=provided：服务器已内置，仅编译时用） -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.5</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>jsp-api</artifactId>
        <version>2.0</version>
        <scope>provided</scope>
    </dependency>
    <!-- 3. JSON 转换依赖（后续异步交互用） -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.9.0</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-core</artifactId>
        <version>2.9.0</version>
    </dependency>
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-annotations</artifactId>
        <version>2.9.0</version>
    </dependency>
</dependencies>

<filter>
    <filter-name>characterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <!-- 设置请求编码 -->
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <!-- 可选：同时设置响应编码（部分场景需额外配置） -->
    <init-param>
        <param-name>forceResponseEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>characterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern> <!-- 拦截所有请求 -->
</filter-mapping>

<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 加载 SpringMVC 核心配置文件（classpath 表示类路径下） -->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!-- 服务器启动时初始化（优先级 1，数值越小优先级越高） -->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <!-- 拦截所有 .do 结尾的请求（避免拦截静态资源如 CSS/JS） -->
    <url-pattern>*.do</url-pattern>
</servlet-mapping>

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd">
    <!-- 1. 注解扫描：仅扫描 Controller 所在包（避免扫描 Service/Dao 层） -->
    <context:component-scan base-package="com.springmvc.controller" />
    <!-- 2. 视图解析器：拼接物理视图路径（逻辑视图名 → 实际页面路径） -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/pages/" /> <!-- 页面所在目录（WebRoot 下） -->
        <property name="suffix" value=".jsp" />    <!-- 页面后缀 -->
        <!-- 示例：逻辑视图名 "suc" → 拼接后：/pages/suc.jsp -->
    </bean>
    <!-- 3. 启用 SpringMVC 注解驱动：让 @RequestMapping、@RequestBody 等注解生效 -->
    <mvc:annotation-driven/>
    <!-- 4. 静态资源放行：避免 CSS/JS/图片被 DispatcherServlet 拦截 -->
    <mvc:resources location="/css/" mapping="/css/**"/>    <!-- 匹配 /css/ 下所有资源 -->
    <mvc:resources location="/images/" mapping="/images/**"/>
    <mvc:resources location="/js/" mapping="/js/**"/>
</beans>

package com.springmvcy.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping("/user") // 类级别的请求路径（统一前缀）
public class UserController {
    // 方法级别的请求路径：完整请求路径为 /user/save1.do
    @RequestMapping("/save1.do")
    public String save1() {
        System.out.println("执行用户保存业务（save1）");
        // 返回逻辑视图名 "suc" → 视图解析器拼接为：/pages/suc.jsp
        return "suc";
    }
}

@RequestMapping("/save2.do")
public void save2(HttpServletRequest request, HttpServletResponse response) 
        throws ServletException, IOException {
    System.out.println("执行用户保存业务（save2）");
    // 场景1：请求转发（服务器内部跳转，地址栏不变，可共享 request 数据）
    request.getRequestDispatcher("/pages/suc.jsp").forward(request, response);
    // 场景2：直接响应文本（无需跳转页面，如接口返回简单提示）
    // response.setContentType("text/html;charset=UTF-8"); // 解决响应中文乱码
    // response.getWriter().print("用户保存成功！");
    // 场景3：重定向（客户端跳转，地址栏改变，不可共享 request 数据）
    // response.sendRedirect(request.getContextPath() + "/pages/suc.jsp");
}

@RequestMapping("/save3.do")
public ModelAndView save3() {
    System.out.println("执行用户保存业务（save3）");
    // 1. 创建 ModelAndView 对象
    ModelAndView mv = new ModelAndView();
    // 2. 存入页面所需数据（相当于 request.setAttribute("msg", "用户名已存在")）
    // 页面可通过 EL 表达式 ${msg} 获取该数据
    mv.addObject("msg", "保存失败：用户名已存在，请更换用户名");
    // 可存入多个数据：mv.addObject("user", new User("张三", 20));
    // 3. 设置逻辑视图名（视图解析器拼接为 /pages/error.jsp）
    mv.setViewName("error");
    // 返回 ModelAndView 对象，SpringMVC 自动处理数据传递与页面跳转
    return mv;
}

@RequestMapping("/save4.do")
public String save4() {
    System.out.println("执行用户保存业务（save4）");
    // 方式1：转发到具体页面（绝对路径）
    // return "forward:/pages/suc.jsp";
    // 方式2：转发到其他 Controller 方法（完整请求路径）
    return "forward:/user/findAll.do";
}

@RequestMapping("/save5.do")
public String save5() {
    System.out.println("执行用户保存业务（save5）");
    // 方式1：重定向到具体页面（需拼接项目上下文路径，避免路径错误）
    // return "redirect:" + request.getContextPath() + "/pages/suc.jsp";
    // 方式2：重定向到其他 Controller 方法（完整请求路径）
    return "redirect:/user/findAll.do";
}

package com.springmvc.entity;
import java.io.Serializable;
// 实体类：对应前端传递的 JSON 数据结构
public class User implements Serializable {
    private String username; // 用户名
    private Integer age;     // 年龄
    // 无参构造（JSON 反序列化需）
    public User() {}
    // 有参构造（可选）
    public User(String username, Integer age) {
        this.username = username;
        this.age = age;
    }
    // 必须提供 getter/setter 方法（Jackson 依赖 getter 序列化）
    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
    @Override
    public String toString() {
        return "User{" + "username='" + username + "', age=" + age + "}";
    }
}

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>SpringMVC JSON 交互</title>
    <!-- 引入 jQuery（需确保 js 目录已配置静态资源放行） -->
    <script src="/js/jquery.min.js" type="text/javascript"></script>
    <script>
        $(function() {
            $("#btnSubmit").click(function() {
                // 1. 构造 JSON 数据（与后端 User 实体类属性对应）
                let userData = JSON.stringify({
                    "username": "张三",
                    "age": 25
                });
                // 2. 发送 AJAX 请求
                $.ajax({
                    type: "post",                  // 请求方式（JSON 传递需用 post）
                    url: "/user/save6.do",         // 请求路径
                    contentType: "application/json;charset=UTF-8", // 关键：声明请求数据格式为 JSON
                    data: userData,                // 传递的 JSON 数据
                    dataType: "json",              // 期望后端返回 JSON 格式数据
                    success: function(res) {       // 响应成功回调（res 为后端返回的 JSON 对象）
                        alert("用户名：" + res.username + "，年龄：" + res.age);
                    },
                    error: function() {            // 响应失败回调
                        alert("请求失败，请重试！");
                    }
                });
            });
        });
    </script>
</head>
<body>
    <button id="btnSubmit">提交用户数据（AJAX）</button>
</body>
</html>

@RequestMapping("/save6.do")
// @ResponseBody：将返回的 User 对象转为 JSON 响应前端
@ResponseBody
public User save6(@RequestBody User user) { // @RequestBody：将前端 JSON 转为 User 对象
    System.out.println("接收前端传递的用户数据：" + user); // 打印：User{username='张三', age=25}
    // 模拟业务处理：如修改用户名和年龄
    user.setUsername("张三_已处理");
    user.setAge(user.getAge() + 1);
    // 直接返回 User 对象，@ResponseBody 自动转为 JSON
    return user;
}

<mvc:annotation-driven>
    <mvc:message-converters>
        <bean class="org.springframework.http.converter.StringHttpMessageConverter">
            <property name="supportedMediaTypes">
                <list>
                    <value>application/json;charset=UTF-8</value>
                </list>
            </property>
        </bean>
    </mvc:message-converters>
</mvc:annotation-driven>