メインコンテンツまでスキップ

TCP

未指定​

TCPパケット分割プロトコルが未指定の場合、データはTCPの送受信操作ごとに記録・書き換えされます。これによりパケットの粘着(sticking)が起こることがあります。システムは1回の送信操作のデータを複数の送信に分割したり、複数の送信を1つに結合したりする可能性があるためです。したがってTCPプロトコルを書き換える場合は、TCPが使っているパケット分割プロトコルを明確に理解しておくのが最善です。指定したプロトコルと実際のプロトコルの不一致は、データ伝送の異常を引き起こす可能性が高くなります。

JSONRPC​

JSONRPC は「Content-Length」風のHTTP風ヘッダー付きJSON-RPCワイヤープロトコルの送出を担います。例えばLSP(Language Server Protocol)で使われるものです。

+---------------------+
| Content-Length: 100 |
+---------------------+
| \r\n\r\n |
+---------------------+
| 100 length playload |
+---------------------+

FixedLength​

受信した ByteBuffer を固定バイト数で分割するデコーダです。例えば、次の4つの断片化パケットを受信したとします:

+---+----+------+----+
| A | BC | DEFG | HI |
+---+----+------+----+

FixedLength はそれらを固定長で次の3つのパケットにデコードします:

+-----+-----+-----+
| ABC | DEF | GHI |
+-----+-----+-----+

LengthField​

受信した ByteBuffer を、バッファ内に含まれる固定長ヘッダーで指定されたバイト数で分割するデコーダです。

例えば、次の4つの断片化パケットを受信したとします:

+---+----+------+----+
| A | BC | DEFG | HI |
+---+----+------+----+

指定されたヘッダー長が1バイトで、最初のヘッダーが3バイト、2番目のヘッダーが4バイトを指定している場合、LengthField はそれらを次のパケットにデコードします:

+-----+------+
| BCD | FGHI |
+-----+------+

'A' と 'E' はヘッダーとなり、前方へは渡されません。

LineBased​

入ってくる ByteBuffer を行末文字('\n' または '\r\n')を基準に分割するデコーダです。

例えば、次の受信バッファを考えてみます:

+----+-------+------------+
| AB | C\nDE | F\r\nGHI\n |
+----+-------+------------+

LineBased のインスタンスはこのバッファを次のように分割します:

+-----+-----+-----+
| ABC | DEF | GHI |
+-----+-----+-----+