Java中优雅处理中文JSON：解析与编码全攻略**
在Java开发中,JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，被广泛应用，处理包含中文字符的JSON数据时，开发者常常会遇到字符编码问题，如乱码（“???”、“�”），本文将详细介绍在Java中如何正确解析包含中文的JSON，确保数据在序列化和反序列化过程中保持完整和正确。
核心问题：字符编码
中文JSON解析乱码的根本原因通常是字符编码不一致，常见场景包括：
- JSON字符串本身的编码不是UTF-8：虽然UTF-8是JSON标准推荐编码，但有时源数据可能是GBK、GB2312等其他编码。
- Java读取JSON数据时的编码设置不当：从文件读取或网络请求获取JSON数据时，未正确指定编码为UTF-8。
- JSON库的默认编码配置：某些JSON库在处理字符串时可能有默认编码行为，需要显式配置。
常用JSON库及其中文解析方法
Java中有多种流行的JSON库,如Gson（Google）、Jackson、Fastjson（阿里巴巴）等，下面分别介绍它们如何处理中文JSON。
使用Gson解析中文JSON
Gson是Google开发的一个Java JSON库，使用简单。
核心点：确保在创建Gson实例或读取JSON数据时使用UTF-8编码。
示例代码：
import com.google.gson.Gson;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import java.io.IOException;
import java.io.InputStreamReader;
import java.nio.charset.StandardCharsets;
public class GsonChineseJsonParser {
public static void main(String[] args) {
// 假设jsonFrom某个地方（文件、网络等）获取，这里用字符串模拟
// 注意：这里字符串源码是UTF-8编码
String jsonString = "{\"name\":\"张三\",\"age\":30,\"city\":\"北京\"}";
// 方式一：直接解析字符串（前提是字符串本身编码正确）
Gson gson = new Gson();
User user = gson.fromJson(jsonString, User.class);
System.out.println("Gson直接解析: " + user.getName() + ", " + user.getCity());
// 方式二：从InputStream读取（例如文件或网络响应），必须指定UTF-8编码
// 假设有一个InputStream is 包含JSON数据
/*
try (InputStreamReader reader = new InputStreamReader(is, StandardCharsets.UTF_8)) {
User userFromStream = gson.fromJson(reader, User.class);
System.out.println("Gson从流解析: " + userFromStream.getName());
} catch (IOException e) {
e.printStackTrace();
}
*/
// 方式三：使用JsonParser解析为JsonElement，再提取
JsonParser parser = new JsonParser();
JsonObject jsonObject = parser.parse(jsonString).getAsJsonObject();
String name = jsonObject.get("name").getAsString();
String city = jsonObject.get("city").getAsString();
System.out.println("Gson JsonParser解析: " + name + ", " + city);
}
static class User {
private String name;
private int age;
private String city;
// getters and setters
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public int getAge() { return age; }
public void setAge(int age) { this.age = age; }
public String getCity() { return city; }
public void setCity(String city) { this.city = city; }
@Override
public String toString() {
return "User{" + "name='" + name + '\'' + ", age=" + age + ", city='" + city + '\'' + '}';
}
}
}
关键：InputStreamReader构造函数中明确指定StandardCharsets.UTF_8，这是从流中正确读取中文的关键。
使用Jackson解析中文JSON
Jackson功能强大,性能优异，是许多Java项目的首选。
核心点：同样，确保输入源使用UTF-8编码，并可以配置ObjectMapper的字符编码。
示例代码：
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.core.JsonToken;
import java.io.IOException;
import java.io.StringReader;
public class JacksonChineseJsonParser {
public static void main(String[] args) {
String jsonString = "{\"name\":\"李四\",\"age\":25,\"city\":\"上海\"}";
ObjectMapper objectMapper = new ObjectMapper();
// 可以显式设置ObjectMapper的字符编码（虽然对于字符串解析不是必须，但对于读写文件/流很重要）
// objectMapper.getFactory().setCharacterEncoding(StandardCharsets.UTF_8.name());
try {
// 方式一：直接解析字符串到对象
User user = objectMapper.readValue(jsonString, User.class);
System.out.println("Jackson直接解析: " + user.getName() + ", " + user.getCity());
// 方式二：使用JsonParser进行流式解析（适合大JSON或需要精细控制时）
JsonParser parser = objectMapper.getFactory().createParser(new StringReader(jsonString));
while (parser.nextToken() != JsonToken.END_OBJECT) {
String fieldName = parser.getCurrentName();
if ("name".equals(fieldName)) {
parser.nextToken();
String name = parser.getText();
System.out.println("Jackson JsonParser解析name: " + name);
} else if ("city".equals(fieldName)) {
parser.nextToken();
String city = parser.getText();
System.out.println("Jackson JsonParser解析city: " + city);
}
}
parser.close();
} catch (IOException e) {
e.printStackTrace();
}
}
static class User { // 同上User类
private String name;
private int age;
private String city;
// getters and setters
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public int getAge() { return age; }
public void setAge(int age) { this.age = age; }
public String getCity() { return city; }
public void setCity(String city) { this.city = city; }
@Override
public String toString() {
return "User{" + "name='" + name + '\'' + ", age=" + age + ", city='" + city + '\'' + '}';
}
}
}
关键：ObjectMapper默认处理UTF-8，当从InputStream或Reader读取时，确保它们是用UTF-8编码创建的。JsonParser提供了更底层的访问方式，getText()方法会正确处理编码。
使用Fastjson解析中文JSON
Fastjson是阿里巴巴开源的JSON库,以其简洁的API和较高的性能著称。
核心点：Fastjson在处理中文时，通常对UTF-8有良好支持，但仍需注意数据源编码。
示例代码：
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.parser.ParserConfig;
public class FastjsonChineseJsonParser {
public static void main(String[] args) {
String jsonString = "{\"name\":\"王五\",\"age\":28,\"city\":\"广州\"}";
// 方式一：直接解析字符串到对象
User user = JSON.parseObject(jsonString, User.class);
System.out.println("Fastjson直接解析: " + user.getName() + ", " + user.getCity());
// 方式二：解析为JSONObject，再提取字段
JSONObject jsonObject = JSON.parseObject(jsonString);
String name = jsonObject.getString("name");
String city = jsonObject.getString("city");
System.out.println("Fastjson JSONObject解析: " + name + ", " + city);
// 如果需要处理非UTF-8编码的JSON字符串（例如GBK），可以先转换编码
// String gbkJsonString = new String(jsonString.getBytes(StandardCharsets.ISO_8859_1), StandardCharsets.GBK);
// 然后再用Fastjson解析，但通常推荐源数据就是UTF-8
}
static class User { // 同上User类
private String name;
private int age;
private String city;
// getters and setters
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public int getAge() { return age; }
public void setAge(int age) { this.age = age; }
public String getCity() { return city; }
public void setCity(String city) { this.city = city; }
@Override
public String toString() {
return "User{" + "name='" + name + '\'' + ", age=" + age + ", city='" + city + '\'' + '}';
}
}
}
关键：Fastjson默认使用UTF-8编码，如果遇到其他编码的JSON字符串，需要先将其转换为UTF-8再进行解析。
通用最佳实践
- 统一使用UTF-8编码：
还没有评论，来说两句吧...