Protocol Buffers - 消息

概述

Protocol Buffers 的最基本构建块是message属性。这在我们使用的语言（例如 Java、Python 等）中转换为类。

示例代码

以下是指示 Protocol Buffers 创建给定类实例所需的语法：

syntax = "proto3";
package theater;
option java_package = "com.tutorialspoint.theater";

message Theater {
}

我们将以上内容保存到“theater.proto”文件中，并在探索其他数据结构时使用它。

解释

这里的“syntax”表示我们使用的是哪个版本的 Protocol Buffers。因此，我们使用的是最新版本 3，该模式可以使用所有对版本 3 有效的语法。

syntax = "proto3";

这里的包用于冲突解决，例如，如果我们有多个同名的类/消息。

package tutorial;

此参数特定于 Java，即从“.proto”文件自动生成的代码所在的包。

option java_package = "com.tutorialspoint.greeting";

现在我们完成了先决条件，这里最后一项是：

message Theater

这仅仅是将要创建/重新创建的对象的基类的类名。请注意，它在当前形式下毫无用处，因为它没有任何其他属性。但随着我们的继续，我们将添加更多属性。

使用多个消息属性

单个 proto 文件也可以包含多个类/消息。例如，如果我们想，我们也可以在同一个文件中添加一个Visitors消息/类。Protocol Buffers 将确保为此创建两个独立的类。例如：

syntax = "proto3";

package theater;

option java_package = "com.tutorialspoint.theater";

message Theater {
}
message Visitor {
}

从 proto 文件创建 Java 类

要使用 Protocol Buffers，我们现在必须使用protoc二进制文件从此“.proto”文件创建所需的类。让我们看看如何做到这一点：

protoc  --java_out=. proto_files\theater.proto

使用从 proto 文件创建的 Java 类

就是这样！上述命令应该在当前目录中创建所需的文件，现在我们可以在 Java 代码中使用它们：

Theater theater = Theater.newBuilder().build()
Visitor visitor = Visitor.newBuilder().build()

在这个阶段，它并不是很有用，因为我们还没有向成员/类添加任何属性。当我们在Protocol Buffers - 字符串章节中查看字符串时，我们将这样做。