0

0

Java中如何操作Protobuf数据?序列化与反序列化指南

絕刀狂花

絕刀狂花

发布时间:2025-07-05 14:02:01

|

740人浏览过

|

来源于php中文网

原创

在java中操作protobuf数据主要包括定义.proto文件并生成java类、序列化对象为字节流、以及反序列化字节流还原对象。1. 定义.proto文件并通过protoc工具生成java类,如personouterclass.person;2. 使用tobytearray()方法将对象序列化为字节数组以便传输或存储;3. 使用parsefrom()方法将接收到的字节流转回对象,并注意异常处理和proto文件一致性;此外需关注字段变更兼容性、调试方式、性能及线程安全等问题。

Java中如何操作Protobuf数据?序列化与反序列化指南

在Java中操作Protobuf数据,主要就是做两件事:序列化和反序列化。这两个过程是使用Protocol Buffers进行数据传输的基础,尤其在网络通信、数据存储等场景中非常常见。

Java中如何操作Protobuf数据?序列化与反序列化指南

定义.proto文件并生成Java类

在操作之前,你需要先定义.proto文件,这是Protobuf的结构定义语言。比如:

Java中如何操作Protobuf数据?序列化与反序列化指南
syntax = "proto3";

message Person {
  string name = 1;
  int32 age = 2;
}

然后通过 protoc 工具生成对应的Java类:

立即学习Java免费学习笔记(深入)”;

protoc --java_out=. Person.proto

这一步完成后,会生成一个类似 PersonOuterClass.Person 的类,这个类就是你在Java代码中操作数据的核心对象。

Java中如何操作Protobuf数据?序列化与反序列化指南
注意:确保你的protoc版本和运行环境兼容,否则可能会出现不兼容的问题。

序列化:将对象转换为字节流

序列化的目的是为了便于传输或持久化,比如通过网络发送给其他服务或者写入文件。

以刚才的 Person 为例,你可以这样序列化:

Person person = Person.newBuilder()
    .setName("Alice")
    .setAge(25)
    .build();

byte[] data = person.toByteArray();

这段代码把一个 Person 对象转成了字节数组,可以直接通过Socket、HTTP Body等方式传输。

关键点:

Playground AI
Playground AI

AI图片生成和修图

下载
  • 使用 toByteArray() 是最直接的方式
  • 如果你有多个消息要打包一起传,可以考虑用 CodedOutputStream
  • 字节数组大小会影响性能,尽量控制字段数量和类型

反序列化:从字节流还原成对象

接收到对方发来的字节数组后,就需要把它还原成对象:

byte[] receivedData = ...; // 接收的字节流
Person receivedPerson = Person.parseFrom(receivedData);
System.out.println("Name: " + receivedPerson.getName());

这就是最基本的反序列化方式。如果接收的是多个连续的消息,可以用 CodedInputStream 来逐个读取。

需要注意的地方:

  • 确保发送方和接收方使用的 .proto 文件一致,否则解析失败
  • 如果字节流损坏或格式不对,会抛出异常,建议做好异常处理
  • 对于大块数据,建议配合流式读取避免内存溢出

常见问题与注意事项

  • 字段变更导致兼容问题?

    • Protobuf支持向后兼容,新增字段不影响旧客户端,但删除或修改字段类型可能导致问题。
  • 如何调试查看序列化后的内容?

    • 可以用 TextFormat.printToString(message) 把对象打印成可读字符串,方便调试。
  • 效率怎么样?

    • Protobuf的序列化/反序列化速度很快,而且生成的数据体积小,适合高性能场景。
  • 是否线程安全?

    • 构建器(Builder)不是线程安全的,但构建出来的对象是不可变的,可以安全共享。

基本上就这些。掌握了序列化和反序列化的基本流程,再加上一点对协议的理解,就能在Java里顺利使用Protobuf了。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

838

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

742

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

737

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

399

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

446

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

430

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16926

2023.08.03

Java JVM 原理与性能调优实战
Java JVM 原理与性能调优实战

本专题系统讲解 Java 虚拟机(JVM)的核心工作原理与性能调优方法,包括 JVM 内存结构、对象创建与回收流程、垃圾回收器(Serial、CMS、G1、ZGC)对比分析、常见内存泄漏与性能瓶颈排查,以及 JVM 参数调优与监控工具(jstat、jmap、jvisualvm)的实战使用。通过真实案例,帮助学习者掌握 Java 应用在生产环境中的性能分析与优化能力。

3

2026.01.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 3.9万人学习

Pandas 教程
Pandas 教程

共15课时 | 0.9万人学习

ASP 教程
ASP 教程

共34课时 | 3.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号