Protocol Buffers - 重复字段



概述

repeated 数据类型是 Protobuf 的复合数据类型之一。它在 Java 中转换为 java.util.List 接口。

继续我们从 Protocol Buffers - 字符串 章节中关于 **剧院** 的示例,以下是我们需要使用的语法,以便指示 Protobuf 我们将创建一个 **重复字段**:

theater.proto

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

message Theater {
   repeated string snacks = 8;
}

现在我们的 消息 类包含一个 repeated 属性。请注意,尽管我们有一个重复的字符串,但我们也可以拥有数字、布尔值、自定义数据类型列表。它还有一个 位置,这是 Protobuf 在序列化和反序列化期间使用的。成员的每个属性都需要分配一个唯一的数字。

从 Proto 文件创建 Java 类

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

protoc  --java_out=. theater.proto

这将在当前目录的 com > tutorialspoint > theater 文件夹中创建一个 TheaterOuterClass.java 类。我们在应用程序中使用此类,就像在 Protocol Buffers - 基本应用 章节中所做的那样。

使用从 Proto 文件创建的 Java 类

TheaterWriter.java

package com.tutorialspoint.theater;

import java.util.List;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.ArrayList;
import com.tutorialspoint.theater.TheaterOuterClass.Theater;

public class TheaterWriter{
   public static void main(String[] args) throws IOException {
      List<String> snacks = new ArrayList<>();
      snacks.add("Popcorn");
      snacks.add("Coke");
      snacks.add("Chips");
      snacks.add("Soda");
	    
      Theater theater = Theater.newBuilder()
         .addAllSnacks(snacks)
         .build();
		
      String filename = "theater_protobuf_output";
      System.out.println("Saving theater information to file: " + filename);
		
      try(FileOutputStream output = new FileOutputStream(filename)){
         theater.writeTo(output);
      }
      System.out.println("Saved theater information with following data to disk: \n" + theater);
   }
}

接下来,我们将有一个 **读取器** 来读取 **剧院** 信息:

TheaterReader.java

package com.tutorialspoint.theater;

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import com.tutorialspoint.greeting.Greeting.Greet;
import com.tutorialspoint.theater.TheaterOuterClass.Theater;
import com.tutorialspoint.theater.TheaterOuterClass.Theater.Builder;

public class TheaterReader{
   public static void main(String[] args) throws IOException {
      Builder theaterBuilder = Theater.newBuilder();

      String filename = "theater_protobuf_output";
      System.out.println("Reading from file " + filename);
        
      try(FileInputStream input = new FileInputStream(filename)) {
         Theater theater = theaterBuilder.mergeFrom(input).build();
         System.out.println(theater);
      }
   }
}

编译项目

现在我们已经设置了 **读取器** 和 **写入器**,让我们编译项目。

mvn clean install

序列化 Java 对象

现在,编译后,让我们首先执行 **写入器**:

> java -cp .\target\protobuf-tutorial-1.0.jar com.tutorialspoint.theater.TheaterWriter

Saving theater information to file: theater_protobuf_output
Saved theater information with following data to disk:
snacks: "Popcorn"
snacks: "Coke"
snacks: "Chips"
snacks: "Soda"

反序列化序列化对象

现在,让我们执行 **读取器** 从同一个文件读取:

java -cp .\target\protobuf-tutorial-1.0.jar com.tutorialspoint.theater.TheaterReader

Reading from file theater_protobuf_output
snacks: "Popcorn"
snacks: "Coke"
snacks: "Chips"
snacks: "Soda"

因此,正如我们所看到的,我们能够通过将二进制数据反序列化为 Theater 对象来读取序列化的 repeated 字段。在下一章 Protocol Buffers - 映射 中,我们将了解映射,这是一种复合类型。

广告