
本文详细介绍了如何在Java中利用Gson库解析NDJSON(换行符分隔的JSON)文件,以读取并映射文件中的所有独立JSON记录到对应的DTO对象列表中。针对一次性只能读取一个记录的问题,文章提出了基于JsonReader的循环读取策略,并强调了reader.peek()方法在判断文件末尾时的关键作用,同时提供了完整的示例代码和重要注意事项。
理解NDJSON格式与Gson的初始挑战
NDJSON(Newline Delimited JSON)是一种特殊的数据格式,其中每行都是一个独立的、有效的JSON对象,各行之间通过换行符分隔。与传统的JSON数组不同,NDJSON文件本身并非一个单一的JSON数组,而是多个JSON对象的集合。
当尝试使用Gson库解析NDJSON文件时,常见的初学者误区是直接调用gson.fromJson(reader, YourDTO.class)。例如,对于一个包含多条客户记录的customer.json文件:
// Record # 1{ "profile":{ "salutation":"Mr", "title":null, "company":null }, "phone":{ "home_phone":null }, "addresses":[ { "address_id":"1", "first_name":"Veronica" } ], "orders":{ "placed_orders_count":2 }}// Record # 2{ "profile":{ "salutation":null, "title":null }, "phone":{ "home_phone":null }, "addresses":[ { "address_id":"2", "title":"" } ], "orders":{ "placed_orders_count":0 }}// ... 更多记录
如果使用以下代码尝试读取:
import com.google.gson.Gson;import com.google.gson.stream.JsonReader;import java.io.FileReader;import java.io.IOException;// 假设 CustomerFeedDTO 已经定义// ...public class InitialNdjsonReaderExample { public static void main(String[] args) { Gson gson = new Gson(); try (JsonReader reader = new JsonReader(new FileReader("customer.json"))) { // 这种方式只能读取第一个JSON对象 CustomerFeedDTO customerFeedDTO = gson.fromJson(reader, CustomerFeedDTO.class); System.out.println("成功读取第一个记录: " + customerFeedDTO); // 后续的记录将无法读取到,因为fromJson方法在读取完一个完整的JSON对象后就会停止。 } catch (IOException e) { e.printStackTrace(); } }}
这段代码只会成功解析文件中的第一个JSON对象,因为gson.fromJson()方法在读取完一个完整的JSON对象后就会停止。为了读取所有记录,我们需要一种机制来逐个处理文件中的每个JSON对象。
解决方案:循环读取与JsonReader
要正确解析NDJSON文件中的所有记录,核心思想是利用JsonReader的流式读取特性,通过循环逐个解析JSON对象。
aspx1财付通支付接口源码
本支付接口的特点,主要是用xml文件来记录订单详情和支付详情。代码比较简单,只要将里面的商户号、商户key换成你自己的,将回调url换成你的网站,就可以使用了。通过这个实例也可以很好的了解一般在线支付接口的基本工作原理。其中的pay.config文件记录的是支付详情,order.config是订单详情
0 查看详情
以下是实现这一目标的详细步骤和示例代码:
初始化JsonReader和Gson: 创建Gson实例和指向NDJSON文件的JsonReader。设置宽松模式: 调用reader.setLenient(true)。这在处理一些非严格符合JSON规范的输入时非常有用,例如可能存在注释或未引用的字段名等。对于NDJSON文件,虽然通常是严格的,但开启此模式可以增加兼容性。循环读取: 使用while (reader.peek() != JsonToken.END_DOCUMENT)作为循环条件。reader.peek()方法用于查看下一个令牌的类型,而不会实际消耗它。JsonToken.END_DOCUMENT表示已经到达JSON文档的末尾。通过检查这个令牌,我们可以确保在文件完全读取完毕后安全地退出循环。解析并添加: 在循环内部,每次迭代都调用gson.fromJson(reader, CustomerFeedDTO.class)来解析当前行的JSON对象,并将其添加到预先创建的List中。
import com.google.gson.Gson;import com.google.gson.stream.JsonReader;import com.google.gson.stream.JsonToken; // 导入 JsonTokenimport java.io.FileReader;import java.io.IOException;import java.util.ArrayList;import java.util.List;import java.util.Map;// CustomerFeedDTO 类定义 (详见下一节)class CustomerFeedDTO { private Map profile; private Map phone; private ArrayList addresses; private Map orders; private ArrayList customs; // Getters and setters (省略具体实现,但实际应用中需要) public Map getProfile() { return profile; } public void setProfile(Map profile) { this.profile = profile; } public Map getPhone() { return phone; } public void setPhone(Map phone) { this.phone = phone; } public ArrayList getAddresses() { return addresses; } public void setAddresses(ArrayList addresses) { this.addresses = addresses; } public Map getOrders() { return orders; } public void setOrders(Map orders) { this.orders = orders; } public ArrayList getCustoms() { return customs; } public void setCustoms(ArrayList customs) { this.customs = customs; } @Override public String toString() { return "CustomerFeedDTO{" + "profile=" + profile + ", phone=" + phone + ", addresses=" + addresses + ", orders=" + orders + ", customs=" + customs + '}'; }}public class NdjsonMultiRecordReader { public static void main(String[] args) { List customerFeedDTOs = new ArrayList(); Gson gson = new Gson(); // 使用 try-with-resources 确保资源自动关闭 try (JsonReader reader = new JsonReader(new FileReader("customer.json"))) { // 启用宽松模式,以处理可能存在的非严格JSON格式 reader.setLenient(true); // 循环读取直到文档结束 while (reader.peek() != JsonToken.END_DOCUMENT) { CustomerFeedDTO customerFeedDTO = gson.fromJson(reader, CustomerFeedDTO.class); customerFeedDTOs.add(customerFeedDTO); System.out.println("成功读取记录: " + customerFeedDTO); // 打印每条记录以验证 } System.out.println("n所有记录读取完毕。总计 " + customerFeedDTOs.size() + " 条记录。"); } catch (IOException e) { System.err.println("读取文件时发生错误: " + e.getMessage()); e.printStackTrace(); } }}
DTO类定义
为了成功映射NDJSON数据,需要一个对应的Java数据传输对象(DTO)类。根据提供的NDJSON结构,一个示例的CustomerFeedDTO可以定义如下:
import java.util.ArrayList;import java.util.Map;public class CustomerFeedDTO { // 使用Map来灵活处理内部结构不固定的JSON对象 private Map profile; private Map phone; // 使用ArrayList来处理JSON数组 private ArrayList addresses; private Map orders; private ArrayList customs; // 构造函数 (可选) public CustomerFeedDTO() {} // Getters and Setters (必须提供,Gson通过反射调用它们进行数据绑定) public Map getProfile() { return profile; } public void setProfile(Map profile) { this.profile = profile; } public Map getPhone() { return phone; } public void setPhone(Map phone) { this.phone = phone; } public ArrayList getAddresses() { return addresses; } public void setAddresses(ArrayList addresses) { this.addresses = addresses; } public Map getOrders() { return orders; } public void setOrders(Map orders) { this.orders = orders; } public ArrayList getCustoms() { return customs; } public void setCustoms(ArrayList customs) { this.customs = customs; } @Override public String toString() { return "CustomerFeedDTO{" + "profile=" + profile + ", phone=" + phone + ", addresses=" + addresses + ", orders=" + orders + ", customs=" + customs + '}'; }}
注意: 实际应用中,Map 和 ArrayList 可以被更具体的DTO类或泛型类型替换,以实现更强类型的数据访问和更清晰的代码结构。例如,profile可以是一个ProfileDTO对象,addresses可以是一个List,这样可以更好地封装数据并提供类型安全。
注意事项
reader.setLenient(true)的重要性:此方法允许JsonReader在解析JSON时更加宽容,例如接受未引用的名称、单引号字符串、C风格注释等。虽然NDJSON规范通常要求严格的JSON,但实际文件中可能存在一些不规范的格式。开启此模式可以提高解析的健壮性。
reader.peek()与reader.hasNext()的比较:JsonReader确实有一个hasNext()方法,但它在到达文档末尾时可能会抛出IllegalStateException。相比之下,reader.peek() != JsonToken.END_DOCUMENT是一种更安全、更推荐的判断文件末尾的方式,它通过检查下一个令牌类型来避免异常。
资源管理:try-with-resources:在处理文件I/O时,确保FileReader和JsonReader等资源被正确关闭至关重要,以防止资源泄露。Java 7及更高版本提供的try-with-resources语句是管理这些可关闭资源的最佳实践,它能确保在try块结束时(无论正常结束还是异常结束)自动关闭资源。
异常处理:文件读取和JSON解析过程中可能会出现IOException或JsonSyntaxException等异常。在生产代码中,应提供健壮的异常处理机制,例如记录错误日志、向用户提供友好的错误信息或采取恢复措施。
以上就是使用Gson解析NDJSON文件中的多个JSON记录的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1099747.html
微信扫一扫
支付宝扫一扫