MessagePackとは｜おすすめのMsgPack対応のAPIクライアント

Messagepackは、効率の良いバイナリ形式のオブジェクト・シリアライズフォーマットとして、データ交換をより効率的にしています。本文では、MessagePackの基本情報を紹介した上、MsgPack対応のAPIクライアントを使って、サーバー間でより効率的なデータ通信を行える方法を皆さんに紹介します。

MessagePackとは

MessagePack（MsgPack）とは、MessagePackは、効率の良いバイナリ形式のオブジェクト･シリアライズ フォーマットです。JSONの置き換えとして使うことができ、様々なプログラミング言語をまたいでデータを交換することが可能です。しかも、JSONよりも速くてコンパクトです。例えば、小さな整数値はたった1バイト、短い文字列は文字列自体の長さ＋1バイトでシリアライズできます。

MessagePack公式：https://msgpack.org/ja.html

MsgPackの特徴

MessagePack（MsgPack）は、バイナリデータをやり取りしているので、ゲームやネットワークアプリケーションなどの分野で利用されています。特に軽量かつ高速なデータ交換が必要な場面で役立つフォーマットです。

• バイナリ形式でシリアライズされるため、JSONなどのテキスト形式に比べてデータサイズが小さくなります。
• シリアライズ/デシリアライズの処理が高速です。
• プリミティブ型、配列、マップ、文字列などの基本データ型をサポートしています。
• JSONと比較すると圧縮率やシリアライズ速度に優れています。
• 言語やプラットフォームに依存しないシリアライズフォーマットです。
• JSONとの互換性が高く、JSONとの相互変換が可能です。
• C、C++、Java、Python、Goなど、多くのプログラミング言語で利用できます。

MessagePackとAPIとの関連

messagepackは軽量で効率的なデータ交換を行えるため、API領域で非常に広く利用されています。例えば、REST APIなどのWeb APIで、リクエストやレスポンスのペイロードをシリアライズするのに利用できています。

MessagePackをAPIのデータ通信に導入すると、多くのメリットがあると言われています。例えば：

• データサイズが小さくなるため、ネットワークの使用量が減ります。
• シリアライズとデシリアライズが高速なため、レスポンス時間が短縮できます。
• バイナリフォーマットのため、暗号化しやすくデータを保護できます。
• JSONとの相互変換が可能なので、徐々に導入していけます。
• 多言語に対応しているため、他システムとの連携が容易です。
• 様々なデータベースやメッセージングミドルウェアとの親和性が高い。
• 組み込み機器などのリソース制約環境にも導入しやすい。
• GUIツールがあるので、デバッグやデータ変換がし易くなります。

総じて言えば、データサイズと速度が重視されるWeb APIでは、MessagePackのメリットを活かせる場面は多いと言えます。

Apidog：MsgPack対応のAPIクライアント

コンパクトでシンプルなMessagePackは、API領域でかなり普及されていますが、それに対応でいるAPIクライアントがまだ少ないのも現状です。例えば、PostmanでMsgPack通信のAPIにリクエストを送信すると、バイナリで読めないレスポンスが返してしいます：

APIクライアントでMessagePackを利用する場合、以下のようにエンコーディングを行うことが望ましいです。

⒈クライアント側：クライアントはAPIリクエストのbodyをMessagePack形式にエンコードする。

⒉サーバ側：リクエストbodyのMessagePackデータをデコードする。

⒊レスポンス時：レスポンスbodyをMessagePack形式でエンコードする。

⒋クライアント側:レスポンスbodyのMessagePackデータをJSONにデコードして表示する。

上記のエンコードとデコードのプロセスが実行されると、API通信でMessagePackを効率的に利用できるようになり、APIテストの効率も極めて向上できます。Apidogは、MsgPackのエンコードとデコードにも完璧に対応できるので、いつもMsgPackのデータを人間と機械も読み込めるJSONに変換しています：

ApidogでMsgPackベースのAPIを簡単にテスト

それでは、MessagePackをAPIのデータ通信の手段として利用される場合は、どうすれば直感的にMessagePackのAPIをテストすればいいですか？次は、上記に触れているAPI管理ツールのApidogを使って、それを簡単に実現する方法を紹介します。

ステップ⒈Apidogを立ち上げ、既存のAPIを開くか、APIを新規に作成すると、Bodyタブに切り替えると、「MsgPack」を選択します。

ステップ⒉ここでJSONフォーマットのデータを入力すると、クライアントがサーバに送信するときに、自動的にMsgPackにエンコードします。

ステップ⒊ここですぐにサーバーからのレスポンスを取得します。Apidogで表示されているレスポンスは、MsgPackデータをデコードしたものになり、非常に便利です。

次の画像のように、リクエストに送信したデータとサーバーから取得したデータをパッケージキャプチャツールを利用してキャプチャーすると、これらのデータは実際に人間で読み取り不可能なデータになります。Apidogは、これらのデータを人間で読めるJSONデータにシームレスに変換しているので、APIのテストが非常にシンプルにしました。