SpringMVC之JSON返回&异常处理机制

简介: SpringMVC之JSON返回&异常处理机制

一.JSON

1.1.介绍

JSON(JavaScript Object Notation)是一种轻量级的数据交换格式,旨在易于阅读和编写,同时也易于解析和生成。它由 Douglas Crockford 在 2001 年创造,并逐渐成为一种通用格式。


JSON 使用键值对的方式组织数据,可以表示简单的数据类型(如字符串、数值、布尔值和空值),以及复杂的数据类型(如对象和数组)。


以下是 JSON 的一些特点和优势:


  1. 简洁清晰:JSON 使用简单的键值对结构,易于理解和编写。
  2. 可读性强:JSON 数据可以很容易地被人类阅读和理解,也便于调试和排查问题。
  3. 平台无关性:JSON 是一种独立于编程语言和平台的通用数据格式,可以在不同的环境中进行数据交换。
  4. 跨语言交互:由于 JSON 的普及,几乎所有的编程语言都支持 JSON 的解析和生成,使得不同语言之间的数据交互更加便捷。
  5. 支持复杂结构:JSON 可以嵌套表示复杂的数据结构,例如对象中嵌套对象、数组中嵌套数组等。
  6. 轻量高效:JSON 的数据量通常比 XML 更小,解析速度更快。


简单来说:


JSON 在 Web 开发中得到广泛应用,特别是与前端进行数据交互,例如通过 AJAX 请求获取或发送 JSON 数据。同时,也被用作配置文件、日志记录、API 接口的数据传输等场景。在大多数编程语言中,都有现成的库或工具,能够方便地处理 JSON 数据。

1.2.SpringMVC之JSON数据返回

1.2.1.导入依赖

<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> 

1.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>

1.2.3.@ResponseBody注解使用

@ResponseBody 注解是 Spring MVC 框架中的一个注解,用于指示某个方法的返回值应该直接作为响应体返回,而不是视图名称或模型对象。它常用于 RESTful API 开发,将方法的返回值直接序列化为 JSON 或其他格式的数据返回给客户端。

JsonController:

package com.junlinyi.web;
import com.junlinyi.biz.WorkBiz;
import com.junlinyi.model.Work;
import com.junlinyi.utils.PageBean;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
/**
 * @author junlinyi
 * @site www.junlinyi.com
 * @company 君氏集团
 * @create  2022-08-17 9:41
 */
@Controller
@RequestMapping("/work/json")
public class JsonController {
    @Autowired
    private WorkBiz workBiz;
    /**
     * 返回List<T>
     *
     * @param req
     * @param work
     * @return
     */
    @ResponseBody
    @RequestMapping("/list")
    public List<Work> list(HttpServletRequest req, Work work) {
        PageBean pageBean = new PageBean();
        pageBean.setRequest(req);
        List<Work> lst = this.workBiz.listPager(work, pageBean);
        return lst;
    }
    /**
     * 返回T
     *
     * @param req
     * @param work
     * @return
     */
    @ResponseBody
    @RequestMapping("/load")
    public Work load(HttpServletRequest req, Work work) {
        if (work.getDid() != null) {
            List<Work> lst = this.workBiz.listPager(work, null);
            return lst.get(0);
        }
        return null;
    }
    /**
     * 返回List<Map>
     *
     * @param req
     * @param work
     * @return
     */
    @ResponseBody
    @RequestMapping("/mapList")
    public List<Map> mapList(HttpServletRequest req, Work work) {
        PageBean pageBean = new PageBean();
        pageBean.setRequest(req);
        List<Map> lst = this.workBiz.mapListPager(work, pageBean);
        return lst;
    }
    /**
     * 返回Map
     *
     * @param req
     * @param work
     * @return
     */
    @ResponseBody
    @RequestMapping("/mapLoad")
    public Map mapLoad(HttpServletRequest req, Work work) {
        if (work.getDid() != null) {
            List<Map> lst = this.workBiz.mapListPager(work, null);
            return lst.get(0);
        }
        return null;
    }
    @ResponseBody
    @RequestMapping("/all")
    public Map all(HttpServletRequest req, Work work) {
        PageBean pageBean = new PageBean();
        pageBean.setRequest(req);
        List<Work> lst = this.workBiz.listPager(work, pageBean);
        Map map = new HashMap();
        map.put("lst", lst);
        map.put("pageBean", pageBean);
        return map;
    }
    @ResponseBody//返回单个字符串,而不是页面
    @RequestMapping("/jsonStr")
    public String jsonStr(HttpServletRequest req, Work work) {
        return "workEdit";
    }
}

在WorkBizImpl加入以下代码:

@Override
    public List<Map> mapListPager(Work work, PageBean pagebean) {
        return workMapper.mapListPager(work);
    }

在mapper.xml加入代码:

<select id="mapListPager" resultType="java.util.Map"  parameterType="com.junlinyi.model.Work" >
    select
    <include refid="Base_Column_List" />
    from t_work_gz
    <where>
      <if test="dname != null">
        and dname like concat('%',#{dname},'%')
      </if>
    </where>
  </select>

在WorkBiz加入代码:

List<Map> mapListPager(Work work, PageBean pagebean);

在WorkMapper加入代码:

List<Map> mapListPager(Work work);

所有方法 效果测试从上至下:

把所有的@ResponseBody注释掉,我只测试了最后一个:直接跳页面workEdit.jsp:其它的有兴趣的话可以去玩一下哦

把所有的@ResponseBody注释掉,写在上面跟分开写效果一样:

然而@ResponseBody  @Controller 这两个可以合成一个 @RestController同样一样返回的是JOSN数据

1.2.4.常用注解

1699602197185.png

在Work中属性加入@JsonIgnore可以影藏该属性的JOSN数据:

效果:改图可以看出该属性dtp已经影藏了

二.统一异常处理

2.1.为什么要全局异常处理

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

2.2.异常处理思路

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

2.2.异常处理方式一

首现我们自己在所建立方法中随便写一个错,方便我们来测试看你怎么玩如图:

将以下代码加入到spring-mvc.xml中:


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

 <!-- 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>

建立 error.jsp:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
错误信息界面。。。
${ex}
</body>
</html>

测试:

2.3.异常处理方式二

也是一样我们自己在所建立方法中随便写一个错,方便我们来测试,看你怎么玩如图:

代码:

package com.junlinyi.exception;
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 com.junlinyi.component;
import com.junlinyi.exception.GlobalException;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@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");// WEB_INF/jsp/error.jsp
        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","运行时异常....");
        }else{
            mv.addObject("ex",e.getMessage());
            mv.addObject("msg","其它时异常....");
        }
        return mv;
    }
}

效果图:


2.4.异常处理方式三

新建立异常类代码:

package com.junlinyi.component;
import com.junlinyi.exception.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 {
//    跳转错误页面
//    @ExceptionHandler
//    public ModelAndView handler(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;
//    }
// 返回错误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;
    }
}

效果图:

注释的代码效果跟异常处理方式二一样

好啦,今天的分享就到这了,希望能够帮到你呢!😊😊  

目录
相关文章
|
1月前
|
JSON 前端开发 Java
SSM:SpringMVC
本文介绍了SpringMVC的依赖配置、请求参数处理、注解开发、JSON处理、拦截器、文件上传下载以及相关注意事项。首先,需要在`pom.xml`中添加必要的依赖,包括Servlet、JSTL、Spring Web MVC等。接着,在`web.xml`中配置DispatcherServlet,并设置Spring MVC的相关配置,如组件扫描、默认Servlet处理器等。然后,通过`@RequestMapping`等注解处理请求参数,使用`@ResponseBody`返回JSON数据。此外,还介绍了如何创建和配置拦截器、文件上传下载的功能,并强调了JSP文件的放置位置,避免404错误。
|
1月前
|
前端开发 Java 应用服务中间件
【Spring】Spring MVC的项目准备和连接建立
【Spring】Spring MVC的项目准备和连接建立
57 2
|
2月前
|
缓存 前端开发 Java
【Java面试题汇总】Spring,SpringBoot,SpringMVC,Mybatis,JavaWeb篇(2023版)
Soring Boot的起步依赖、启动流程、自动装配、常用的注解、Spring MVC的执行流程、对MVC的理解、RestFull风格、为什么service层要写接口、MyBatis的缓存机制、$和#有什么区别、resultType和resultMap区别、cookie和session的区别是什么?session的工作原理
【Java面试题汇总】Spring,SpringBoot,SpringMVC,Mybatis,JavaWeb篇(2023版)
|
1月前
|
XML 前端开发 Java
Spring,SpringBoot和SpringMVC的关系以及区别 —— 超准确,可当面试题!!!也可供零基础学习
本文阐述了Spring、Spring Boot和Spring MVC的关系与区别,指出Spring是一个轻量级、一站式、模块化的应用程序开发框架,Spring MVC是Spring的一个子框架,专注于Web应用和网络接口开发,而Spring Boot则是对Spring的封装,用于简化Spring应用的开发。
123 0
Spring,SpringBoot和SpringMVC的关系以及区别 —— 超准确,可当面试题!!!也可供零基础学习
|
2月前
|
XML 缓存 前端开发
springMVC02,restful风格,请求转发和重定向
文章介绍了RESTful风格的基本概念和特点,并展示了如何使用SpringMVC实现RESTful风格的请求处理。同时,文章还讨论了SpringMVC中的请求转发和重定向的实现方式,并通过具体代码示例进行了说明。
springMVC02,restful风格,请求转发和重定向
|
1月前
|
XML 存储 前端开发
手动开发-实现SpringMVC底层机制--小试牛刀
手动开发-实现SpringMVC底层机制--小试牛刀
14 0
|
3月前
|
Java 数据库连接 Spring
后端框架入门超详细 三部曲 Spring 、SpringMVC、Mybatis、SSM框架整合案例 【爆肝整理五万字】
文章是关于Spring、SpringMVC、Mybatis三个后端框架的超详细入门教程,包括基础知识讲解、代码案例及SSM框架整合的实战应用,旨在帮助读者全面理解并掌握这些框架的使用。
后端框架入门超详细 三部曲 Spring 、SpringMVC、Mybatis、SSM框架整合案例 【爆肝整理五万字】
|
3月前
|
XML JSON 数据库
SpringMVC入门到实战------七、RESTful的详细介绍和使用 具体代码案例分析(一)
这篇文章详细介绍了RESTful的概念、实现方式,以及如何在SpringMVC中使用HiddenHttpMethodFilter来处理PUT和DELETE请求,并通过具体代码案例分析了RESTful的使用。
SpringMVC入门到实战------七、RESTful的详细介绍和使用 具体代码案例分析(一)
|
3月前
|
前端开发 应用服务中间件 数据库
SpringMVC入门到实战------八、RESTful案例。SpringMVC+thymeleaf+BootStrap+RestFul实现员工信息的增删改查
这篇文章通过一个具体的项目案例,详细讲解了如何使用SpringMVC、Thymeleaf、Bootstrap以及RESTful风格接口来实现员工信息的增删改查功能。文章提供了项目结构、配置文件、控制器、数据访问对象、实体类和前端页面的完整源码,并展示了实现效果的截图。项目的目的是锻炼使用RESTful风格的接口开发,虽然数据是假数据并未连接数据库,但提供了一个很好的实践机会。文章最后强调了这一章节主要是为了练习RESTful,其他方面暂不考虑。
SpringMVC入门到实战------八、RESTful案例。SpringMVC+thymeleaf+BootStrap+RestFul实现员工信息的增删改查
|
3月前
|
JSON 前端开发 Java
Spring MVC返回JSON数据
综上所述,Spring MVC提供了灵活、强大的方式来支持返回JSON数据,从直接使用 `@ResponseBody`及 `@RestController`注解,到通过配置消息转换器和异常处理器,开发人员可以根据具体需求选择合适的实现方式。
167 4
下一篇
无影云桌面