Web アプリケーション開発において、データ転送の効率はユーザー体験に直結します。従来の JSON 形式は可読性に優れますが、大規模なデータ処理においてはパース処理のオーバーヘッドが無視できません。Google が開発した FlatBuffers は、ゼロコピー機構を採用したバイナリシリアライゼーションライブラリであり、この課題を解決する有効な手段となります。

FlatBuffers 選定における主な利点

1. ゼロコピーによる高速アクセス

JSON ではデータ全体をメモリ上に展開する必要がありますが、FlatBuffers はバイナリデータを直接参照可能です。これにより、デシリアライゼーション処理を省略し、アクセス速度を大幅に向上させます。

2. スキーマによる型安全性

.fbs ファイルで構造を定義することで、ビルド時に型チェックが行われます。これにより、実行時エラーを未然に防ぐことが可能です。

3. 多言語対応

TypeScript を含む 20 以上の言語をサポートしており、バックエンドとフロントエンドで同一のスキーマを共有できます。

環境構築とコード生成

まず、公式リポジトリからコンパイラ flatc を入手し、npm パッケージをインストールします。

npm install flatbuffers
# flatc コンパイラは別途バイナリを取得するかソースから構築

次に、データ構造を定義します。ここではゲーム内のプレイヤー情報を例に取ります。

namespace GameData;

struct Vector3 {
  x: float;
  y: float;
  z: float;
}

table PlayerProfile {
  player_id: ulong;
  nickname: string;
  location: Vector3;
  level: int;
}

root_type PlayerProfile;

定義したスキーマから TypeScript 用のコードを生成します。

./flatc --ts player_profile.fbs

TypeScript での実装例

生成されたファイルを用いて、データの構築と読み込みを行います。

import * as flatbuffers from 'flatbuffers';
import { PlayerProfile, Vector3 } from './generated/player_profile_generated';

// データの構築
const fb = new flatbuffers.Builder(2048);

// 文字列の作成
const nameOffset = fb.createString("DevUser");

// 座標データの準備
Vector3.startVector3(fb);
Vector3.addX(fb, 10.5);
Vector3.addY(fb, 20.0);
Vector3.addZ(fb, 5.2);
const loc = Vector3.endVector3(fb);

// テーブルデータの構築
PlayerProfile.startPlayerProfile(fb);
PlayerProfile.addPlayerId(fb, 98765);
PlayerProfile.addNickname(fb, nameOffset);
PlayerProfile.addLocation(fb, loc);
PlayerProfile.addLevel(fb, 50);
const profile = PlayerProfile.endPlayerProfile(fb);

fb.finish(profile);

// バイナリデータの取得と送信
const buffer = fb.asUint8Array();
// fetch API などで送信可能

受信側では、バイナリデータをそのまま渡すことで即座にアクセスできます。

const data = PlayerProfile.getRootAsPlayerProfile(buffer);
console.log(data.nickname()); // "DevUser"
console.log(data.location()?.x()); // 10.5

パフォーマンス比較指標

一般的な環境における測定例は以下の通りです。

運用上の推奨事項

• スキーマ設計: 深いネストは避け、固定長データには struct を使用します。
• WebAssembly の活用: 大規模計算が必要な場合、flatc を WASM 化することで処理速度をさらに向上させられます。
• デバッグ支援: バイナリデータは可読性が低いため、flatc --binary --json を利用して内容を確認するワークフローを確立してください。