mvc json 乱码_你了解JSON吗？——Jackson、FastJson在SpringMVC中的简单使用

原文参考分享自CSDN：你了解JSON吗？--Jackson、FastJson在SpringMVC中的简单使用_欢迎来到 Baret~H 的博客-CSDN博客

1. 什么是 JSON

JSON（JavaScript Object Notation, JS 对象标记）

是一种轻量级的数据交换格式
采用完全独立于编程语言的文本格式来存储和表示数据。
简洁和清晰的层次结构使得 JSON 成为理想的数据交换语言。
易于人阅读和编写，也易于机器解析和生成，并有效地提升网络传输效率。

在 JavaScript 语言中，一切都是对象。因此，任何JavaScript 支持的类型都可以通过 JSON 来表示，例如字符串、数字、对象、数组等。

2. JSON 语法规则

键值对表示对象，数据由逗号分隔
花括号保存对象
方括号保存数组

JSON 键值对 是用来保存 JavaScript 对象的一种方式

由花括号括起来的逗号分割的成员构成
键值对组合中的键名写在前面并用双引号""包裹，使用冒号 :分隔，然后紧接着值

{"name": "zsr","age": "20","sex": "男"}

3. JSON 与 JS 对象的关系

JSON 是 JavaScript 对象的字符串表示法，它使用文本表示一个 JS 对象的信息，本质是一个字符串。

var obj = {a: 'Hello', b: 'World'}; //这是一个对象，注意键名也是可以使用引号包裹的
var json = '{"a": "Hello", "b": "World"}'; //这是一个 JSON 字符串，本质是一个字符串

4. JSON 和 JS 对象互转

编写一个html页面进行测试

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>test</title>
</head>
<body>
<script type="text/javascript">var user = {name: "zsr",age: 20,sex: "男"};console.log(user);//将js对象转换为json对象var json = JSON.stringify(user);console.log(json);//将json对象转换为js对象var obj = JSON.parse(json);console.log(obj);
</script>
</body>
</html>

运行测试，查看控制台信息：

JSON就是一个字符串，不能展开
JavaScript是一个对象，可以展开

5. 使用Jackson数据交互

Jackson 是一个 Java 的用来处理 JSON 格式数据的类库，性能非常好

当然不止这一个类库，比如还有阿里巴巴的 fastjson 等等。

接下来我们简单介绍一下SpringMVC中Jackson的使用

1、导入依赖

导入Jackson的jar包

<!-- https://mvnrepository.com/artifact/com.fasterxml.jackson.core/jackson-databind -->
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.11.2</version>
</dependency>

2、配置web.xml

配置SpringMVC需要的配置web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"version="4.0"><!--1.注册servlet--><servlet><servlet-name>SpringMVC</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!--通过初始化参数指定SpringMVC配置文件的位置，进行关联--><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:springmvc-servlet.xml</param-value></init-param><!-- 启动顺序，数字越小，启动越早 --><load-on-startup>1</load-on-startup></servlet><!--所有请求都会被springmvc拦截 --><servlet-mapping><servlet-name>SpringMVC</servlet-name><url-pattern>/</url-pattern></servlet-mapping><!--SpringMVC内置过滤器,防止中文乱码--><filter><filter-name>encoding</filter-name><filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class><init-param><param-name>encoding</param-name><param-value>utf-8</param-value></init-param></filter><filter-mapping><filter-name>encoding</filter-name><url-pattern>/</url-pattern></filter-mapping>
</web-app>

3、编写SpringMVC配置文件

springmvc-servlet.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:context="http://www.springframework.org/schema/context"xmlns:mvc="http://www.springframework.org/schema/mvc"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/contexthttps://www.springframework.org/schema/context/spring-context.xsdhttp://www.springframework.org/schema/mvchttps://www.springframework.org/schema/mvc/spring-mvc.xsd"><!-- 自动扫描指定的包，下面所有注解类交给IOC容器管理 --><context:component-scan base-package="controller"/><!-- 视图解析器 --><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"id="internalResourceViewResolver"><!-- 前缀 --><property name="prefix" value="/WEB-INF/jsp/" /><!-- 后缀 --><property name="suffix" value=".jsp" /></bean></beans>

4、编写实体类 (lombok)

编写一个User的实体类，然后我们去编写我们的测试Controller；

package pojo;import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {private String name;private int age;private String sex;
}

5、编写Controller

@Controller
public class UserController {@RequestMapping("/j1")@ResponseBody //它不会走视图解析器,会直接返回一个字符串public String json1() {//创建一个对象User user = new User("zsr", 20, "男");return user.toString();}
}

这里我们使用了@ResponseBody注解，他是配合@Controller使用的，该注解可以使不走视图解析器，而是直接返回一个字符串

同样可以直接将@Controller替换为@RestController，也可以达到不走视图解析器，直接返回字符串的效果，此时就不用使用@ResponseBody注解了

6、运行测试

配置Tomcat，点击运行，访问http://localhost:8080/j1，结果如下

我们并没有通过视图解析器，而是直接返回了字符串

7、转换为JSON格式

如果我们想以json的格式进行输出，除了上述@ResponseBody注解之外，还需要一个objectMapper对象

我们修改上述Controller

@Controller
public class UserController {@RequestMapping("/j1")@ResponseBody //它不会走视图解析器,会直接返回一个字符串public String json1() throws JsonProcessingException {//创建jackson的对象映射器，用来解析数据ObjectMapper mapper = new ObjectMapper();//创建一个对象User user = new User("zsr", 20, "男");//将对象转换成json格式String str = mapper.writeValueAsString(user);//由于@ResponseBody注解，这里会将str转成json格式返回；十分方便return str;}
}

重新运行测试，同行访问http://localhost:8080/j1，成功以json的格式进行显示！

但是还存在乱码问题，我们需要设置一下他的编码格式为utf-8，以及它返回的类型；

这里可以通过@RequestMapping的produces属性来实现，修改下代码

//produces:指定响应体返回类型和编码
@RequestMapping(value = "/json1",produces = "application/json;charset=utf-8")

再次测试，乱码问题得到解决

8、代码优化

1. 乱码问题

上述设置@RequestMapping中produces属性值的方式比较麻烦，如果项目中有多个controller则每一个都要添加

可以通过Spring配置统一指定，在SpringMVC配置文件中加入如下代码即可

<!--json乱码问题配置-->
<mvc:annotation-driven><mvc:message-converters register-defaults="true"><bean class="org.springframework.http.converter.StringHttpMessageConverter"><constructor-arg value="UTF-8"/></bean><bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"><property name="objectMapper"><bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean"><property name="failOnEmptyBeans" value="false"/></bean></property></bean></mvc:message-converters>
</mvc:annotation-driven>

2. 返回json字符串统一解决

上述我们使用了@ResponseBody注解，他是配合@Controller使用的，该注解可以使不走视图解析器，而是直接返回一个字符串

同样可以直接将@Controller替换为@RestController，也可以达到不走视图解析器，直接返回字符串的效果，此时就不用使用@ResponseBody注解了

@RestController
public class UserController {@RequestMapping(value = "/json1")public String json1() throws JsonProcessingException {//创建一个jackson的对象映射器，用来解析数据ObjectMapper mapper = new ObjectMapper();//创建一个对象User user = new User("zsr", 20, "男");//将我们的对象解析成为json格式String str = mapper.writeValueAsString(user);//由于@RestController注解，这里会将str转成json格式返回；十分方便return str;}
}

9、测试集合输出

增加一个新的方法，多个对象的情况下，我们会将其放在一个集合中

@RequestMapping(value = "/j2")
public String json2() throws JsonProcessingException {//创建jackson的对象映射器，用来解析数据ObjectMapper mapper = new ObjectMapper();//创建容器List<User> list = new ArrayList<User>();//创建多个对象User user1 = new User("zsr1", 20, "男");User user2 = new User("zsr2", 20, "男");User user3 = new User("zsr3", 20, "男");User user4 = new User("zsr4", 20, "男");User user5 = new User("zsr5", 20, "男");//将所有对象存入容器list.add(user1);list.add(user2);list.add(user3);list.add(user4);list.add(user5);//将对象转换成json格式String str = mapper.writeValueAsString(list);//由于@RequestMapping注解，这里会将str转成json格式返回；十分方便return str;
}

运行测试，成功将所有对象的信息都以json的形式显示出来

10、输出日期对象

增加一个新的方法，测试日期对象的输出

@RequestMapping(value = "/j3")
public String json3() throws JsonProcessingException {//创建jackson的对象映射器，用来解析数据ObjectMapper mapper = new ObjectMapper();//创建一个日期对象Date date = new Date();//将对象转换为json格式String str = mapper.writeValueAsString(date);//ObjectMapper对时间解析后的默认格式为:Timestamp(时间戳)return str;
}

运行测试，访问http://localhost:8080/j3，手动刷新，可以看到这个数字增长很快

默认日期格式会变成一个数字，是1970年1月1日到当前日期的毫秒数！
Jackson 默认是会把时间转成timestamps形式

如果我们不想以时间戳的方式显示呢？

方式一：我们新增一个方法，自定义日期的格式

@RequestMapping(value = "/j4")
public String json4() throws JsonProcessingException {//创建jackson的对象映射器，用来解析数据ObjectMapper mapper = new ObjectMapper();//创建一个日期对象Date date = new Date();//自定义日期格式SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yy-mm-dd hh:mm:ss");//将对象转换为json格式String str = mapper.writeValueAsString(simpleDateFormat.format(date));return str;
}

运行测试：访问http://localhost:8080/j4，成功按我们规定的格式输出

方式二：取消timestamps形式，自定义时间格式

@RequestMapping(value = "/j5")
public String json5() throws JsonProcessingException {//创建jackson的对象映射器，用来解析数据ObjectMapper mapper = new ObjectMapper();//不使用时间戳的方式mapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);//自定义日期格式SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yy-mm-dd hh:mm:ss");//指定日期格式mapper.setDateFormat(simpleDateFormat);//创建一个日期对象Date date = new Date();//将对象转换为json格式String str = mapper.writeValueAsString(date);return str;
}

运行测试：访问http://localhost:8080/j5，同样成功按我们规定的格式输出

6. 使用FastJson进行数据交互

fastjson.jar是阿里开发的一款专门Java处理JSON开发的包

Fastjson 是一个 Java 库，可以将 Java 对象转换为 JSON 格式，当然它也可以将 JSON 字符串转换为 Java 对象。
Fastjson 可以操作任何 Java 对象，即使是一些预先存在的没有源码的对象。

菜鸟教程：https://www.runoob.com/w3cnote/fastjson-intro.html

Fastjson 源码地址：https://github.com/alibaba/fastjson

Fastjson 中文 Wiki：https://github.com/alibaba/fastjson/wiki/Quick-Start-CN

接下来我们简单介绍一下SpringMVC中fastjson的使用

1. 导入依赖依赖

<!-- https://mvnrepository.com/artifact/com.alibaba/fastjson -->
<dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.73</version>
</dependency>

2. 三个主要的类

JSONObject

代表 json对象

JSONObject实现了Map接口, 猜想 JSONObject底层操作是由Map实现的。
JSONObject对应json对象，通过各种形式的get()方法可以获取json对象中的数据，也可利用诸如size()，isEmpty()等方法获取"键：值"对的个数和判断是否为空。其本质是通过实现Map接口并调用接口中的方法完成的。

JSONArray

代表 json对象数组

内部是有List接口中的方法来完成操作的。

JSON

代表 JSONObject 和 JSONArray 的转化

JSON类源码分析与使用
仔细观察这些方法，主要是实现json对象，json对象数组，javabean对象，json字符串之间的相互转化。

3. 代码测试

新建一个方法，利用fastjson的方法返回json字符串：

@RequestMapping(value = "/j6")
public String json6() throws JsonProcessingException {//创建容器List<User> list = new ArrayList<User>();//创建多个对象User user1 = new User("zsr1", 20, "男");User user2 = new User("zsr2", 20, "男");User user3 = new User("zsr3", 20, "男");User user4 = new User("zsr4", 20, "男");User user5 = new User("zsr5", 20, "男");//将所有对象存入容器list.add(user1);list.add(user2);list.add(user3);list.add(user4);list.add(user5);return JSON.toJSONString(list);
}

运行测试：同样正确显示了结果

4. 常用方法测试代码

这种工具类，我们只需知道了解即可，在使用的时候在根据具体的业务去找对应的实现即可

接下来是几种常用的方法（更多的方法在具体的业务时查找使用即可）

public static void main(String[] args) {//创建容器List<User> list = new ArrayList<User>();//创建多个对象User user1 = new User("zsr1", 20, "男");User user2 = new User("zsr2", 20, "男");User user3 = new User("zsr3", 20, "男");User user4 = new User("zsr4", 20, "男");User user5 = new User("zsr5", 20, "男");//将所有对象存入容器list.add(user1);list.add(user2);list.add(user3);list.add(user4);list.add(user5);//常用代码测试System.out.println("Java对象集合转化为JSON字符串:  "+ JSON.toJSONString(list));System.out.println("Java对象user1转化为JSON字符串:  "+ JSON.toJSONString(user1));System.out.println("JSON字符串转化为Java对象user1:  "+ JSON.parseObject(JSON.toJSONString(user1), User.class));System.out.println("Java对象user1转化为JSON对象:  "+ JSON.toJSON(user1));System.out.println("JSON对象转化为Java对象user1:  "+ JSON.toJavaObject((JSON) JSON.toJSON(user1), User.class));
}

运行结果：