当前位置：首页 > 文章列表 > 文章 > java教程 > Java操作JSON，org.json库入门指南

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

2025-08-26 19:55:37 0浏览收藏

还在为Java中JSON数据的处理烦恼吗？本文将为你详细介绍如何使用org.json库进行JSON数据的解析与生成，org.json作为一个轻量级的JSON处理库，在Java开发中被广泛应用。本文将从Maven依赖引入开始，逐步讲解如何构建JSONObject、解析JSON字符串，以及处理嵌套结构和JSONArray数组。同时，我们还将探讨使用org.json库时需要注意的类型转换、null值处理和格式合法性问题。无论你是JSON数据处理新手还是有一定经验的开发者，都能通过本教程快速掌握org.json库的使用技巧，提升你的Java开发效率。

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

Java中如何操作JSON？org.json库使用指南

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

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

1. 添加依赖

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


    org.json
    json
    20210307

如果不是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 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);