net.siisise.block

インタフェース Block

既知のサブインタフェースのリスト:

EditBlock, OverBlock, ReadableBlock

既知の実装クラスのリスト:

ByteBlock, ByteBufferBlock, ChannelBlock, MultiBlock, OverBlock.AbstractOverBlock, OverBlock.AbstractSubOverBlock, OverBlock.SubOverBlock, PacketBlock, ReadableBlock.AbstractReadableBlock, ReadableBlock.AbstractSubReadableBlock, ReadableBlock.SubReadableBlock, SinglePacketBlock

public interface Block

Packet のデータ加工点を中間にしたもの. java.nio Buffer っぽいかな 違い mark は offset を取得して外部で管理する. Read Only. Block同士でデータ移動が可能. 切り取りが可能. min と max が固定できるため. 0スタートではない。min 以下は読み書き禁止. Buffer 0 開始位置 Block 0 配列の頭 Buffer mark 位置のキープ (0または1つ) Block 複数位置のキープ (外部のみ) Buffer position 現在位置 Block backSize 現在位置 Buffer limit データ上限 以降空白 Block 可変limitなし backSize + size のみ Buffer capacity 最大容量 Block backSize + size 最大読み込み可能範囲 参照clip範囲の最大 Buufer remaining Block size Buffer 0 mark position limit capacity Block 0 min x offset max backSize +size BNFで配列っぽい振る舞いの構造がほしかった. Stream は便利だがseekとか柔軟にしたいこともあるので戻れるStreamの定番に.

メソッドのサマリー

修飾子とタイプ	メソッドと説明
Block	flip() 分ける.
long	seek(long offset) offset まで範囲内で移動する.
Block	sub(long index, long length) 部分集合をつくる.

メソッドの詳細

seek

long seek(long offset)

offset まで範囲内で移動する. Block内の指定の位置に移動する. 足りない場合は最後尾に移動する. 余白は追加しない Buffer の position と同じ. 参照するのは backLength() 切り取った場合もSubBlockの先頭が0でReadableBlock,OverBlockで範囲を超えることはない。 skipもある

パラメータ:

offset - 位置 相対

戻り値:

移動した位置

sub

Block sub(long index,
          long length)

部分集合をつくる. 範囲を超えて読み書きはできない。 メモリ空間は共有される. flip などで使う. SubBlock の interface型は親と同じ範囲を想定しているが書けないこともない。権威移譲はてきとう。

パラメータ:

index - 位置

length - サイズ ToDo:長すぎたときどうするかは未定

戻り値:

分割されたブロック

flip

Block flip()

分ける. OverBlock 以下は親と同じ型.EditBlockは実装によってOverBlockやReadableBlockかも。 split の前版 メモリ空間は可能な場合共有.

戻り値:

前

関連項目:

Input.readPacket(long)