备案控制台
开发者社区 开发与运维 文章 正文

SpringMVC之JSON数据返回与异常处理机制---全方面讲解

2023-11-14 150
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： SpringMVC之JSON数据返回与异常处理机制---全方面讲解

一，JSON数据返回的理解

    在Spring MVC中，当需要将数据以JSON格式返回给客户端时，可以使用@ResponseBody注解或@RestController注解将Controller方法的返回值直接转化为JSON格式并返回。这使得开发者可以方便地将Java对象转换为JSON，并通过HTTP响应返回给客户端。Spring MVC框架会自动地处理这一转换过程，将对象序列化为JSON字符串。这种方式适用于RESTful API的实现

1.2 Jackson

1.2.1 介绍

   Jackson是一个简单基于Java应用库，Jackson可以轻松的将Java对象转换成json对象和xml文档，同样也可以将json、xml转换成Java对象。Jackson所依赖的jar包较少，简单易用并且性能也要相对高些，并且Jackson社区相对比较活跃，更新速度也比较快。

1.2.2 特点

  • 容易使用，提供了高层次外观，简化常用的用例。
  • 无需创建映射，API提供了默认的映射大部分对象序列化。
  • 性能高，快速，低内存占用
  • 创建干净的json
  • 不依赖其他库
  • 代码开源

1.2.3.常用注解

注解 说明
@JsonIgnore 作用在字段或方法上，用来完全忽略被注解的字段和方法对应的属性
@JsonProperty 作用在字段或方法上，用来对属性的序列化/反序列化，可以用来避免遗漏属性，同时提供对属性名称重命名
@JsonIgnoreProperties 作用在类上，用来说明有些属性在序列化/反序列化时需要忽略掉
@JsonUnwrapped 作用在属性字段或方法上，用来将子JSON对象的属性添加到封闭的JSON对象
@JsonFormat

指定序列化日期/时间值时的格式

二，JSON入门的使用

2.1 导入pom.xml依赖

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.9.3</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-core</artifactId>
    <version>2.9.3</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-annotations</artifactId>
    <version>2.9.3</version>
</dependency>

2.2 配置spring-mvc.xml

<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
    <property name="messageConverters">
        <list>
          <ref bean="mappingJackson2HttpMessageConverter"/>
        </list>
    </property>
</bean>
<bean id="mappingJackson2HttpMessageConverter"
class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
    <!--处理中文乱码以及避免IE执行AJAX时，返回JSON出现下载文件-->
    <property name="supportedMediaTypes">
        <list>
            <value>text/html;charset=UTF-8</value>
            <value>text/json;charset=UTF-8</value>
            <value>application/json;charset=UTF-8</value>
        </list>
    </property>
</bean>

2.3 @ResponseBody注解使用

@ResponseBody注解的作用是将Controller的方法返回的对象通过适当的转换器转换为指定的格式之后，写入到response对象的body区，通常用来返回JSON数据或者是XML数据。

注意：在使用此注解之后不会再走视图解析器，而是直接将数据写入到输入流中，他的效果等同于通过response对象输出指定格式的数据。

2.4 实例演示

Mapper.xml的配置：

<select id="mapListPager" resultType="java.util.Map" parameterType="com.Bingzy.model.Tbook" >
    select  * from t_mvc_book
    <where>
      <if test="bname != null">
        and bname like concat('%',#{bname},'%')
      </if>
      <if test="bid != null">
        and bid = #{bid}
      </if>
    </where>
  </select>

Mapper类的方法：

List<Map> mapListPager(Tbook tbook);

Biz层：

List<Map> mapListPager(Tbook tbook,PageBean pageBean);

实现Biz层： 

@Override
        public List<Map> mapListPager(Tbook tbook, PageBean pageBean) {
            return tbookMapper.mapListPager(tbook);
    }

JsonController层： 

/**
 * @Name BingBing
 * @company zking cy
 * @create 2023-09-08-19:51
 */
@Controller
@RequestMapping("/book")
public class JsonController {
    @Autowired
    private TbookBiz tbookbiz;
    /**
     * 返回List<T>
     * @param req
     * @param tbook
     * @return
     */
    @ResponseBody
    @RequestMapping("/list")
    public List<Tbook> list(HttpServletRequest req, Tbook tbook){
        PageBean pageBean = new PageBean();
        pageBean.setRequest(req);
        List<Tbook> lst = this.tbookbiz.listPager(tbook, pageBean);
        return lst;
    }
    /**
     * 返回T
     * @param req
     * @param tbook
     * @return
     */
    @ResponseBody
    @RequestMapping("/load")
    public Tbook load(HttpServletRequest req, Tbook tbook){
        if(tbook.getBid() != null){
            List<Tbook> lst = this.tbookbiz.listPager(tbook, null);
            return lst.get(0);
        }
        return null;
    }
    /**
     * 返回List<Map>
     * @param req
     * @param tbook
     * @return
     */
    @ResponseBody
    @RequestMapping("/mapList")
    public List<Map> mapList(HttpServletRequest req, Tbook tbook){
        PageBean pageBean = new PageBean();
        pageBean.setRequest(req);
        List<Map> lst = this.tbookbiz.mapListPager(tbook, pageBean);
        return lst;
    }
    /**
     * 返回Map
     * @param req
     * @param tbook
     * @return
     */
    @ResponseBody
    @RequestMapping("/mapLoad")
    public Map mapLoad(HttpServletRequest req, Tbook tbook){
        if(tbook.getBid() != null){
            List<Map> lst = this.tbookbiz.mapListPager(tbook, null);
            return lst.get(0);
        }
        return null;
    }
    @ResponseBody
    @RequestMapping("/all")
    public Map all(HttpServletRequest req, Tbook tbook){
        PageBean pageBean = new PageBean();
        pageBean.setRequest(req);
        List<Tbook> lst = this.tbookbiz.listPager(tbook, pageBean);
        Map map = new HashMap();
        map.put("lst",lst);
        map.put("pageBean",pageBean);
        return map;
    }
    @ResponseBody
    @RequestMapping("/jsonStr")
    public String jsonStr(HttpServletRequest req, Tbook tbook){
        return "clzEdit";
    }
}

以下我会以JSON格式的不同情况来演示数据回显

返回List<T>：

返回T：

返回List<Map>：

返回Map：

返回JSON数组：

返回字符串：

三，异常机制的处理

3.1 异常机制处理概念

     异常处理是在应用程序中捕获和处理异常的过程。在Spring MVC中，异常处理机制允许我们在请求处理的各个阶段捕获异常并采取相应的操作，比如返回错误页面或JSON格式的错误信息。通过自定义异常处理器，我们可以在应用程序中集中管理异常，并为每种异常定义不同的处理方式

3.2 为什么要全局异常处理

      我们知道，系统中异常包括：编译时异常和运行时异常RuntimeException，前者通过捕获异常从而获取异常信息，后者主要通过规范代码开发、测试通过手段减少运行时异常的发生。在开发中，不管是dao层、service层还是controller层，都有可能抛出异常，在springmvc中，能将所有类型的异常处理从各处理过程解耦出来，既保证了相关处理过程的功能较单一，也实现了异常信息的统一处理和维护。

3.3 异常处理思路

系统的dao、service、controller出现异常都通过throws Exception向上抛出，最后由springmvc前端控制器交由异常处理器进行异常处理。springmvc提供全局异常处理器（一个系统只有一个异常处理器）进行统一异常处理

具体来说，异常处理的思路包括以下几个方面：

确定异常类型：在进行异常处理之前，需要先确定可能会出现哪些异常情况，以及这些异常情况对应的异常类型。

添加异常处理代码：在程序中添加相应的异常处理代码，用于捕获可能出现的异常，并进行相应的处理。

处理异常：根据不同的异常类型，采取不同的处理方式。例如，对于运行时异常，可以采取打印错误信息等方式进行处理；对于受检异常，则需要在方法声明中添加throws关键字，并在调用该方法时进行try-catch处理。

优化异常处理：在实际应用中，需要根据具体情况对异常处理进行优化。例如，可以使用多线程机制来提高程序的性能；或者使用日志系统来记录程序运行过程中出现的异常情况等。

异常处理思路图：

3.4 SpringMVC异常分类

  • 使用Spring MVC提供的简单异常处理器SimpleMappingExceptionResolver；
  • 实现Spring的异常处理接口HandlerExceptionResolver自定义自己的异常处理器；
  • 使用@ControllerAdvice + @ExceptionHandler

四，案例异常实战(三种)

4.1 异常处理方式一

SpringMVC中自带了一个异常处理器叫SimpleMappingExceptionResolver，该处理器实现了HandlerExceptionResolver 接口，全局异常处理器都需要实现该接口

在spring-mvc.xml配置文件：

<!-- springmvc提供的简单异常处理器 -->
    <bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
        <!-- 定义默认的异常处理页面 -->
        <property name="defaultErrorView" value="error"/>
        <!-- 定义异常处理页面用来获取异常信息的变量名，也可不定义，默认名为exception -->
        <property name="exceptionAttribute" value="ex"/>
        <!-- 定义需要特殊处理的异常，这是重要点 -->
        <property name="exceptionMappings">
            <props>
                <prop key="java.lang.RuntimeException">error</prop>
            </props>
            <!-- 还可以定义其他的自定义异常 -->
        </property>
    </bean>

JsonController创建一个错误方法：

@RequestMapping("/error")
    public String error(Tbook tbook) {
        tbook = null;
        tbook.getBname();
        return "error";
    }

在WEB-INF创建jsp包下创建一个error.jsp页面来接受报错信息

error.jsp: 

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>系统繁忙</title>
</head>
<body>
<b1>发生异常！！！</b1>
${ex }
</body>
</html>

运行结果：

注意:因为在JsonController已经给实体为null值了接受的Bname值为空值，所以报出空指针异常

1.通过instanceof判断异常类型

2.通过设置mv.setView(new MappingJackson2JsonView())方式返回JSON数据

4.2 异常处理方式二

创建一个Package包，定义GlobalException类并继承RuntimeException

GlobalException类：

package com.Bingzy.Excetion;
public class GlobalException extends RuntimeException {
    public GlobalException() {
    }
    public GlobalException(String message) {
        super(message);
    }
    public GlobalException(String message, Throwable cause) {
        super(message, cause);
    }
    public GlobalException(Throwable cause) {
        super(cause);
    }
    public GlobalException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
        super(message, cause, enableSuppression, writableStackTrace);
    }
}

再创建一个Package包，定义GlobalExceptionHandler类并继承HandlerExceptionResolver

GlobalExceptionHandler类：

@Component
public class GlobalExceptionHandler implements HandlerExceptionResolver {
    @Override
    public ModelAndView resolveException(HttpServletRequest httpServletRequest,
                                         HttpServletResponse httpServletResponse,
                                         Object o, Exception e) {
        ModelAndView mv = new ModelAndView();
        mv.setViewName("error");
        if (e instanceof GlobalException){
            GlobalException globalException = (GlobalException) e;
            mv.addObject("ex",globalException.getMessage());
            mv.addObject("msg","全局异常....");
        }else if (e instanceof RuntimeException){
            RuntimeException runtimeException = (RuntimeException) e;
            mv.addObject("ex",runtimeException.getMessage());
            mv.addObject("msg","运行时异常....");
        }
        return mv;
    }
}

在JsonController中再创建一个error2方法

@RequestMapping("/error2")
    public String error2(Tbook tbook) {
        if (true)
            throw  new GlobalException("你不正经 怎么能乱发请求呢？😒😒");
        return "error";
    }

error.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>系统繁忙</title>
</head>
<body>
<b1>发生异常！！！</b1>
<br>-----------------------<br>
${ex }
<br>--------------------<br>
${msg }
</body>
</html>

运行结果：

4.3 异常处理方式三

定义一个GlobalExceptionResolver类

package com.Bingzy.GlobaExcetion;
import com.Bingzy.Excetion.GlobalException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import java.util.HashMap;
import java.util.Map;
@ControllerAdvice
public class GlobalExceptionResolver {
// 返回错误json数据
    @ResponseBody
    @ExceptionHandler
    public Map handler(Exception e){
        Map map = new HashMap();
        if (e instanceof GlobalException){
            GlobalException globalException = (GlobalException) e;
            map.put("ex",globalException.getMessage());
            map.put("msg","全局异常....");
        }else if (e instanceof RuntimeException){
            RuntimeException runtimeException = (RuntimeException) e;
            map.put("ex",runtimeException.getMessage());
            map.put("msg","运行时异常....");
        }else {
            map.put("ex",e.getMessage());
            map.put("msg","其它异常....");
        }
        return map;
    }
}

这种方式是将我们的错误信息进行map保存然后转换为JSON格式输出在页面上

好啦 今天的分享就到这啦  感觉还不错的小伙伴还请三连噢！

文章标签：
数据格式
JSON
Java
前端开发
Spring
关键词：
JSON数据
JSON机制
Spring MVC异常处理机制
Spring MVC机制
JSON springmvc
Love-Java.
目录
相关文章
傻啦嘿哟
|
2天前
|
存储 JSON 数据处理
从JSON数据到Pandas DataFrame：如何解析出所需字段
从JSON数据到Pandas DataFrame：如何解析出所需字段
傻啦嘿哟
14 1
s:103
|
2天前
|
JSON 前端开发 Java
【JavaEE】让“单车变摩托”的神级框架—Spring MVC的深入讲解（下）
【JavaEE】让“单车变摩托”的神级框架—Spring MVC的深入讲解
s:103
6 0
s:103
|
2天前
|
JSON 前端开发 Java
【JavaEE】让“单车变摩托”的神级框架—Spring MVC的深入讲解（上）
【JavaEE】让“单车变摩托”的神级框架—Spring MVC的深入讲解
s:103
5 0
长梦
|
2天前
|
前端开发 Java 测试技术
Java一分钟之Spring MVC：构建Web应用
【5月更文挑战第15天】Spring MVC是Spring框架的Web应用模块，基于MVC模式实现业务、数据和UI解耦。常见问题包括：配置DispatcherServlet、Controller映射错误、视图解析未设置、Model数据传递遗漏、异常处理未配置、依赖注入缺失和忽视单元测试。解决这些问题可提升代码质量和应用性能。注意配置`web.xml`、`@RequestMapping`、`ViewResolver`、`Model`、`@ExceptionHandler`、`@Autowired`，并编写测试用例。
长梦
51 3
宁波阿成.
|
2天前
|
XML JSON API
转Android上基于JSON的数据交互应用
转Android上基于JSON的数据交互应用
宁波阿成.
10 1
qiuqiushuibx
|
2天前
|
设计模式 前端开发 Java
初识Spring MVC
初识Spring MVC
qiuqiushuibx
14 0
Zhangr132
|
2天前
|
前端开发 Java 应用服务中间件
Spring MVC框架概述
Spring MVC 是一个基于Java的轻量级Web框架，采用MVC设计模型实现请求驱动的松耦合应用开发。框架包括DispatcherServlet、HandlerMapping、Handler、HandlerAdapter、ViewResolver核心组件。DispatcherServlet协调这些组件处理HTTP请求和响应，Controller处理业务逻辑，Model封装数据，View负责渲染。通过注解@Controller、@RequestMapping等简化开发，支持RESTful请求。Spring MVC具有清晰的角色分配、Spring框架集成、多种视图技术支持以及异常处理等优点。
Zhangr132
18 1
源码星辰
|
2天前
|
监控 前端开发 Java
SpringBoot与SpringMVC有哪些区别？
SpringBoot和SpringMVC是Java开发中常用的两个框架，它们都是由Spring框架所提供的，但在功能和使用方式上有着一些区别。
源码星辰
23 2
Yeats_Liao
|
2天前
|
JSON JavaScript Java
从前端Vue到后端Spring Boot：接收JSON数据的正确姿势
从前端Vue到后端Spring Boot：接收JSON数据的正确姿势
Yeats_Liao
25 0
众所周知
|
2天前
|
JSON 数据格式 Python
Python标准库中包含了json模块，可以帮助你轻松处理JSON数据
【4月更文挑战第30天】Python的json模块简化了JSON数据与Python对象之间的转换。使用`json.dumps()`可将字典转为JSON字符串，如`{&quot;name&quot;: &quot;John&quot;, &quot;age&quot;: 30, &quot;city&quot;: &quot;New York&quot;}`，而`json.loads()`则能将JSON字符串转回字典。通过`json.load()`从文件读取JSON数据，`json.dump()`则用于将数据写入文件。
众所周知
18 1

热门文章

最新文章

  • 1
    [AIGC] 在Spring Boot中指定请求体格式
  • 2
    Spring Boot整合canal实现数据一致性解决方案解析-部署+实战
  • 3
    [AIGC] Spring框架的基本概念和优势
  • 4
    Spring Security 5.7 最新配置细节（直接就能用），WebSecurityConfigurerAdapter 已废弃
  • 5
    【Spring Boot系列】通过OpenAPI规范构建微服务服务接口
  • 6
    Spring Boot与Camunda的完美融合
  • 7
    第2章 Spring Security 的环境设置与基础配置（2024 最新版）（上）
  • 8
    第5章 Spring Security 的高级认证技术（2024 最新版）（上）
  • 9
    第7章 Spring Security 的 REST API 与微服务安全（2024 最新版）（上）
  • 10
    微服务学习 | Spring Cloud 中使用 Sentinel 实现服务限流
  • 1
    Java 新手如何使用Spring MVC 中的查询字符串和查询参数
    23
  • 2
    10个知识点让你读懂spring MVC容器
    22
  • 3
    基于springMVC的RESTful服务实现
    25
  • 4
    SpringMVC+Mybatis两个数据源实现（二）
    27
  • 5
    SpringMVC+Mybatis两个数据源实现（一）
    28
  • 6
    jquery ajax+spring mvc上传文件
    20
  • 7
    【JavaEE进阶】 关于Spring mvc 响应
    30
  • 8
    SpringMVC Post 404
    13
  • 9
    SpringMVC请求和响应
    44
  • 10
    SpringMVC的架构有什么优势？——异常处理与文件上传（五）
    32

    • 相关课程

    更多
  • Spring Cloud Alibaba Nacos 详解（下）
  • 全面讲解Spring Cloud Alibaba技术栈（知识精讲+项目实战）第一阶段
  • 全面讲解Spring Cloud Alibaba技术栈（知识精讲+项目实战）第二阶段
  • 全面讲解Spring Cloud Alibaba技术栈（知识精讲+项目实战）第三阶段
  • 全面讲解Spring Cloud Alibaba技术栈（知识精讲+项目实战）第四阶段
  • JSON 自学手册图文教程

    • 相关电子书

    更多
  • 云栖社区特邀专家徐雷Java Spring Boot开发实战系列课程（第20讲）：经典面试题与阿里等名企内部招聘求职面试技巧
  • 微服务架构模式与原理Spring Cloud开发实战
  • 阿里特邀专家徐雷Java Spring Boot开发实战系列课程（第18讲）：制作Java Docker镜像与推送到DockerHub和阿里云Docker仓库

    • 相关实验场景

    更多
  • 从零搭建Spring Boot的Hello World
    • 下一篇
    2024年阿里云免费云服务器及学生云服务器申请教程参考