JSON-java库使用指南：从基础操作到数据格式转换-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00717/article/details/148523855

JSON-java库使用指南：从基础操作到数据格式转换

JSON-java 项目地址: https://gitcode.com/gh_mirrors/jso/JSON-java

JSON-java是一个功能强大的Java库，专门用于处理JSON数据格式。本文将全面介绍该库的核心功能和使用方法，帮助开发者快速掌握JSON的创建、解析和转换技巧。

一、JSON文档创建方法

1. 使用JSONArray创建

JSONArray是处理JSON数组的核心类，提供两种创建方式：

方法一：从字符串构造

String arrayStr = "[true, false, \"true\", \"false\", \"hello\", 23.45e-4]";
JSONArray array = new JSONArray(arrayStr);

方法二：动态构建

JSONArray array = new JSONArray();
array.put("value");
array.put(5);
array.put(-23.45e67);
array.put(true);

技术要点：

字符串构造时需严格遵循JSON格式规范
动态构建更灵活，适合程序运行时生成JSON
可通过toJSONObject()方法将数组转为对象，需提供对应的键名数组

2. 使用JSONStringer构建

JSONStringer提供流式API，适合构建复杂JSON结构：

JSONStringer jsonStringer = new JSONStringer();
jsonStringer.object()
    .key("name").value("张三")
    .key("age").value(25)
    .key("scores").array()
        .value(89.5).value(92.0).value(88.5)
    .endArray()
.endObject();

优势分析：

链式调用使代码更清晰
自动处理特殊字符转义
支持嵌套结构构建

3. 使用JSONObject直接创建

三种常用方式：

// 方式1：从JSON字符串
JSONObject obj1 = new JSONObject("{\"name\":\"李四\"}");

// 方式2：动态添加
JSONObject obj2 = new JSONObject();
obj2.put("id", 1001);
obj2.put("valid", true);

// 方式3：从Map转换
Map<String, Object> map = new HashMap<>();
map.put("key1", "value1");
map.put("key2", 123);
JSONObject obj3 = new JSONObject(map);

注意事项：

直接put null值会抛出异常
键必须是字符串类型
值可以是多种基本类型或集合类型

二、数据格式转换

1. XML与JSON互转

JSON转XML：

JSONObject jsonObj = new JSONObject("{\"user\":{\"name\":\"王五\"}}");
String xml = XML.toString(jsonObj);
// 输出：<user><name>王五</name></user>

XML转JSON：

String xml = "<student><id>1001</id></student>";
JSONObject json = XML.toJSONObject(xml);

转换规则：

XML标签名转为JSON键名
文本内容转为对应值
属性会转为以@前缀的键

2. Cookie格式处理

JSON转Cookie字符串：

JSONObject cookieJson = new JSONObject();
cookieJson.put("name", "session");
cookieJson.put("value", "abc123");
String cookieStr = Cookie.toString(cookieJson);
// 输出：session=abc123

特殊处理：

自动进行URL编码
忽略布尔值等不支持的类型
分号分隔多个键值对

3. HTTP头转换

HTTP头转JSON：

String header = "Content-Type: application/json\nAccept: */*";
JSONObject headerJson = HTTP.toJSONObject(header);

应用场景：

解析HTTP请求/响应头
构建REST API客户端
网络调试工具开发

4. CDL(逗号分隔列表)处理

CDL格式适合表格数据转换：

String cdl = "name,age\nJohn,30\nJane,25";
JSONArray jsonArray = CDL.toJSONArray(cdl);

特点：

第一行为键名
后续每行对应一条记录
适合与CSV格式互转

5. Properties属性转换

与Java Properties对象互转：

// Properties转JSON
Properties props = new Properties();
props.setProperty("db.url", "localhost");
JSONObject json = Property.toJSONObject(props);

// JSON转Properties
Properties newProps = Property.toProperties(json);

使用场景：