Flat Buffers - Vector 向量

Vector

Vector 向量数据类型是Flat Buffers的复合数据类型之一。它相当于我们使用的语言中的 array 或 List，例如 Java 等。

继续使用 Flat Buffers - String 章节中的 theater 示例，以下是我们需要用来指示 FlatBuffers 创建 vector 的语法 −

theater.fbs

namespace com.tutorialspoint.theater;

table Theater {
    snacks:[string]; // 字符串向量
    tickets:[float]; // 浮点向量
}
root_type Theater;

现在我们的 table 包含字符串和浮点的 vector 属性。

从 fbs 文件创建 Java 类

要使用 FlatBuffers，我们现在必须使用 flatc 二进制文件从此".fbs"文件创建所需的类。让我们看看如何做到这一点 −

flatc --java theater.fbs

这将在当前目录的 com > tutorialspoint > theater 文件夹中创建一个 Theater.java 类。我们在应用程序中使用此类的方式与 Flat Buffers - Schema 一章中的方式类似。

使用从 fbs 文件创建的 Java 类

创建和写入向量

为了创建向量，我们首先需要准备标量类型数组的偏移量，然后我们可以将向量添加到Flat Buffers。

// 为字符串数组创建数据
int popcorn = builder.createString("Popcorn");
int coke = builder.createString("Coke");
int chips = builder.createString("Chips");
int soda = builder.createString("Soda");

// 为snacks(零食)创建数组
int[] snacks = {popcorn, coke, chip, soda};

// 为snacks(零食)向量创建偏移量
int snacksVector = Theater.createSnacksVector(builder, snacks);

// 将详细信息添加到 Theater FlatBuffer
Theater.addSnacks(builder, snacksVector);

以下示例代码展示了创建字符串和整数向量的过程。

TheaterWriter.java

package com.tutorialspoint.theater;

import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;

import com.google.flatbuffers.FlatBufferBuilder;

public class TheaterWriter {
   public static void main(String[] args) throws FileNotFoundException, IOException {
        // 创建一个Flat Buffers构建器
        // 它将用于创建Theater  FlatBuffer
        FlatBufferBuilder builder = new FlatBufferBuilder(1024);
        
        // 为字符串数组创建数据
        int popcorn = builder.createString("Popcorn");
        int coke = builder.createString("Coke");
        int chip = builder.createString("Chips");
        int soda = builder.createString("Soda");
        
        // 为snacks(零食)创建数组
        int[] snacks = {popcorn, coke, chips, soda};
        
        // 为门票创建数组
        float[] tickets = {100.0f, 100.f, 200.f};
        
        // 为snacks(零食)向量创建偏移量
        int snacksVector = Theater.createSnacksVector(builder, snacks);
        
        // 为门票向量创建偏移量
        int ticketsVector = Theater.createTicketsVector(builder, tickets);
        
        // 使用 startTheater() 方法创建Theater  FlatBuffers
        Theater.startTheater(builder);
        // 向Theater  FlatBuffer 添加详细信息
        Theater.addSnacks(builder, snacksVector);
        Theater.addTickets(builder, ticketsVector);
        
        // 标记在 Greet FlatBuffer 中输入的数据结束
        int theater = Theater.endTheater(builder);
        
        // 完成构建器
        builder.finish(theater);
        
        // 获取要存储的字节
        byte[] data = builder.sizedByteArray();
        
        String filename = "theater_flatbuffers_output";
        System.out.println("将Theater 保存到文件:" + filename);
        // 将构建器内容写入名为 theater_flatbuffers_output 的文件
        try(FileOutputStream output = new FileOutputStream(filename)){
         output.write(data);
      	}
      	System.out.println("Saved theater with following data to disk: 
" + theater);
   }
}	

读取向量

为了读取向量，我们有方法获取向量的长度并通过索引获取条目，如下所示。

// 迭代由 snacksLength() 方法确定长度的snacks(零食)向量
for(int i = 0; i < theater.snacksLength(); i++ ) {
    // 通过其索引获取snacks(零食)
    System.out.print(" " + theater.snacks(i));
}

以下示例代码显示了读取字符串和整数向量的过程。

TheaterReader.java

package com.tutorialspoint.theater;

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.nio.ByteBuffer;

public class TheaterReader {
   public static void main(String[] args) throws FileNotFoundException, IOException {

      String filename = "theater_flatbuffers_output";
      System.out.println("Reading from file " + filename);
      try(FileInputStream input = new FileInputStream(filename)) {
         // 获取序列化数据
         byte[] data = input.readAllBytes();
         ByteBuffer buf = ByteBuffer.wrap(data);
         // 读取序列化数据中的根对象
         Theater theater = Theater.getRootAsTheater(buf);
         // 打印Theater 值
         System.out.println("Snacks: ");
         for(int i = 0; i < theater.snacksLength(); i++ ) {
            System.out.print(" " + theater.snacks(i));
         }
         System.out.println("
Tickets: ");
         for(int i = 0; i < theater.ticketsLength(); i++ ) {
            System.out.print(" " + theater.tickets(i));
         }         
      }
   }
}

编译项目

现在我们已经设置了reader和writer，让我们编译项目。

mvn clean install

序列化 Java 对象

现在，编译后，让我们先执行writer −

> java -cp .	arget\flatbuffers-tutorial-1.0.jar com.tutorialspoint.theater.TheaterWriter

Saving theater information to file: theater_flatbuffers_output
Saved theater information with following data to disk:
96

反序列化序列化对象

现在，让我们执行读取器来读取同一个文件−

java -cp .	arget\flatbuffers-tutorial-1.0.jar com.tutorialspoint.theater.TheaterReader

Reading from file theater_flatbuffers_output
Snacks:
 Popcorn Coke Chips Soda
Tickets:
 100.0 100.0 200.0

因此，如我们所见，我们能够通过将二进制数据反序列化为 Theater 对象来读取序列化的 vector。在下一章 Flat Buffers - struct 中，我们将研究扇区，这是一种复合类型。