public abstract class Buffer extends Object
バッファは、特定のプリミティブ型要素のリニアで有限のシーケンスです。 内容のほかに、容量、リミット、位置という必須プロパティがあります。
「容量」は、そのバッファに含まれる要素数によって決定されます。 容量の値は固定で、必ず正の値になります。
「リミット」は、読み込みまたは書込みを行ってはならない最初の要素のインデックスです。 容量以下の正の値になります。
「位置」は、次に読み込みまたは書込みを行う要素のインデックスです。 リミット以下の正の値になります。
非ブール型のプリミティブ型には、このクラスのサブクラスが1つずつ割り当てられています。
このクラスのサブクラスは、それぞれ次の2つのカテゴリに該当する「get」操作および「put」操作を定義します。
「相対」操作。現在位置から1個以上の要素の読み込みまたは書込みを行い、転送された要素の数だけ位置を増加します。 要求された転送がリミットを超える場合、相対「get」操作は
BufferUnderflowExceptionを、相対「put」操作はBufferOverflowExceptionをスローします。どちらの場合も、データは一切転送されません。「絶対」操作。明示的な要素インデックスを使用するため、位置は変化しません。 インデックス引数がリミットを超える場合、絶対「get」操作および「put」操作は
IndexOutOfBoundsExceptionをスローします。
適切なチャネルの入出力操作を行えば、データの転送(バッファとのやりとり)は可能です。この操作は、常に現在位置に対して相対的に行われます。
バッファの「マーク」は、resetメソッドを呼び出したときに戻る位置を指定するインデックスです。 定義されていない場合もありますが、定義されている場合は必ず位置以下の正の値になります。 位置やリミットの値がマークの値よりも小さい場合、マークは破棄されます。 マークが定義されていない場合、resetメソッドを呼び出すと、InvalidMarkExceptionがスローされます。
次のインバリアントは、マーク、位置、リミット、容量の値を表します。
0 <= mark <= position <= limit <= capacity
新しく作成されたバッファの位置は常にゼロ、マークは未定義です。 リミットの初期値はゼロか、バッファの構築方法や種類によってはそれ以外の値になります。 新しく割り当てられたバッファの各要素はゼロに初期化されます。
位置、リミット、容量の値にアクセスするメソッドや、マークやリセットを行うメソッドと同様に、このクラスもバッファに対する次のような操作を定義します。
clear()は、新しい一連のチャネル読込み操作または相対「put」操作のためにバッファを準備します。リミットを容量の値に設定し、位置をゼロに設定します。
flip()は、新しい一連のチャネル読込み操作または相対「get」操作のためにバッファを準備します。リミットの値を現在位置の値に合わせたあと、位置の値をゼロにします。
rewind()は、すでにバッファに格納されているデータを再度読み込めるように、バッファを準備します。リミットの値はそのままで、位置の値をゼロにします。
すべてのバッファは読込み可能ですが、書き込みも可能であるとは限りません。 各バッファ・クラスの変異メソッドは「オプションの操作」に指定されており、読取り専用バッファ上で呼び出されるとReadOnlyBufferExceptionをスローします。 読取り専用バッファの内容は変更できません。しかし、マーク、位置、リミットの値は変更可能です。 バッファが読取り専用かどうかは、isReadOnlyメソッドの呼出しによって判断できます。
バッファは、複数の並行スレッドによる使用において安全ではありません。 複数のスレッドで使用する場合は、適切な同期処理によってバッファへのアクセスを制御する必要があります。
このクラスのメソッドのうち戻り値を返さないものは、自身を呼び出したバッファの情報を返します。 これを応用して、メソッド呼出しを連鎖させることができます。たとえば次のような文があるとしましょう。
これらは、よりコンパクトな形式の一行で置き換えられます。b.flip(); b.position(23); b.limit(42);
b.flip().position(23).limit(42);
| 修飾子と型 | メソッド | 説明 |
|---|---|---|
abstract Object |
array() |
このバッファを補助する配列を返します (オプションの操作)。
|
abstract int |
arrayOffset() |
このバッファの補助配列内にある、このバッファの最初の要素のオフセットを返します (オプションの操作)。
|
int |
capacity() |
このバッファの容量を返します。
|
Buffer |
clear() |
このバッファをクリアします。
|
Buffer |
flip() |
このバッファをフリップ(反転)します。
|
abstract boolean |
hasArray() |
このバッファがアクセス可能な配列に連動するかどうかを判断します。
|
boolean |
hasRemaining() |
現在位置からリミットまでに要素が1つでも存在するかどうかを判断します。
|
abstract boolean |
isDirect() |
このバッファがダイレクトであるかどうかを判断します。
|
abstract boolean |
isReadOnly() |
このバッファが読取り専用であるかどうかを判断します。
|
int |
limit() |
このバッファのリミットを返します。
|
Buffer |
limit(int newLimit) |
このバッファのリミットを設定します。
|
Buffer |
mark() |
このバッファの現在位置にマークを設定します。
|
int |
position() |
このバッファの位置を返します。
|
Buffer |
position(int newPosition) |
このバッファの位置を設定します。
|
int |
remaining() |
現在位置からリミットまでに存在する要素の数を返します。
|
Buffer |
reset() |
バッファの位置を以前にマークした位置に戻します。
|
Buffer |
rewind() |
このバッファをリワインド(巻き戻し)します。
|
public final int capacity()
public final int position()
public final Buffer position(int newPosition)
newPosition - 新しい位置の値は、現在のリミット以下の負でない値でなければならないIllegalArgumentException - newPositionの前提条件が満たされていない場合public final int limit()
public final Buffer limit(int newLimit)
newLimit - 新しいリミット値は、このバッファの容量以下の負でない値でなければならないIllegalArgumentException - newLimitの前提条件が満たされていない場合public final Buffer mark()
public final Buffer reset()
このメソッドを呼び出しても、マークの値は変更されません。マークが破棄されることもありません。
InvalidMarkException - マークが設定されていない場合public final Buffer clear()
一連のチャネル読込み操作または「put」操作を使用してこのバッファにデータを格納する前に、このメソッドを呼び出します。 たとえば、
buf.clear(); // Prepare buffer for reading in.read(buf); // Read data
このメソッドはバッファ内のデータを実際に消去するわけではありません。しかし、そうした状況で使用されるため、クリアと命名されています。
public final Buffer flip()
一連のチャネル読込み操作(put)のあと、このメソッドを呼び出してチャネル書込み操作(相対「get」)の準備を行います。 たとえば、
buf.put(magic); // Prepend header in.read(buf); // Read data into rest of buffer buf.flip(); // Flip buffer out.write(buf); // Write header + data to channel
ある場所から別の場所にデータを転送する際、このメソッドをcompactメソッドと組み合わせて使用することがあります。
public final Buffer rewind()
このメソッドは、リミットを正しく設定したあと、一連のチャネル書込み操作(get)の前に呼び出します。 たとえば、
out.write(buf); // Write remaining data buf.rewind(); // Rewind buffer buf.get(array); // Copy data into array
public final int remaining()
public final boolean hasRemaining()
public abstract boolean isReadOnly()
public abstract boolean hasArray()
このメソッドの戻り値がtrueであれば、arrayおよびarrayOffsetメソッドを安全に呼び出すことができます。
public abstract Object array()
このメソッドは、配列を利用するバッファをネイティブ・コードにより効率よく渡すために使用します。 具象サブクラスは、このメソッドの戻り値として、より強く型付けされた値を返します。
このバッファの内容に変更を加えると、返される配列の内容も変更されます。その逆も同様です。
このメソッドを呼び出す前にhasArrayメソッドを呼び出し、このバッファがアクセス可能な補助配列を持っていることを確認します。
ReadOnlyBufferException - このバッファが配列に連動しており、しかも読込み専用である場合UnsupportedOperationException - このバッファがアクセス可能な配列を利用しない場合public abstract int arrayOffset()
このバッファが配列に連動していれば、その位置pが配列のインデックスp + arrayOffset()と一致します。
このメソッドを呼び出す前にhasArrayメソッドを呼び出し、このバッファがアクセス可能な補助配列を持っていることを確認します。
ReadOnlyBufferException - このバッファが配列に連動しており、しかも読込み専用である場合UnsupportedOperationException - このバッファがアクセス可能な配列を利用しない場合public abstract boolean isDirect()
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。