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