Spring MVC 响应处理：页面、数据与状态配置 | 极客日志

Javajava

Spring MVC 响应处理：页面、数据与状态配置

Spring MVC 响应处理涵盖视图渲染、数据返回及 HTTP 状态管理。使用@Controller 解析视图路径，@ResponseBody 或@RestController 直接输出数据。支持 HTML 片段与 JSON 对象转换，可通过 HttpServletResponse 设置状态码与响应头。结合前端 Ajax 可实现登录校验与表单提交等交互场景。

CodeArtist发布于 2026/3/21更新于 2026/5/1010 浏览

Spring MVC 响应处理：页面、数据与状态配置

文章配图

响应

定义

响应（Response）是接收方（服务器、服务或设备）针对发送方（客户端）发起的'请求'所返回的反馈信息。

返回静态页面

html 代码：

文章配图

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1>我是 index 页面</h1>
</body>
</html>

代码：

@RestController
@RequestMapping("response")
public class ResponseController {
    @RequestMapping("/1")
    public String method1(){
        return "/index.html";
    }
}

结果：咦？这结果怎么不是我们想要的页面？为什么会这样？那要怎么修改？

文章配图

这个代码的问题在于 @RestController 会将返回值直接作为响应体。这里我们需要用到 @Controller。

为什么呢？

@Controller：承接 http 请求，完成视图解析，方法返回的字符串会被视图解析器处理，找到对应的页面文件，响应给前端。

@RestController：是 @ResponseBody + @Controller 的组合注解，核心是直接返回数据，而不是视图，不会做视图解析流程。

那这样就可以了吗？

正确代码如下：

@Controller

   {
    
     String {
         ;
    }
}

@RequestMapping("/2")
@ResponseBody
public String method2(){
    return "返回数据";
}

@RequestMapping("/4")
@ResponseBody
public String method4(){
    return "<h1>我是一级标题<h1>";
}

@RequestMapping(value = "/5", produces = "text/plain")
@ResponseBody
public String method5(){
    return "<h1>我是一级标题<h1>";
}

public class UserInfo {
    private String name;
    private int age;

    public UserInfo(){}

    public UserInfo(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }

    @Override
    public String toString() {
        return "UserInfo{" + "name='" + name + '\'' + ", age=" + age + '}';
    }
}

@RequestMapping("/6")
@ResponseBody
public UserInfo method6(){
    UserInfo userInfo = new UserInfo("lisi", 13);
    return userInfo;
}

@RequestMapping("/7")
@ResponseBody
public String method7(HttpServletResponse response){
    response.setStatus(401);
    return "设置状态码成功";
}

@RequestMapping("/8")
@ResponseBody
public String method8(HttpServletResponse response){
    response.setHeader("headerkey","headervalue");
    return "设置 header 成功";
}

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
    <form action="calc/sum" method="post">
        <h1>计算器</h1>
        数字 1：<input name="num1" type="text"><br>
        数字 2：<input name="num2" type="text"><br>
        <input type="submit" value="点击相加">
    </form>
</body>
</html>

@RestController
@RequestMapping("/calc")
public class CalcController {
    @RequestMapping("/sum")
    public String method8(Integer num1, Integer num2){
        //如果有其中一个没有参数，直接返回
        if(num1 == null || num2 == null){
            return "参数不合法";
        }
        Integer sum = num1 + num2;
        return "<h1>计算机结果：" + sum + "<h1>";
    }
}

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>登录页面</title>
</head>
<body>
    <!--页面-->
    <h1>用户登录</h1>
    用户名：<input name="userName" type="text"><br>
    密码：<input name="password" type="password"><br>
    <input type="button" value="登录" onclick="login()">
    <script src="https://ajax.aspnetcdn.com/ajax/jQuery/jquery-3.7.1.min.js"></script>
    <script>
        function login(){
            //获取前端数据发送给后端，到时候后端进行校验
            //1.请求方式
            //2.后端地址
            //3.前端数据
            //使用 jQuery 的 ajax 方法发送请求
            $.ajax({
                //请求类型
                type: "post",
                //请求后端接口地址
                url: "/user/login",
                //要发送到后端的数据
                data: {
                    //获取输入框的值
                    userName: $("#userName").val(),
                    password: $("#password").val()
                },
                //返回后端校验后的结果
                //成功跳转页面
                //失败，进行错误提示
                //http 请求成功的回调函数
                //success：是 ajax 专门为成功响应设计的回调，会自动接收后端返回的正常结果
                success: function(result){
                    //判断后端返回的结果
                    if(result){
                        //如果登录成功，跳转页面
                        location.href="index2.html";
                    }else{
                        //否则，返回错误提示
                        alert("密码错误");
                    }
                }
            })
        }
    </script>
</body>
</html>

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RequestMapping("/user")
@RestController
public class UserController {
    @RequestMapping("/login")
    //校验，记录登录状态
    public Boolean login(String userName, String password, HttpSession session){
        //参数校验：校验用户名和密码是否为空或者不是空字符串
        //写法一：
        // if(userName == null || userName == "" || password == null || password == "" ){
        //     return false;
        // }
        //写法二：
        //StringUtils.hasLength()：校验用户名和密码是否为空或者不是空字符串
        if(!StringUtils.hasLength(userName) || !StringUtils.hasLength(password)){
            return false;
        }
        //校验用户名和密码是否正确
        //这里是硬编码，固定用户名为 admin 和密码为 123456，实际数据要从数据库中查询验证
        if("admin".equals(userName) && "123456".equals(password)){
            //如果校验成功，将用户名存储到会话中
            session.setAttribute("userName", userName);
            return true;
        }
        return false;
    }
    //查询当前登录状态
    @RequestMapping("/getLoginUser")
    public String getLoginUser(HttpSession session){
        //获取会话中存储的值
        //如果用户未登录，返回 null
        //如果用户已登录，返回用户名
        String userName = (String) session.getAttribute("userName");
        return userName;
    }
}

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>用户登录首页</title>
</head>
<body>
    登录人：<span></span>
    <script src="https://ajax.aspnetcdn.com/ajax/jQuery/jquery-3.7.1.min.js"></script>
    <script>
        $.ajax({
            url: "/user/getLoginUser",
            type: "get",
            //请求成功后的回调函数
            success: function(userName){
                //将结果填充到页面
                $("#loginUser").text(userName);
            }
        });
    </script>
</body>
</html>