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

构建健壮的Spring MVC应用：JSON响应与异常处理

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

1. 引言

探讨Spring MVC中关键的JSON数据返回和异常处理机制。

2. JSON

2.1 了解JSON数据格式


JSON（JavaScript Object Notation）作为一种数据交换格式具有许多特点和优势，这些特点使其成为广泛应用于Web和应用程序开发的理想选择。下面详细解释了JSON的特点和优势：

1. 轻量级和可读性


  • JSON是一种轻量级的文本格式，其数据结构以键-值对（key-value pairs）的形式表示，易于理解和阅读。
  • 与XML等其他数据格式相比，JSON更加简洁，不包含繁琐的标签和属性，使数据在传输和存储时更为紧凑。


2. 易于编写和解析


  • JSON数据的编写和解析在多种编程语言中都有成熟的支持和库，因此开发人员可以轻松地生成和解析JSON数据。
  • 多数现代编程语言都提供了内置的JSON解析器和生成器，使得操作JSON数据变得非常简单。


3. 自描述性


  • JSON数据包含字段名和相应的值，使得数据的结构和含义变得明确。
  • 数据结构本身包含在数据中，不需要额外的元数据或模式定义。



4. 支持多种数据类型

  • JSON支持多种基本数据类型，包括字符串、数字、布尔值、数组和对象（嵌套的键-值对结构）。
  • 这种灵活性允许开发人员表示各种复杂的数据结构。


5. 平台无关性

  • JSON是一种独立于平台的数据格式，可在各种操作系统和编程语言之间自由交换。
  • 这种特性使得不同技术栈的应用程序能够轻松地共享和解释JSON数据。


6. 易于集成

  • JSON适用于Web服务、API和数据交换，因此它是构建分布式系统和跨平台应用程序的理想选择。
  • 多数Web浏览器都原生支持JSON，使其成为前后端通信的常用数据格式。



7. 社区支持和标准化

  • JSON已成为Web应用程序中的事实标准，得到了广泛的社区支持。
  • 它的标准规范由RFC 8259定义，这进一步巩固了其在数据交换中的地位。


总的来说，JSON作为一种数据交换格式具有轻量级、可读性强、易于编写和解析、自描述、跨平台、灵活支持多种数据类型等优势。这些特点使得JSON在Web开发、API设计、数据交换以及分布式系统中都广泛应用，并且在不同领域的应用中表现出色。


2.2 Spring MVC中的JSON

导入依赖

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


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


使用@ResponseBody注解

package com.liao.controller;
import com.liao.biz.UserBiz;
import com.liao.model.User;
import com.liao.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;
@Controller
@RequestMapping("/user/json")
public class JsonController {
    @Autowired
    private UserBiz userBiz;
    @ResponseBody
    @RequestMapping("/list")
    public List<User> list(HttpServletRequest req, User user){
        PageBean pageBean = new PageBean();
        pageBean.setRequest(req);
        List<User> lst = this.userBiz.listPager(user, pageBean);
        System.out.println(1 / 0);
        return lst;
    }
    @ResponseBody
    @RequestMapping("/load")
    public User load(HttpServletRequest req, User user){
        if(user.getId() != null){
            List<User> lst = this.userBiz.listPager(user, null);
            return lst.get(0);
        }
        return null;
    }
    @ResponseBody
    @RequestMapping("/mapList")
    public List<Map> mapList(HttpServletRequest req, User user){
        PageBean pageBean = new PageBean();
        pageBean.setRequest(req);
        List<Map> lst = this.userBiz.mapListPager(user, pageBean);
        return lst;
    }
    @ResponseBody
    @RequestMapping("/mapLoad")
    public Map mapLoad(HttpServletRequest req, User user){
        if(user.getId() != null){
            List<Map> lst = this.userBiz.mapListPager(user, null);
            return lst.get(0);
        }
        return null;
    }
    @ResponseBody
    @RequestMapping("/all")
    public Map all(HttpServletRequest req, User user){
        PageBean pageBean = new PageBean();
        pageBean.setRequest(req);
        List<User> lst = this.userBiz.listPager(user, pageBean);
        Map map = new HashMap();
        map.put("lst",lst);
        map.put("pageBean",pageBean);
        return map;
    }
    @ResponseBody//
    @RequestMapping("/jsonStr")
    public String jsonStr(HttpServletRequest req, User user){
        return "userEdit";
    }
}

3. 高效处理异常

3.1 异常处理的必要性


Web应用程序需要有效的异常处理机制，因为异常是在应用程序运行过程中不可避免的情况，可以发生各种错误和异常情况，包括但不限于以下原因：


运行时错误： 应用程序可能会遇到运行时错误，例如空指针异常、数据库连接失败、文件不存在等。这些错误通常无法在编译时预测，但需要在运行时进行处理。


外部输入不可控： Web应用程序通常受到来自外部用户或其他系统的输入。用户可能会提供不正确或恶意的输入数据，这可能导致应用程序出现异常。有效的异常处理可以防止这些异常影响应用程序的稳定性和安全性。


资源不足或不可用： 在运行过程中，应用程序可能会遇到资源不足的情况，如数据库连接池用尽、磁盘空间耗尽等。这些情况需要适当的异常处理以避免应用程序崩溃。


网络通信问题： Web应用程序通常需要与其他系统或服务进行通信，这可能会导致网络故障或超时。有效的异常处理可以帮助应用程序优雅地处理这些问题。


业务逻辑异常： 有时应用程序需要捕获和处理与业务逻辑相关的异常情况，例如用户试图执行无权限操作、购物车中的商品数量超出库存等。


以下是为什么需要有效的异常处理机制的一些理由：


稳定性： 有效的异常处理可以帮助应用程序保持稳定性，避免崩溃或不可预测的行为。它可以使应用程序在出现异常情况时恢复正常状态或提供适当的错误信息。


安全性： 适当的异常处理可以增强应用程序的安全性，防止攻击者利用异常情况来获得敏感信息或执行恶意操作。


用户友好性： 异常处理应该提供有意义的错误消息，以便最终用户能够理解问题并采取适当的措施。这有助于提供更好的用户体验。


日志和监控： 通过异常处理，应用程序可以记录异常情况，以便开发人员能够诊断和解决问题。此外，它还可以用于监控应用程序的运行状况。


总之，有效的异常处理机制是确保Web应用程序稳定、安全且用户友好的关键组成部分。通过捕获、处理和记录异常，开发人员可以更好地管理和维护应用程序。


3.2.SpringMVC异常分类


使用Spring MVC提供的简单异常处理器SimpleMappingExceptionResolver；

实现Spring的异常处理接口HandlerExceptionResolver自定义自己的异常处理器；

使用@ControllerAdvice + @ExceptionHandler

综合案例

异常处理方式一

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>

前端异常页面

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


a9cdd7c3d13349779fccacc3ac1302c8.png


异常处理方式二

创建一个名为GlobalException的自定义异常类

GlobalException

1.package com.liao.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);
    }
}


GlobalExceptionHandler

GlobalExceptionHandler实现HandlerExceptionResolver接口

package com.liao.component;
import com.liao.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");//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","运行时异常....");
        }
        return mv;
    }
}


测试：

异常处理方式三

@ControllerAdvice + @ExceptionHandler

package com.liao.component;
import com.liao.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;
    }
}


文章标签：
云解析DNS
数据格式
JSON
前端开发
Java
Spring
关键词：
Spring构建
Spring应用
Spring MVC
Spring异常处理
Spring json
Ar.小白
目录
相关文章
糊涂糊涂123
|
3月前
|
JSON Java 数据库
第08课：Spring Boot中的全局异常处理
第08课：Spring Boot中的全局异常处理
糊涂糊涂123
489 0
Quan_Chen
|
7月前
|
JSON Java 数据格式
微服务——SpringBoot使用归纳——Spring Boot中的全局异常处理——处理系统异常
本文介绍了在Spring Boot项目中如何通过创建`GlobalExceptionHandler`类来全局处理系统异常。通过使用`@ControllerAdvice`注解，可以拦截项目中的各种异常，并结合`@ExceptionHandler`注解针对特定异常（如参数缺失、空指针等）进行定制化处理。文中详细展示了处理参数缺失异常和空指针异常的示例代码，并说明了通过拦截`Exception`父类实现统一异常处理的方法。虽然拦截`Exception`可一劳永逸，但为便于问题排查，建议优先处理常见异常，最后再兜底处理未知异常，确保返回给调用方的信息友好且明确。
Quan_Chen
850 0
微服务——SpringBoot使用归纳——Spring Boot中的全局异常处理——处理系统异常
Quan_Chen
|
7月前
|
JSON Java 数据格式
微服务——SpringBoot使用归纳——Spring Boot中的全局异常处理——拦截自定义异常
本文介绍了在实际项目中如何拦截自定义异常。首先，通过定义异常信息枚举类 `BusinessMsgEnum`，统一管理业务异常的代码和消息。接着，创建自定义业务异常类 `BusinessErrorException`，并在其构造方法中传入枚举类以实现异常信息的封装。最后，利用 `GlobalExceptionHandler` 拦截并处理自定义异常，返回标准的 JSON 响应格式。文章还提供了示例代码和测试方法，展示了全局异常处理在 Spring Boot 项目中的应用价值。
Quan_Chen
286 0
Quan_Chen
|
7月前
|
JSON Java 数据格式
微服务——SpringBoot使用归纳——Spring Boot中的全局异常处理——定义返回的统一 json 结构
本课主要讲解Spring Boot中的全局异常处理方法。在项目开发中，各层操作难免会遇到各种异常，若逐一处理将导致代码耦合度高、维护困难。因此，需将异常处理从业务逻辑中分离，实现统一管理与友好反馈。本文通过定义一个简化的JsonResult类（含状态码code和消息msg），结合全局异常拦截器，展示如何封装并返回标准化的JSON响应，从而提升代码质量和用户体验。
Quan_Chen
148 0
潜意识Java
|
9月前
|
JSON 小程序 UED
微信小程序 app.json 配置文件解析与应用
本文介绍了微信小程序中 `app.json` 配置文件的详细
潜意识Java
1275 12
奔跑的数据
|
12月前
|
数据采集 JSON 数据处理
抓取和分析JSON数据：使用Python构建数据处理管道
在大数据时代，电商网站如亚马逊、京东等成为数据采集的重要来源。本文介绍如何使用Python结合代理IP、多线程等技术，高效、隐秘地抓取并处理电商网站的JSON数据。通过爬虫代理服务，模拟真实用户行为，提升抓取效率和稳定性。示例代码展示了如何抓取亚马逊商品信息并进行解析。
奔跑的数据
253 1
抓取和分析JSON数据：使用Python构建数据处理管道
wljslmz
|
11月前
|
开发框架 Java UED
如何使用 Spring Boot 实现异常处理
如何使用 Spring Boot 实现异常处理
wljslmz
424 2
2的n次方_
|
12月前
|
JSON 前端开发 Java
Spring MVC——获取参数和响应
本文介绍了如何在Spring框架中通过不同的注解和方法获取URL参数、上传文件、处理cookie和session、以及响应不同类型的数据。具体内容包括使用`@PathVariable`获取URL中的参数，使用`MultipartFile`上传文件，通过`HttpServletRequest`和`@CookieValue`获取cookie，通过`HttpSession`和`@SessionAttribute`获取session，以及如何返回静态页面、HTML代码片段、JSON数据，并设置HTTP状态码和响应头。
2的n次方_
206 1
Spring MVC——获取参数和响应
陌陌谣
|
11月前
|
存储 JSON 监控
公司用什么软件监控电脑：JSON 在监控信息交互中的应用探索
在现代企业管理中，电脑监控软件广泛应用于保障信息安全和提升工作效率。JSON（JavaScript Object Notation）因其简洁和易读性，在监控信息的收集、传输和处理中扮演着关键角色。本文介绍了 JSON 在监控数据结构、信息传输及服务器端处理中的具体应用，展示了其在高效监控系统中的重要性。
陌陌谣
116 0
土木林森
|
前端开发 安全 Java
技术进阶：使用Spring MVC构建适应未来的响应式Web应用
【9月更文挑战第2天】随着移动设备的普及，响应式设计至关重要。Spring MVC作为强大的Java Web框架，助力开发者创建适应多屏的应用。本文推荐使用Thymeleaf整合视图，通过简洁的HTML代码提高前端灵活性；采用`@ResponseBody`与`Callable`实现异步处理，优化应用响应速度；运用`@ControllerAdvice`统一异常管理，保持代码整洁；借助Jackson简化JSON处理；利用Spring Security增强安全性；并强调测试的重要性。遵循这些实践，将大幅提升开发效率和应用质量。
土木林森
152 7

热门文章

最新文章

  • 1
    Python采集淘宝评论API接口及JSON数据返回全流程指南
  • 2
    淘宝拍立淘按图搜索与商品详情API的JSON数据返回详解
  • 3
    从JSON到Protobuf，深入序列化方案的选型与原理
  • 4
    干货，淘宝拍立淘按图搜索，淘宝API（json数据返回）
  • 5
    淘宝API对接系列：商品详情与评论数据分析（JSON数据返回）
  • 6
    多语言实时数据微店商品详情API：技术实现与JSON数据解析指南
  • 7
    干货满满！淘宝商品详情数据，淘宝API（json数据返回）
  • 8
    淘宝商品评论API接口概述，json数据返回
  • 9
    干货！电商API接口（淘宝商品评论）json数据返回
  • 10
    多语言实时数据淘宝商品评论API：技术实现与JSON数据解析指南
  • 1
    SpringMVC（四）【SSM 整合、统一结果封装、异常处理、前后台协议联调】（3）
    112
  • 2
    SpringMVC（四）【SSM 整合、统一结果封装、异常处理、前后台协议联调】（2）
    158
  • 3
    SpringMVC（四）【SSM 整合、统一结果封装、异常处理、前后台协议联调】（1）
    139
  • 4
    蓝易云 - SpringMVC3的ResponseBody返回字符串乱码问题解决
    77
  • 5
    Java SpringMVC实现PC端网页微信扫码支付完整版
    535
  • 6
    学习 SpringMVC 必备的 4 大知识点
    77
  • 7
    利用Spring MVC开发程序2
    114
  • 8
    利用Spring MVC开发程序1
    111
  • 9
    SpringMVC-登录验证判断
    78
  • 10
    SpringMVC知识点
    94

    • 相关课程

    更多
  • 精通Spring Cloud Alibaba
  • 微服务框架 Spring Cloud 快速入门
  • Java Web开发系列课程 - Spring框架入门
  • JSON 自学手册图文教程
  • Spring Boot 2.5.x开发实战
  • Spring Cloud微服务架构设计与开发实战

    • 相关电子书

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