展开菜单
首页 精品内容 本月促销 装机必备 Windows PDF教程 macOS软件 IOS软件 Android AI 专题
全部分类

当前位置:

首页 > 编程开发 > SpringMVC多种响应返回方式详解

SpringMVC多种响应返回方式详解

这几天后台收到不少关于 SpringMVC 返回方式的提问,问题集中在几个点上:Controller 方法到底能怎么返回数据?不同返回形式底层流程有什么区别?什么时候页面会404?@ResponseBody 加在哪里?@RestController 原理是什么? 今天这篇文章,就围绕传统服务端渲染(

本文目录

    这几天后台收到不少关于 SpringMVC 返回方式的提问,问题集中在几个点上:Controller 方法到底能怎么返回数据?不同返回形式底层流程有什么区别?什么时候页面会404?@ResponseBody 加在哪里?@RestController 原理是什么?

    今天这篇文章,就围绕传统服务端渲染(JSP/模板引擎)和前后端分离两种场景,系统梳理一下 SpringMVC 的各类返回形式。

    一、SpringMVC 各类返回形式完整梳理

    1. 返回普通字符串(视图名称,传统服务端渲染)

    @RequestMapping("/index")
    public String index(){
        // 返回视图名
        return "index";
    }

    ✅ 执行流程:

    1. SpringMVC 获取返回字符串 index
    2. 视图解析器 ViewResolver 拼接前缀、后缀,找到视图资源(如 /WEB-INF/index.jsp)
    3. 请求转发到该页面渲染,把 Model 中存放的数据带到页面

    默认规则:返回字符串 = 视图名称 特殊前缀:

    • return "forward:/page":代表请求转发,不再走视图解析器
    • return "redirect:/login":代表重定向,不再走视图解析器

    SpringMVC多种响应返回方式详解

    2. 返回 void(极易出现404,重点避坑)

    @RequestMapping("/demo")
    public void demo(HttpServletRequest request,HttpServletResponse response){
    }

    ⚠️ 如果方法直接返回void,SpringMVC会尝试寻找和当前访问路径同名的视图,找不到就报404。 想要void不报错,三种方案(和图片描述一致):

    (1)使用response手动输出响应(直接写文本、JSON)

    response.setContentType("application/json;charset=utf-8");
    response.getWriter().write("{"code":200}");

    缺点:原生ServletAPI,代码繁琐,项目中不推荐大规模使用。

    (2)方法内手动执行 请求转发 forward

    request.getRequestDispatcher("/success").forward(request,response); 

    (3)方法内手动执行 重定向 redirect

    response.sendRedirect("/login"); 

    重要提醒:forward/redirect一旦执行,不要再次返回视图名称,也不要重复输出响应,会抛出异常。

    3. 返回 ModelAndView

    ModelAndView = Model(数据) + View(视图名称)

    @RequestMapping("/list")
    public ModelAndView list(){
        ModelAndView mv = new ModelAndView();
        mv.addObject("name","张三"); // 存入request域,页面可以获取
        mv.setViewName("list"); // 设置视图名称
        return mv;
    }

    特点:把数据和视图封装在同一个对象,老式项目使用较多;现代开发更推荐 Model + String 返回形式。

    4. 返回 Model + String(分离写法,开发最常用)

    @RequestMapping("/list")
    public String list(Model model){
        model.addAttribute("name","张三");
        return "list"; // 视图名称
    }
    • Model:用来向request域存放页面需要的数据
    • 返回字符串:视图名称 优势:数据、视图分离,代码可读性高于 ModelAndView,是服务端渲染项目主流写法。

    5. 返回JSON数据(前后端分离核心,@ResponseBody登场)

    上面4种全部是服务端渲染,跳转页面; 前后端分离项目,我们不需要跳转页面,而是直接返回JSON字符串给前端。 想要实现这个效果,核心注解:@ResponseBody

    // 方式1:注解加在方法上
    @RequestMapping("/user")
    @ResponseBody
    public User getUser(){
        User user = new User();
        user.setName("李四");
        return user; // 框架自动转为JSON
    }

    @ResponseBody核心作用

    告诉SpringMVC:不要使用视图解析器、不要跳转页面!直接把返回对象转为JSON,写入响应体返回浏览器。 底层原理: 返回对象 → MappingJackson2HttpMessageConverter → Jackson序列化 → JSON字符串 → 输出到response响应体。

    二、重点注解深度解析 @ResponseBody / @RestController

    1. @ResponseBody 可以写在哪里?

    两种合法位置:

    1. 写在Controller方法上:只对当前这一个方法生效
    @Controller
    public class UserController{
        @ResponseBody
        @RequestMapping("/user")
        public User getUser(){
            return new User();
        }
    }
    1. 写在Controller类上:当前类所有方法全部生效
    @Controller
    @ResponseBody
    public class UserController{
        // 所有方法返回值都会序列化为JSON,不再解析视图
    }

    2. @RestController 是什么?

    @Target(ElementType.TYPE)
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    @Controller
    @ResponseBody
    public @interface RestController {
    }

    ✅ 结论: @RestController = @Controller + @ResponseBody 写在类上,代表:当前Controller所有方法,默认直接返回JSON,不跳转视图。

    // 等价于 @Controller + @ResponseBody
    @RestController
    public class UserController{
        @RequestMapping("/user")
        public User getUser(){
            return new User();
        }
    }

    3. 高频面试区分:@Controller VS @RestController

    1. @Controller
      • 默认:方法返回字符串 = 视图名称,用于页面跳转
      • 如果想要返回JSON,必须在方法上加 @ResponseBody
    2. @RestController
      • 自带 @ResponseBody,所有方法直接返回JSON

    无法直接通过返回字符串跳转页面

    如果RestController里一定要跳转页面,只能手动forward/redirect

    4. 极易踩坑的误区

    误区1:@RestController 能不能写页面跳转?

    不能直接return视图名。 如果必须跳转:

    // RestController中跳转写法
    return "forward:/index";
    return "redirect:/login";

    误区2:同时使用 @ResponseBody 和 forward/redirect

    @ResponseBody
    public String test(){
        // 冲突!@ResponseBody会把"forward:/index"当成普通字符串直接返回给前端,不会执行转发
        return "forward:/index";
    }

    重点:添加了@ResponseBody的方法,返回forward/redirect前缀字符串失效!如果想要实现转发和重定向,需要手动response.sendRedirect,但是不支持(因为很矛盾)

    误区3:@ResponseBody可以解析JSP页面 不可能。@ResponseBody的语义就是「返回响应体数据,放弃视图解析」。

    三、所有返回方式分类总结

    类别A:服务端渲染(跳转页面,传统JSP/Thymeleaf)

    1. 返回视图名称 String(配合Model传数据)
    2. 返回 ModelAndView

    控制器注解:@Controller,不能加@ResponseBody

    类别B:手动操控原生响应(void返回)

    1. response输出内容
    2. 代码内手动forward / redirect

    适合特殊场景,项目不推荐大量使用

    类别C:前后端分离(返回JSON,不跳转页面)

    1. @Controller + 方法上 @ResponseBody
    2. @RestController(内置ResponseBody,直接返回实体对象)

    四、一张表梳理所有场景

    返回类型配套注解作用
    String(普通视图名)@Controller走视图解析器,跳转页面
    String(forward:/ redirect:/)@Controller转发/重定向
    ModelAndView@Controller封装数据+视图,跳转页面
    void@Controller需要手动response输出/转发/重定向,否则404
    实体类/集合@Controller + @ResponseBody自动序列化为JSON返回
    实体类/集合@RestController全部方法默认返回JSON

    五、选型建议

    1. 传统服务端渲染项目(页面模板) 使用 @Controller,返回视图名称,配合Model传递数据。
    2. 前后端分离项目(Vue/小程序) 统一使用 @RestController,方法直接返回实体、统一结果对象。
    3. 一个Controller既有页面跳转,又有JSON接口 使用 @Controller,页面方法正常返回视图,接口方法单独加上 @ResponseBody。

    以上就是SpringMVC多种响应返回方式详解的全部内容,希望对你有帮助。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    精品专题 更多
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    macOS软件

    正软商城macOS软件专区,精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具,提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。

    IOS软件

    正软商城iOS软件专区,精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用,提供功能介绍、适用设备、系统要求和正版获取方式等信息。

    AI

    正软商城AI软件专区,汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具,提供功能介绍、适用平台、收费方式及正版购买信息。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    立刻MV 网页版
    立刻MV 网页版

    立刻MV 面向音乐人、内容创作者和品牌团队,帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

    蛙蛙写作 网页版
    蛙蛙写作 网页版

    蛙蛙写作 AI 创作工具,覆盖小说、剧本、文案,一键生成文稿,打通文字转视频全流程,高效解决创作难题。

    超级简历WonderCV 网页版
    超级简历WonderCV 网页版

    超级简历WonderCV是面向应届生和AI小白的智能求职平台,覆盖简历、面试与职业规划。

    音述AI 网页版
    音述AI 网页版

    音述AI,是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

    AionClaw macOS版
    AionClaw macOS版

    AionClaw 是可在桌面端运行的任务型 AI 助手,通过数字专家与技能市场组合办公、创作、数据和开发能力。

    Loomy macOS版
    Loomy macOS版

    Loomy 是科大讯飞推出的桌面 AI 助手,可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。

    AirBuddy 3 macOS版
    AirBuddy 3 macOS版

    AirBuddy 3 是面向 macOS 的蓝牙外设增强工具,可集中查看 AirPods、Beats 与苹果设备电量,提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。

    AirServer macOS版
    AirServer macOS版

    AirServer macOS版可把 Mac 转换为无线投屏接收端,通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面,并支持多设备同时连接、高清镜像及会话录制,适合家庭娱乐、课堂教学、会议演示和应用展示。

    AnyDesk macOS版
    AnyDesk macOS版

    AnyDesk macOS版是一款适用于远程办公、设备维护和客户支持的远程桌面工具,可连接并操作异地计算机,支持文件传输、无人值守访问、会话权限控制及跨平台协作。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。

    讯飞绘文 网页版
    讯飞绘文 网页版

    讯飞绘文网页版是科大讯飞推出的AI图文创作与内容运营工具,覆盖热点选题、文章生成、稿件校对、智能配图、排版发布和数据复盘等环节,适合自媒体创作者及内容团队在线使用。

    Maya(Autodesk Maya) Windows版
    Maya(Autodesk Maya) Windows版

    Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件,集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体,

    Aperty Windows版
    Aperty Windows版

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    立刻MV 网页版
    立刻MV 网页版

    立刻MV 面向音乐人、内容创作者和品牌团队,帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

    蛙蛙写作 网页版
    蛙蛙写作 网页版

    蛙蛙写作 AI 创作工具,覆盖小说、剧本、文案,一键生成文稿,打通文字转视频全流程,高效解决创作难题。

    超级简历WonderCV 网页版
    超级简历WonderCV 网页版

    超级简历WonderCV是面向应届生和AI小白的智能求职平台,覆盖简历、面试与职业规划。

    音述AI 网页版
    音述AI 网页版

    音述AI,是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

    AionClaw Windows版
    AionClaw Windows版

    AionClaw 是可在桌面端运行的任务型 AI 助手,通过数字专家与技能市场组合办公、创作、数据和开发能力。

    Loomy Windows版
    Loomy Windows版

    Loomy 是科大讯飞推出的桌面 AI 助手,可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。