2017-09-17 发布 2020-06-23 更新

高性能JSON框架FastJson的简单使用

总字数: 2.7k字预计阅读: 12分钟

在工作中，经常客服端需要和服务端进行通信，目前很多项目都采用JSON的方式进行数据传输，简单的参数可以通过手动拼接JSON字符串，但如果请求的参数过多，采用手动拼接JSON字符串，出错率就非常大了。并且工作效率也特别低。我在网上看了一些开源的JSON框架，比如Google提供的Gson，Jackson，FastJson等框架。

fastjson

前言

FastJson的介绍:

JSON协议使用方便，越来越流行,JSON的处理器有很多,这里我介绍一下FastJson,FastJson是阿里的开源框架,被不少企业使用,是一个极其优秀的Json框架,Github地址: FastJson

FastJson的特点:

1.FastJson数度快,无论序列化和反序列化,都是当之无愧的fast
2.功能强大(支持普通JDK类包括任意Java Bean Class、Collection、Map、Date或enum)
3.零依赖(没有依赖其它任何类库)

FastJson的简单说明:

FastJson对于json格式字符串的解析主要用到了一下三个类：
1.JSON：fastJson的解析器，用于JSON格式字符串与JSON对象及javaBean之间的转换
2.JSONObject：fastJson提供的json对象
3.JSONArray：fastJson提供json数组对象

还在迷茫和彷徨吗,快上车,老司机带你飞!

FastJson的用法

如果使用Maven,在pom.xml文件加入以下依赖。

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.46</version>
</dependency>

首先定义三个json格式的字符串

// json字符串-简单对象型
private static final String JSON_OBJ_STR = "{\"studentName\":\"lily\",\"studentAge\":12}";
// json字符串-数组类型
private static final String JSON_ARRAY_STR = "[{\"studentName\":\"lily\",\"studentAge\":12},{\"studentName\":\"lucy\",\"studentAge\":15}]";
// 复杂格式json字符串
private static final String COMPLEX_JSON_STR = "{\"teacherName\":\"crystall\",\"teacherAge\":27,\"course\":{\"courseName\":\"english\",\"code\":1270},\"students\":[{\"studentName\":\"lily\",\"studentAge\":12},{\"studentName\":\"lucy\",\"studentAge\":15}]}";

JSON格式字符串与JSON对象之间的转换

json字符串-简单对象型与JSONObject之间的转换

/**
 * json字符串-简单对象型到JSONObject的转换
 */
@Test
public void testJSONStrToJSONObject() {
	JSONObject jsonObject = JSONObject.parseObject(JSON_OBJ_STR);
	System.out.println("studentName:  " + jsonObject.getString("studentName") + ":" + "  studentAge:  " + jsonObject.getInteger("studentAge"));
}

/**
 * JSONObject到json字符串-简单对象型的转换
 */
@Test
public void testJSONObjectToJSONStr() {
	// 已知JSONObject,目标要转换为json字符串
	JSONObject jsonObject = JSONObject.parseObject(JSON_OBJ_STR);
	// 第一种方式
	String jsonString = JSONObject.toJSONString(jsonObject);
	// 第二种方式
	// String jsonString = jsonObject.toJSONString();
	System.out.println(jsonString);
}

json字符串(数组类型)与JSONArray之间的转换

/**
 * json字符串-数组类型到JSONArray的转换
 */
@Test
public void testJSONStrToJSONArray() {
	JSONArray jsonArray = JSONArray.parseArray(JSON_ARRAY_STR);
	// 遍历方式1
	int size = jsonArray.size();
	for (int i = 0; i < size; i++) {
		JSONObject jsonObject = jsonArray.getJSONObject(i);
		System.out.println("studentName:  " + jsonObject.getString("studentName") + ":" + "  studentAge:  " + jsonObject.getInteger("studentAge"));
	}
	// 遍历方式2
	for (Object obj : jsonArray) {
		JSONObject jsonObject = (JSONObject) obj;
		System.out.println("studentName:  " + jsonObject.getString("studentName") + ":" + "  studentAge:  " + jsonObject.getInteger("studentAge"));
	}
}

/**
 * JSONArray到json字符串-数组类型的转换
 */
@Test
public void testJSONArrayToJSONStr() {
	// 已知JSONArray,目标要转换为json字符串
	JSONArray jsonArray = JSONArray.parseArray(JSON_ARRAY_STR);
	// 第一种方式
	String jsonString = JSONArray.toJSONString(jsonArray);
	// 第二种方式
	// String jsonString = jsonArray.toJSONString(jsonArray);
	System.out.println(jsonString);
}

复杂json格式字符串与JSONObject之间的转换

/**
 * 复杂json格式字符串到JSONObject的转换
 */
@Test
public void testComplexJSONStrToJSONObject() {
	JSONObject jsonObject = JSONObject.parseObject(COMPLEX_JSON_STR);
	String teacherName = jsonObject.getString("teacherName");
	Integer teacherAge = jsonObject.getInteger("teacherAge");
	System.out.println("teacherName:  " + teacherName + "   teacherAge:  " + teacherAge);
	JSONObject jsonObjectcourse = jsonObject.getJSONObject("course");
	// 获取JSONObject中的数据
	String courseName = jsonObjectcourse.getString("courseName");
	Integer code = jsonObjectcourse.getInteger("code");
	System.out.println("courseName:  " + courseName + "   code:  " + code);
	JSONArray jsonArraystudents = jsonObject.getJSONArray("students");
	// 遍历JSONArray
	for (Object object : jsonArraystudents) {
		JSONObject jsonObjectone = (JSONObject) object;
		String studentName = jsonObjectone.getString("studentName");
		Integer studentAge = jsonObjectone.getInteger("studentAge");
		System.out.println("studentName:  " + studentName + "   studentAge:  " + studentAge);
	}
}

/**
 * 复杂JSONObject到json格式字符串的转换
 */
@Test
public void testJSONObjectToComplexJSONStr() {
	// 复杂JSONObject,目标要转换为json字符串
	JSONObject jsonObject = JSONObject.parseObject(COMPLEX_JSON_STR);
	// 第一种方式
	// String jsonString = JSONObject.toJSONString(jsonObject);
	// 第二种方式
	String jsonString = jsonObject.toJSONString();
	System.out.println(jsonString);
}

JSON格式字符串与javaBean之间的转换

json字符串-简单对象型与javaBean之间的转换

/**
 * json字符串-简单对象到JavaBean之间的转换
 */
@Test
public void testJSONStrToJavaBeanObj() {
	// 第一种方式
	JSONObject jsonObject = JSONObject.parseObject(JSON_OBJ_STR);
	String studentName = jsonObject.getString("studentName");
	Integer studentAge = jsonObject.getInteger("studentAge");
	// Student student = new Student(studentName, studentAge);
	// 第二种方式,使用TypeReference<T>类,由于其构造方法使用protected进行修饰,故创建其子类
	// Student student = JSONObject.parseObject(JSON_OBJ_STR, new TypeReference<Student>() {});
	// 第三种方式,使用Gson的思想
	Student student = JSONObject.parseObject(JSON_OBJ_STR, Student.class);
	System.out.println(student);
}

/**
 * JavaBean到json字符串-简单对象的转换
 */
@Test
public void testJavaBeanObjToJSONStr() {
	Student student = new Student("lily", 12);
	String jsonString = JSONObject.toJSONString(student);
	System.out.println(jsonString);
}

json字符串-数组类型与javaBean之间的转换

/**
 * json字符串-数组类型到JavaBean_List的转换
 */
@Test
public void testJSONStrToJavaBeanList() {
	// 第一种方式
	JSONArray jsonArray = JSONArray.parseArray(JSON_ARRAY_STR);
	// 遍历JSONArray
	List<Student> students = new ArrayList<Student>();
	Student student = null;
	for (Object object : jsonArray) {
		JSONObject jsonObjectone = (JSONObject) object;
		String studentName = jsonObjectone.getString("studentName");
		Integer studentAge = jsonObjectone.getInteger("studentAge");
		student = new Student(studentName, studentAge);
		students.add(student);
	}
	System.out.println("students:  " + students);
	// 第二种方式,使用TypeReference<T>类,由于其构造方法使用protected进行修饰,故创建其子类
	List<Student> studentList = JSONArray.parseObject(JSON_ARRAY_STR, new TypeReference<ArrayList<Student>>() {
	});
	System.out.println("studentList:  " + studentList);
	// 第三种方式,使用Gson的思想
	List<Student> studentList1 = JSONArray.parseArray(JSON_ARRAY_STR, Student.class);
	System.out.println("studentList1:  " + studentList1);
}

/**
 * JavaBean_List到json字符串-数组类型的转换
 */
@Test
public void testJavaBeanListToJSONStr() {
	Student student = new Student("lily", 12);
	Student studenttwo = new Student("lucy", 15);
	List<Student> students = new ArrayList<Student>();
	students.add(student);
	students.add(studenttwo);
	String jsonString = JSONArray.toJSONString(students);
	System.out.println(jsonString);
}

复杂json格式字符串与与javaBean之间的转换

/**
 * 复杂json格式字符串到JavaBean_obj的转换
 */
@Test
public void testComplexJSONStrToJavaBean() {
	// 第一种方式,使用TypeReference<T>类,由于其构造方法使用protected进行修饰,故创建其子类
	Teacher teacher = JSONObject.parseObject(COMPLEX_JSON_STR, new TypeReference<Teacher>() {
	});
	System.out.println(teacher);
	// 第二种方式,使用Gson思想
	Teacher teacher1 = JSONObject.parseObject(COMPLEX_JSON_STR, Teacher.class);
	System.out.println(teacher1);
}

/**
 * 复杂JavaBean_obj到json格式字符串的转换
 */
@Test
public void testJavaBeanToComplexJSONStr() {
	// 已知复杂JavaBean_obj
	Teacher teacher = JSONObject.parseObject(COMPLEX_JSON_STR, new TypeReference<Teacher>() {
	});
	String jsonString = JSONObject.toJSONString(teacher);
	System.out.println(jsonString);
}

javaBean与json对象间的之间的转换

简单javaBean与json对象之间的转换

/**
 * 简单JavaBean_obj到json对象的转换
 */
@Test
public void testJavaBeanToJSONObject() {
	// 已知简单JavaBean_obj
	Student student = new Student("lily", 12);
	// 方式一
	String jsonString = JSONObject.toJSONString(student);
	JSONObject jsonObject = JSONObject.parseObject(jsonString);
	System.out.println(jsonObject);
	// 方式二
	JSONObject jsonObject1 = (JSONObject) JSONObject.toJSON(student);
	System.out.println(jsonObject1);
}

/**
 * 简单json对象到JavaBean_obj的转换
 */
@Test
public void testJSONObjectToJavaBean() {
	// 已知简单json对象
	JSONObject jsonObject = JSONObject.parseObject(JSON_OBJ_STR);
	// 第一种方式,使用TypeReference<T>类,由于其构造方法使用protected进行修饰,故创建其子类
	Student student = JSONObject.parseObject(jsonObject.toJSONString(), new TypeReference<Student>() {
	});
	System.out.println(student);
	// 第二种方式,使用Gson的思想
	Student student1 = JSONObject.parseObject(jsonObject.toJSONString(), Student.class);
	System.out.println(student1);
}

JavaList与JsonArray之间的转换

/**
 * JavaList到JsonArray的转换
 */
@Test
public void testJavaListToJsonArray() {
	// 已知JavaList
	Student student = new Student("lily", 12);
	Student studenttwo = new Student("lucy", 15);
	List<Student> students = new ArrayList<Student>();
	students.add(student);
	students.add(studenttwo);
	// 方式一
	String jsonString = JSONArray.toJSONString(students);
	JSONArray jsonArray = JSONArray.parseArray(jsonString);
	System.out.println(jsonArray);
	// 方式二
	JSONArray jsonArray1 = (JSONArray) JSONArray.toJSON(students);
	System.out.println(jsonArray1);
}

/**
 * JsonArray到JavaList的转换
 */
@Test
public void testJsonArrayToJavaList() {
	// 已知JsonArray
	JSONArray jsonArray = JSONArray.parseArray(JSON_ARRAY_STR);
	// 第一种方式,使用TypeReference<T>类,由于其构造方法使用protected进行修饰,故创建其子类
	ArrayList<Student> students = JSONArray.parseObject(jsonArray.toJSONString(), new TypeReference<ArrayList<Student>>() {
	});
	System.out.println(students);
	// 第二种方式,使用Gson的思想
	List<Student> students1 = JSONArray.parseArray(jsonArray.toJSONString(), Student.class);
	System.out.println(students1);
}

复杂JavaBean_obj与json对象之间的转换

/**
 * 复杂JavaBean_obj到json对象的转换
 */
@Test
public void testComplexJavaBeanToJSONObject() {
	// 已知复杂JavaBean_obj
	Student student = new Student("lily", 12);
	Student studenttwo = new Student("lucy", 15);
	List<Student> students = new ArrayList<Student>();
	students.add(student);
	students.add(studenttwo);
	Course course = new Course("english", 1270);
	Teacher teacher = new Teacher("crystall", 27, course, students);
	// 方式一
	String jsonString = JSONObject.toJSONString(teacher);
	JSONObject jsonObject = JSONObject.parseObject(jsonString);
	System.out.println(jsonObject);
	// 方式二
	JSONObject jsonObject1 = (JSONObject) JSONObject.toJSON(teacher);
	System.out.println(jsonObject1);
}

/**
 * 复杂json对象到JavaBean_obj的转换
 */
@Test
public void testComplexJSONObjectToJavaBean() {
	// 已知复杂json对象
	JSONObject jsonObject = JSONObject.parseObject(COMPLEX_JSON_STR);
	// 第一种方式,使用TypeReference<T>类,由于其构造方法使用protected进行修饰,故创建其子类
	Teacher teacher = JSONObject.parseObject(jsonObject.toJSONString(), new TypeReference<Teacher>() {
	});
	System.out.println(teacher);
	// 第二种方式,使用Gson的思想
	Teacher teacher1 = JSONObject.parseObject(jsonObject.toJSONString(), Teacher.class);
	System.out.println(teacher1);
}

Fastjson生成json时Null属性不显示

在做json解析时发现，fastjson处理null时，结果会把null的字段以及值给过滤，业务上需要保留null值。直接上代码

举个例子

Map<String, Object> fastJsonMap = new HashMap<String, Object>();
List nullList = null;
List emptyList = new ArrayList();
fastJsonMap.put("num", 1);
fastJsonMap.put("emptyStr", "");
fastJsonMap.put("nullValue", null);
fastJsonMap.put("str", "baidu.com");
fastJsonMap.put("nullList", nullList);
fastJsonMap.put("emptyList", emptyList);

String str = JSONObject.toJSONString(fastJsonMap); 
System.out.println(str);  
//输出结果:{"str":"baidu.com","emptyList":[],"emptyStr":"","num":1}

从输出结果可以看出，null对应的key已经被过滤掉；这明显不是我们想要的结果，这时我们就需要用到fastjson的SerializerFeature序列化属性

也就是这个方法：JSONObject.toJSONString(Object object, SerializerFeature… features)

Fastjson的SerializerFeature序列化属性

SerializerFeature属性

枚举值	解释
QuoteFieldNames	输出key时是否使用双引号,默认为true
WriteMapNullValue	是否输出值为null的字段,默认为false
WriteNullNumberAsZero	数值字段如果为null,输出为0,而非null
WriteNullListAsEmpty	List字段如果为null,输出为[],而非null
WriteNullStringAsEmpty	字符类型字段如果为null,输出为”“,而非null
WriteNullBooleanAsFalse	Boolean字段如果为null,输出为false,而非null

代码

1
2
3

String str = JSONObject.toJSONString(fastJsonMap, SerializerFeature.WriteMapNullValue, SerializerFeature.WriteNullListAsEmpty); 
System.out.println(str);  
//输出结果:{"str":"baidu.com","emptyList":[],"emptyStr":"","num":1,"nullValue":null,"nullList":null}

资料

高性能JSON框架之FastJson的简单使用：https://github.com/zhouxu2016/ALiFastJson
FastJSON官方中文文档：https://github.com/alibaba/fastjson/wiki/Quick-Start-CN
FastJSON 简单使用：https://blog.csdn.net/flysun3344/article/details/54707965
Fastjson API中文版：https://www.w3cschool.cn/fastjson/fastjson-api.html
FastJson简单使用：https://blog.csdn.net/yuanjian19900610/article/details/37737087
FastJson使用示例：https://www.cnblogs.com/hapjin/p/7242218.html

总结

好啦,FastJson的基本用法就介绍完了,送人玫瑰,手留余香,学习使我快乐,分享让大家快乐,欢迎大家点赞收藏噢!

个人微信公众号	技术交流QQ群

本文标题:高性能JSON框架FastJson的简单使用

文章作者:

发布时间:2017-09-17, 22:42:12

最后更新:2020-06-23, 19:27:21

原始链接:http://www.skyheng.com/post/43705.html

许可协议: "署名-非商用-相同方式共享 4.0" 转载请保留原文链接及作者。