Java操作JSON，org.json库入门指南

一分耕耘，一分收获！既然都打开这篇《Java操作JSON，org.json库使用教程》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

如何用org.json库解析和生成JSON数据？1. 添加Maven依赖或手动导入jar包；2. 使用JSONObject的put方法构建对象，或通过Map构造；3. 通过构造函数解析JSON字符串，并使用getString、getDouble等方法提取值，先用has判断字段是否存在；4. 使用JSONArray处理数组，嵌套结构通过getJSONObject和getJSONArray实现；5. 注意类型转换、null值处理、格式合法性及不支持复杂映射的问题。

在Java开发中，处理JSON数据是常见的需求，比如接口通信、配置文件读取等。虽然现在有很多JSON库可选，但org.json这个老牌库依然因其简洁和轻量受到一些项目的青睐。

如果你的项目不需要复杂的功能，又不想引入太大的依赖，用org.json是个不错的选择。下面我们就来看看怎么用它来解析和生成JSON数据。

1. 添加依赖

首先你需要确保项目中包含了org.json库。如果你使用的是Maven项目，可以在pom.xml中添加如下依赖：

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20210307</version>
</dependency>

如果不是Maven项目，可以直接去官网或Maven仓库下载jar包，手动导入到项目中。

2. 构建JSON对象（JSONObject）

构建一个JSON对象非常简单，只需要new一个JSONObject实例，然后通过put方法添加键值对：

JSONObject obj = new JSONObject();
obj.put("name", "Alice");
obj.put("age", 25);
obj.put("isStudent", false);

你也可以直接从Map构造：

Map<String, Object> map = new HashMap<>();
map.put("name", "Bob");
map.put("age", 30);

JSONObject obj = new JSONObject(map);

最终输出的JSON字符串就是：

{
  "name": "Bob",
  "age": 30
}

3. 解析JSON字符串

解析一个JSON字符串也很直观，只需要把字符串传给JSONObject的构造函数即可：

String jsonStr = "{\"name\":\"Charlie\",\"score\":89.5}";
JSONObject obj = new JSONObject(jsonStr);

String name = obj.getString("name");     // Charlie
double score = obj.getDouble("score");   // 89.5

注意：如果不确定某个字段是否存在，建议先调用has(key)判断一下，避免抛出异常。

4. 处理嵌套结构和数组（JSONArray）

当遇到嵌套结构或者数组时，可以用JSONObject和JSONArray配合使用。

例如，解析这样一个结构：

{
  "user": {
    "id": 1,
    "tags": ["java", "json", "dev"]
  }
}

对应的Java代码可以这样写：

JSONObject root = new JSONObject(jsonStr);
JSONObject user = root.getJSONObject("user");

int id = user.getInt("id");  // 1
JSONArray tags = user.getJSONArray("tags");

for (int i = 0; i < tags.length(); i++) {
    System.out.println(tags.get(i));  // java, json, dev
}

同样地，你也可以构建嵌套结构：

JSONArray tags = new JSONArray();
tags.put("java").put("json");

JSONObject user = new JSONObject();
user.put("id", 1);
user.put("tags", tags);

JSONObject root = new JSONObject();
root.put("user", user);

5. 常见问题与注意事项

• 类型转换要小心：获取值的时候，要用正确的类型方法，比如getString()、getInt()等，否则会抛出异常。
• null值处理：如果JSON中某个字段为null，调用getXXX()方法也会报错，可以考虑先用isNull(String key)判断。
• 格式必须正确：构造JSONObject时传入的字符串必须是合法的JSON格式，否则会抛出JSONException。
• 不支持泛型或复杂映射：org.json不能自动将JSON映射成Java对象，也不支持复杂的序列化/反序列化功能。

基本上就这些内容了。org.json用起来虽然简单，但功能也相对基础，适合轻量级场景。如果你需要更强大的功能（比如POJO映射、格式美化等），可能更适合用Gson或Jackson这样的库。

本篇关于《Java操作JSON，org.json库入门指南》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！