Java工具库——FastJson的40个常用方法
工具库介绍
阿里巴巴的 FastJSON,也被称为 Alibaba FastJSON 或阿里巴巴 JSON,是一个高性能的 Java JSON 处理库,用于在 Java 应用程序中解析和生成 JSON 数据。FastJSON 以其卓越的性能和功能丰富的特点而闻名,并在阿里巴巴的开源项目和其他许多 Java 应用程序中广泛使用。
以下是 FastJSON 的主要特点和功能:
-
高性能: FastJSON 的性能非常出色,它被设计成一种极快的 JSON 库,可以在读取和写入 JSON 数据时实现卓越的性能。这使得 FastJSON 成为处理大量 JSON 数据的理想选择。
-
丰富的功能: FastJSON 提供了丰富的功能,包括将 Java 对象序列化为 JSON 格式和将 JSON 数据解析为 Java 对象。它支持复杂数据类型,包括嵌套对象、集合、数组等。
-
简单易用的 API: FastJSON 提供了简单易用的 API,使开发人员能够轻松地进行 JSON 数据的处理。你可以使用 FastJSON 将对象转换为 JSON 字符串,也可以将 JSON 字符串转换为 Java 对象。
-
自定义序列化和反序列化: FastJSON 允许你自定义如何将 Java 对象序列化为 JSON 数据以及如何将 JSON 数据反序列化为 Java 对象。这可以用于处理特定的数据格式或数据结构。
-
支持标准规范: FastJSON 支持 JSON 规范(RFC 7159),并能够处理 JSON 格式的各种细节,包括转义字符和特殊字符。
-
支持日期格式: FastJSON 具有内置的日期序列化和反序列化功能,可以处理日期数据的格式化和解析。
-
兼容性: FastJSON 兼容 Java 标准库中的 JSON API,如 javax.json,使得迁移或替换其他 JSON 库变得相对容易。
-
广泛应用: FastJSON 在阿里巴巴的许多产品和项目中广泛使用,包括阿里云和淘宝等。
FastJSON 是一个开源项目,你可以在 GitHub 上找到它的源代码和文档。它的活跃社区和持续的维护使其成为一个受欢迎的 JSON 处理库,适用于各种 Java 应用程序,从小型应用到大型分布式系统。
方法列举
FastJSON(阿里巴巴的 JSON 库)提供了大量的方法来处理 JSON 数据。以下是其中一些常用的方法,每个方法都附带了详细解释和示例代码,以及预期的结果。
import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONObject; import com.alibaba.fastjson.JSONArray;
1. toJSONString():将 Java 对象序列化为 JSON 字符串。
public static void toJSONStringExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "John");
jsonObject.put("age", 30);
String jsonString = jsonObject.toJSONString();
System.out.println(jsonString);
}
2. parseObject():将 JSON 字符串解析为 Java 对象。
public static void parseObjectExample() {
String json = "{\"name\":\"Alice\",\"age\":25}";
JSONObject jsonObject = JSON.parseObject(json);
String name = jsonObject.getString("name");
int age = jsonObject.getIntValue("age");
System.out.println("Name: " + name + ", Age: " + age);
}
3. toJSON():将 Java 对象转换为 JSON 对象。
public static void toJSONExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Alice");
jsonObject.put("age", 25);
JSONObject json = (JSONObject) JSON.toJSON(jsonObject);
System.out.println(json.toJSONString());
}
4. parseArray():将 JSON 数组字符串解析为 Java 数组。
public static void parseArrayExample() {
String jsonArray = "[1, 2, 3, 4, 5]";
JSONArray intArray = JSON.parseArray(jsonArray);
int sum = 0;
for (Object num : intArray) {
sum += (int) num;
}
System.out.println("Sum: " + sum);
}
5. toJavaObject():将 JSON 对象转换为指定类型的 Java 对象。
public static class Person {
public String name;
public int age;
}
public static void toJavaObjectExample() {
String json = "{\"name\":\"Bob\",\"age\":28}";
Person person = JSON.toJavaObject(JSON.parseObject(json), Person.class);
System.out.println("Name: " + person.name + ", Age: " + person.age);
}
6. toJSONBytes():将 Java 对象序列化为 JSON 字节数组。
public static void toJSONBytesExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Charlie");
jsonObject.put("age", 35);
byte[] jsonBytes = JSON.toJSONBytes(jsonObject);
String jsonString = new String(jsonBytes);
System.out.println(jsonString);
}
7. toJSONStringWithDateFormat():使用指定日期格式将 Java 对象序列化为 JSON 字符串。
public static void toJSONStringWithDateFormatExample() {
Date today = new Date();
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "David");
jsonObject.put("birthDate", sdf.format(today));
String jsonString = JSON.toJSONStringWithDateFormat(jsonObject, "yyyy-MM-dd");
System.out.println(jsonString);
}
8. toJSONStringWithFilter():使用过滤器将 Java 对象序列化为 JSON 字符串。
public static class Person {
public String name;
public int age;
}
public static void toJSONStringWithFilterExample() {
Person person = new Person();
person.name = "Eve";
person.age = 40;
ValueFilter filter = (object, name, value) -> {
if (name.equals("age")) {
return null; // 不包括 "age" 字段
}
return value;
};
String jsonString = JSON.toJSONString(person, filter);
System.out.println(jsonString);
}
9. parse():将 JSON 字符串解析为通用的 java.lang.Object 对象。
public static void parseExample() {
String json = "{\"name\":\"Frank\",\"age\":45}";
Object object = JSON.parse(json);
if (object instanceof JSONObject) {
JSONObject jsonObject = (JSONObject) object;
String name = jsonObject.getString("name");
int age = jsonObject.getIntValue("age");
System.out.println("Name: " + name + ", Age: " + age);
}
}
10. isValid():检查 JSON 字符串是否合法。
public static void isValidExample() {
String validJson = "{\"name\":\"Grace\",\"age\":50}";
String invalidJson = "{name\":\"Helen\",\"age\":55}";
boolean valid = JSON.isValid(validJson);
boolean invalid = JSON.isValid(invalidJson);
System.out.println("Valid JSON: " + valid);
System.out.println("Invalid JSON: " + invalid);
}
11. getJSONObject():获取 JSON 对象中的子对象。
public static void getJSONObjectExample() {
String json = "{\"person\":{\"name\":\"Ivy\",\"age\":60}}";
JSONObject jsonObject = JSON.parseObject(json);
JSONObject personObject = jsonObject.getJSONObject("person");
String name = personObject.getString("name");
System.out.println("Name: " + name);
}
12. getJSONArray():获取 JSON 对象中的子数组。
public static void getJSONArrayExample() {
String json = "{\"numbers\":[1, 2, 3, 4, 5]}";
JSONObject jsonObject = JSON.parseObject(json);
JSONArray numbersArray = jsonObject.getJSONArray("numbers");
int sum = 0;
for (Object num : numbersArray) {
sum += (int) num;
}
System.out.println("Sum: " + sum);
}
13. merge():合并两个 JSON 对象。
public static void mergeExample() {
String json1 = "{\"name\":\"Jack\"}";
String json2 = "{\"age\":35}";
JSONObject jsonObject1 = JSON.parseObject(json1);
JSONObject jsonObject2 = JSON.parseObject(json2);
jsonObject1.putAll(jsonObject2);
System.out.println(jsonObject1.toJSONString());
}
14. size():获取 JSON 对象或数组的元素数量。
public static void sizeExample() {
String json = "{\"names\":[\"Mary\",\"Nancy\",\"Oliver\"]}";
JSONObject jsonObject = JSON.parseObject(json);
JSONArray namesArray = jsonObject.getJSONArray("names");
int size = namesArray.size();
System.out.println("Array Size: " + size);
}
15. containsKey():检查 JSON 对象是否包含指定的键。
public static void containsKeyExample() {
String json = "{\"name\":\"Peter\",\"age\":70}";
JSONObject
jsonObject = JSON.parseObject(json);
boolean containsAge = jsonObject.containsKey("age");
boolean containsEmail = jsonObject.containsKey("email");
System.out.println("Contains Age: " + containsAge);
System.out.println("Contains Email: " + containsEmail);
}
16. keySet():获取 JSON 对象的键集合。
public static void keySetExample() {
String json = "{\"name\":\"Quincy\",\"age\":75}";
JSONObject jsonObject = JSON.parseObject(json);
Set keys = jsonObject.keySet();
for (String key : keys) {
System.out.println("Key: " + key);
}
}
17. values():获取 JSON 对象的值集合。
public static void valuesExample() {
String json = "{\"name\":\"Rachel\",\"age\":80}";
JSONObject jsonObject = JSON.parseObject(json);
Collection values = jsonObject.values();
for (Object value : values) {
System.out.println("Value: " + value);
}
}
18. remove():从 JSON 对象中删除指定的键。
public static void removeExample() {
String json = "{\"name\":\"Sam\",\"age\":85}";
JSONObject jsonObject = JSON.parseObject(json);
jsonObject.remove("age");
System.out.println(jsonObject.toJSONString());
}
19. clear():清空 JSON 对象中的所有键值对。
public static void clearExample() {
String json = "{\"name\":\"Tom\",\"age\":90}";
JSONObject jsonObject = JSON.parseObject(json);
jsonObject.clear();
System.out.println(jsonObject.toJSONString());
}
20. isEmpty():检查 JSON 对象是否为空。
public static void isEmptyExample() {
JSONObject jsonObject = new JSONObject();
boolean empty = jsonObject.isEmpty();
System.out.println("Is Empty: " + empty);
}
21. putAll(Map

