阿里巴巴的 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<String> 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<Object> 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 map)
: 向 JSON 对象中添加键值对
public static void putAllExample() {
JSONObject jsonObject = new JSONObject();
JSONObject additionalData = new JSONObject();
additionalData.put("email", "[email protected]");
additionalData.put("phone", "123-456-7890");
jsonObject.putAll(additionalData);
System.out.println(jsonObject.toJSONString());
}
22. size()
: 获取 JSON 对象的元素数量
public static void sizeExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Alice");
jsonObject.put("age", 30);
int size = jsonObject.size();
System.out.println("Size: " + size);
}
23. containsValue(Object value)
: 检查 JSON 对象是否包含指定的值
public static void containsValueExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Bob");
jsonObject.put("age", 35);
boolean containsName = jsonObject.containsValue("Bob");
boolean containsGender = jsonObject.containsValue("Male");
System.out.println("Contains Name: " + containsName);
System.out.println("Contains Gender: " + containsGender);
}
24. keySet()
: 获取 JSON 对象的键集合
public static void keySetExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Charlie");
jsonObject.put("age", 40);
Set<String> keys = jsonObject.keySet();
for (String key : keys) {
System.out.println("Key: " + key);
}
}
25. values()
: 获取 JSON 对象的值集合
public static void valuesExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "David");
jsonObject.put("age", 45);
Collection<Object> values = jsonObject.values();
for (Object value : values) {
System.out.println("Value: " + value);
}
}
26. entrySet()
: 获取 JSON 对象的键值对集合
public static void entrySetExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Eve");
jsonObject.put("age", 50);
Set<java.util.Map.Entry<String, Object>> entrySet = jsonObject.entrySet();
for (java.util.Map.Entry<String, Object> entry : entrySet) {
System.out.println("Key: " + entry.getKey() + ", Value: " + entry.getValue());
}
}
27. putIfAbsent(String key, Object value)
: 如果不存在键,则向 JSON 对象添加键值对
public static void putIfAbsentExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Frank");
jsonObject.putIfAbsent("age", 55); // 添加 "age" 键
jsonObject.putIfAbsent("name", "George"); // 不添加 "name" 键
System.out.println(jsonObject.toJSONString());
}
28. put(String key, Object value)
: 向 JSON 对象添加键值对
public static void putExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Helen");
System.out.println(jsonObject.toJSONString());
}
29. get(Object key)
: 获取 JSON 对象中的属性值
public static void getExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Ian");
jsonObject.put("age", 60);
String name = jsonObject.getString("name");
int age = jsonObject.getIntValue("age");
System.out.println("Name: " + name + ", Age: " + age);
}
30. remove(Object key)
: 从 JSON 对象中删除指定的键
public static void removeExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Jack");
jsonObject.put("age", 65);
jsonObject.remove("age");
System.out.println(jsonObject.toJSONString());
}
31. putOnce(String key, Object value)
: 如果不存在键,则向 JSON 对象添加键值对
public static void putOnceExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "Kathy");
jsonObject.putOnce("age", 70); // 添加 "age" 键
jsonObject.putOnce("name", "Laura"); // 不添加 "name" 键
System.out.println(jsonObject.toJSONString());
}
32. putAll(JSONObject m)
: 将另一个 JSON 对象中的键值对添加到当前 JSON 对象
public static void putAllJSONObjectExample() {
JSONObject jsonObject1 = new JSONObject();
jsonObject1.put("name", "Mike");
JSONObject jsonObject2 = new JSONObject();
jsonObject2.put("age", 75);
jsonObject2.put("email", "[email protected]");
jsonObject1.putAll(jsonObject2);
System.out.println(jsonObject1.toJSONString());
}
33. getInteger(String key)
: 获取 JSON 对象中的整数属性值
public static void getIntegerExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("age", "80"); // 存储为字符串
int age = jsonObject.getInteger("age"); // 解析为整数
System.out.println("Age: " + age);
}
34. getLong(String key)
: 获取 JSON 对象中的长整数属性值
public static void getLongExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("age", "90"); // 存储为字符串
long age = jsonObject.getLong("age"); // 解析为长整数
System.out.println("Age: " + age);
}
35. getShort(String key)
: 获取 JSON 对象中的短整数属性值
public static void getShortExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("age", "100"); // 存储为字符串
short age = jsonObject.getShort("age"); // 解析为短整数
System.out.println("Age: " + age);
}
36. getByte(String key)
: 获取 JSON 对象中的字节属性值
public static void getByteExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("age", "110"); // 存储为字符串
byte age = jsonObject.getByte("age"); // 解析为字节
System.out.println("Age: " + age);
}
37. getFloat(String key)
: 获取 JSON 对象中的浮点数属性值
public static void getFloatExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("height", "175.5"); // 存储为字符串
float height = jsonObject.getFloat("height"); // 解析为浮点数
System.out.println("Height: " + height);
}
38. getDouble(String key)
: 获取 JSON 对象中的双精度浮点数属性值
public static void getDoubleExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("weight", "65.5"); // 存储为字符串
double weight = jsonObject.getDouble("weight"); // 解析为双精度浮点数
System.out.println("Weight: " + weight);
}
39. getBoolean(String key)
: 获取 JSON 对象中的布尔属性值
public static void getBooleanExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("isStudent", "true"); // 存储为字符串
boolean isStudent = jsonObject.getBoolean("isStudent"); // 解析为布尔值
System.out.println("Is Student: " + isStudent);
}
40. getBigDecimal(String key)
: 获取 JSON 对象中的 BigDecimal 属性值
public static void getBigDecimalExample() {
JSONObject jsonObject = new JSONObject();
jsonObject.put("price", "99.99"); // 存储为字符串
java.math.BigDecimal price = jsonObject.getBigDecimal("price"); // 解析为 BigDecimal
System.out.println("Price: " + price);
}