java.nio.Buffer

直系の既知のサブクラス:: ByteBuffer, CharBuffer, DoubleBuffer, FloatBuffer, IntBuffer, LongBuffer, ShortBuffer

public abstract sealed class Buffer extends Object permits ByteBuffer, CharBuffer, DoubleBuffer, FloatBuffer, IntBuffer, LongBuffer, ShortBuffer

特定のプリミティブ型データのコンテナです。

バッファは、特定のプリミティブ型要素のリニアで有限のシーケンスです。内容のほかに、容量、リミット、位置という必須プロパティがあります。

「容量」は、そのバッファに含まれる要素数によって決定されます。容量の値は固定で、必ず正の値になります。

「リミット」は、読み込みまたは書込みを行ってはならない最初の要素のインデックスです。容量以下の正の値になります。

「位置」は、次に読み込みまたは書込みを行う要素のインデックスです。リミット以下の正の値になります。

非ブール型のプリミティブ型には、このクラスのサブクラスが1つずつ割り当てられています。

データの転送

このクラスのサブクラスは、それぞれ次の2つのカテゴリに該当する「get」操作および「put」操作を定義します。

「相対」操作。現在位置から1個以上の要素の読み込みまたは書込みを行い、転送された要素の数だけ位置を増加します。要求された転送がリミットを超える場合、相対「get」操作はBufferUnderflowExceptionを、相対「put」操作はBufferOverflowExceptionをスローします。どちらの場合も、データは一切転送されません。

「絶対」操作。明示的な要素インデックスを使用するため、位置は変化しません。インデックス引数がリミットを超える場合、絶対「get」操作および「put」操作はIndexOutOfBoundsExceptionをスローします。

適切なチャネルの入出力操作を行えば、データの転送(バッファとのやりとり)は可能です。この操作は、常に現在位置に対して相対的に行われます。

マークとリセット

バッファの「マーク」は、resetメソッドを呼び出したときに戻る位置を指定するインデックスです。定義されていない場合もありますが、定義されている場合は必ず位置以下の正の値になります。位置やリミットの値がマークの値よりも小さい場合、マークは破棄されます。マークが定義されていない場合、resetメソッドを呼び出すと、InvalidMarkExceptionがスローされます。

Invariants

次のインバリアントは、マーク、位置、リミット、容量の値を表します。

0 <= mark <= position <= limit <= capacity

新しく作成されたバッファの位置は常にゼロ、マークは未定義です。リミットの初期値はゼロか、バッファの構築方法や種類によってはそれ以外の値になります。新しく割り当てられたバッファの各要素はゼロに初期化されます。

その他の操作

位置、リミット、容量の値にアクセスするメソッドや、マークやリセットを行うメソッドと同様に、このクラスもバッファに対する次のような操作を定義します。

clear()は、新しい一連のチャネル読込み操作または相対「put」操作のためにバッファを準備します。リミットを容量の値に設定し、位置をゼロに設定します。
flip()は、新しい一連のチャネル読込み操作または相対「get」操作のためにバッファを準備します。リミットの値を現在位置の値に合わせたあと、位置の値をゼロにします。
rewind()は、すでにバッファに格納されているデータを再度読み込めるように、バッファを準備します。リミットの値はそのままで、位置の値をゼロにします。
slice()およびslice(index,length)メソッドは、バッファのサブ・シーケンスを作成: 上限および位置は変更されません。
duplicate()はバッファの浅いコピーを作成: 限界と位置は変わらない。

読込み専用バッファ

すべてのバッファは読込み可能ですが、書き込みも可能であるとは限りません。各バッファ・クラスの変異メソッドは「オプションの操作」に指定されており、読取り専用バッファ上で呼び出されるとReadOnlyBufferExceptionをスローします。読取り専用バッファの内容は変更できません。しかし、マーク、位置、リミットの値は変更可能です。バッファが読取り専用かどうかは、isReadOnlyメソッドの呼出しによって判断できます。

スレッドの安全性

バッファは、複数の並行スレッドによる使用において安全ではありません。複数のスレッドで使用する場合は、適切な同期処理によってバッファへのアクセスを制御する必要があります。

呼出しの連鎖

このクラスのメソッドのうち戻り値を返さないものは、自身を呼び出したバッファの情報を返します。これを応用して、メソッド呼出しを連鎖させることができます。たとえば次のような文があるとしましょう。

    b.flip();
    b.position(23);
    b.limit(42);

これらは、よりコンパクトな形式の一行で置き換えられます。

    b.flip().position(23).limit(42);

シール済クラス階層グラフ:
導入されたバージョン:: 1.4

メソッドのサマリー

修飾子と型

メソッド

説明

abstract Object

array()

このバッファを補助する配列を返します (オプションの操作)。

abstract int

arrayOffset()

このバッファの補助配列内にある、このバッファの最初の要素のオフセットを返します (オプションの操作)。

final int

capacity()

このバッファの容量を返します。

Buffer

clear()

このバッファをクリアします。

abstract Buffer

duplicate()

このバッファのコンテンツを共有する新しいバッファを作成します。

Buffer

flip()

このバッファをフリップ(反転)します。

abstract boolean

hasArray()

このバッファがアクセス可能な配列に連動するかどうかを判断します。

final boolean

hasRemaining()

現在位置からリミットまでに要素が1つでも存在するかどうかを判断します。

abstract boolean

isDirect()

このバッファがダイレクトであるかどうかを判断します。

abstract boolean

isReadOnly()

このバッファが読取り専用であるかどうかを判断します。

final int

limit()

このバッファのリミットを返します。

Buffer

limit(int newLimit)

このバッファのリミットを設定します。

Buffer

mark()

このバッファの現在位置にマークを設定します。

final int

position()

このバッファの位置を返します。

Buffer

position(int newPosition)

このバッファの位置を設定します。

final int

remaining()

現在位置からリミットまでに存在する要素の数を返します。

Buffer

reset()

バッファの位置を以前にマークした位置に戻します。

Buffer

rewind()

このバッファをリワインド(巻き戻し)します。

abstract Buffer

slice()

コンテンツがこのバッファのコンテンツの共有部分列である新しいバッファを作成します。

abstract Buffer

slice(int index, int length)

コンテンツがこのバッファのコンテンツの共有部分列である新しいバッファを作成します。

クラスjava.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細
- capacity
  
  public final int capacity()
  
  このバッファの容量を返します。
  
  戻り値:
  
  このバッファの容量
- position
  
  public final int position()
  
  このバッファの位置を返します。
  
  戻り値:
  
  このバッファの位置
- position
  
  public Buffer position(int newPosition)
  
  このバッファの位置を設定します。新しい位置の値よりもマークの値のほうが大きい場合、マークの定義は破棄されます。
  
  パラメータ:
  
  newPosition - 新しい位置の値は、現在のリミット以下の負でない値でなければならない
  
  戻り値:
  
  このバッファ
  
  例外:
  
  IllegalArgumentException - newPositionの前提条件が保持されない場合
- limit
  
  public final int limit()
  
  このバッファのリミットを返します。
  
  戻り値:
  
  このバッファのリミット
- limit
  
  public Buffer limit(int newLimit)
  
  このバッファのリミットを設定します。位置の値が新しいリミットより大きい場合、リミットと同じ値に変更されます。マークの値が新しいリミットより大きい場合、マークの定義は破棄されます。
  
  パラメータ:
  
  newLimit - 新しいリミット値は、このバッファの容量以下の負でない値でなければならない
  
  戻り値:
  
  このバッファ
  
  例外:
  
  IllegalArgumentException - newLimitの前提条件が保持されない場合
- mark
  
  public Buffer mark()
  
  このバッファの現在位置にマークを設定します。
  
  戻り値:
  
  このバッファ
- reset
  
  public Buffer reset()
  
  バッファの位置を以前にマークした位置に戻します。
  このメソッドを呼び出しても、マークの値は変更されません。マークが破棄されることもありません。
  
  戻り値:
  
  このバッファ
  
  例外:
  
  InvalidMarkException - マークが設定されていない場合
- clear
  public Buffer clear()
  
  このバッファをクリアします。バッファの位置はゼロ、リミットは容量の値に設定されます。マークは破棄されます。
  一連のチャネル読込み操作または「put」操作を使用してこのバッファにデータを格納する前に、このメソッドを呼び出します。たとえば、
  
  buf.clear(); // Prepare buffer for reading in.read(buf); // Read data
  
  このメソッドはバッファ内のデータを実際に消去するわけではありません。しかし、そうした状況で使用されるため、クリアと命名されています。
  
  戻り値:
  
  このバッファ
- flip
  public 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メソッドと組み合わせて使用することがあります。
  
  戻り値:
  
  このバッファ
- rewind
  public Buffer rewind()
  
  このバッファをリワインド(巻き戻し)します。位置はゼロに設定され、マークは破棄されます。
  このメソッドは、リミットを正しく設定したあと、一連のチャネル書込み操作(get)の前に呼び出します。たとえば、
  
  out.write(buf); // Write remaining data buf.rewind(); // Rewind buffer buf.get(array); // Copy data into array
  
  戻り値:
  
  このバッファ
- remaining
  
  public final int remaining()
  
  現在位置からリミットまでに存在する要素の数を返します。
  
  戻り値:
  
  このバッファ内に残っている要素数
- hasRemaining
  
  public final boolean hasRemaining()
  
  現在位置からリミットまでに要素が1つでも存在するかどうかを判断します。
  
  戻り値:
  
  このバッファに1つ以上の要素が残っている場合にのみtrue
- isReadOnly
  
  public abstract boolean isReadOnly()
  
  このバッファが読取り専用であるかどうかを判断します。
  
  戻り値:
  
  true、このバッファが読取り専用の場合のみ
- hasArray
  
  public abstract boolean hasArray()
  
  このバッファがアクセス可能な配列に連動するかどうかを判断します。
  このメソッドがtrueを返す場合、arrayおよびarrayOffsetメソッドを安全に起動できます。
  
  戻り値:
  
  このバッファが配列によってバックアップされ、読取り専用でない場合のみ、true
  
  導入されたバージョン:
  
  1.6
- array
  
  public abstract Object array()
  
  このバッファを補助する配列を返します (オプションの操作)。
  このメソッドは、配列を利用するバッファをネイティブ・コードにより効率よく渡すために使用します。具象サブクラスは、このメソッドの戻り値として、より強く型付けされた値を返します。
  このバッファの内容に変更を加えると、返される配列の内容も変更されます。その逆も同様です。
  このメソッドを呼び出す前にhasArrayメソッドを呼び出し、このバッファがアクセス可能な補助配列を持っていることを確認します。
  
  戻り値:
  
  このバッファを補助する配列
  
  例外:
  
  ReadOnlyBufferException - このバッファが配列に連動しており、しかも読込み専用である場合
  
  UnsupportedOperationException - このバッファがアクセス可能な配列を利用しない場合
  
  導入されたバージョン:
  
  1.6
- arrayOffset
  
  public abstract int arrayOffset()
  
  このバッファの補助配列内にある、このバッファの最初の要素のオフセットを返します (オプションの操作)。
  このバッファが配列によってバックアップされる場合、バッファ位置pは配列索引p + arrayOffset()に対応します。
  このメソッドを呼び出す前にhasArrayメソッドを呼び出し、このバッファがアクセス可能な補助配列を持っていることを確認します。
  
  戻り値:
  
  このバッファの配列内にある、このバッファの最初の要素のオフセット
  
  例外:
  
  ReadOnlyBufferException - このバッファが配列に連動しており、しかも読込み専用である場合
  
  UnsupportedOperationException - このバッファがアクセス可能な配列を利用しない場合
  
  導入されたバージョン:
  
  1.6
- isDirect
  
  public abstract boolean isDirect()
  
  このバッファがダイレクトであるかどうかを判断します。
  
  戻り値:
  
  true、このバッファが直接の場合のみ
  
  導入されたバージョン:
  
  1.6
- slice
  
  public abstract Buffer slice()
  
  コンテンツがこのバッファのコンテンツの共有部分列である新しいバッファを作成します。
  新しいバッファの内容は、このバッファの現在位置から始まります。このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。新しいバッファの内容に変更を加えると、その内容がこのバッファに反映されます。2つのバッファの位置、リミット、マークの値はそれぞれ異なります。
  新しいバッファの位置はゼロになり、その容量と制限はこのバッファに残っている要素の数になり、マークは未定義になります。新しいバッファは、このバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。また、このバッファが読取り専用バッファである場合にかぎり読取り専用バッファになります。
  
  戻り値:
  
  新しいバッファ
  
  導入されたバージョン:
  
  9
- slice
  
  public abstract Buffer slice(int index, int length)
  
  コンテンツがこのバッファのコンテンツの共有部分列である新しいバッファを作成します。
  新しいバッファの内容は、このバッファ内のindexの位置から始まり、length要素が含まれます。このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。新しいバッファの内容に変更を加えると、その内容がこのバッファに反映されます。2つのバッファの位置、リミット、マークの値はそれぞれ異なります。
  新しいバッファ位置はゼロ、容量とリミットはlengthです。マークは未定義となります。新しいバッファは、このバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。また、このバッファが読取り専用バッファである場合にかぎり読取り専用バッファになります。
  
  パラメータ:
  
  index - 新しいバッファの内容が開始される、このバッファ内の位置。limit()以外の値である必要があります。
  
  length - 新規バッファに含まれる要素の数。負以外でlimit() - indexより大きい値である必要があります。
  
  戻り値:
  
  新しいバッファ
  
  例外:
  
  IndexOutOfBoundsException - indexが、limit()以上の場合、lengthがマイナスまたはlength > limit() - index
  
  導入されたバージョン:
  
  13
- duplicate
  
  public abstract Buffer duplicate()
  
  このバッファのコンテンツを共有する新しいバッファを作成します。
  新しいバッファの内容は、このバッファの内容と同じになります。このバッファの内容に変更を加えると、その内容が新しいバッファに反映されます。新しいバッファの内容に変更を加えると、その内容がこのバッファに反映されます。2つのバッファの位置、リミット、マークの値はそれぞれ異なります。
  新しいバッファの容量、制限、位置およびマークの値は、このバッファの値と同じです。新しいバッファは、このバッファがダイレクト・バッファである場合にかぎりダイレクト・バッファになります。また、このバッファが読取り専用バッファである場合にかぎり読取り専用バッファになります。
  
  戻り値:
  
  新しいバッファ
  
  導入されたバージョン:
  
  9

クラスBuffer

データの転送

マークとリセット

Invariants

その他の操作

読込み専用バッファ

スレッドの安全性

呼出しの連鎖

メソッドのサマリー

クラスjava.lang.Objectで宣言されたメソッド

メソッドの詳細

capacity

position

position

limit

limit

mark

reset

clear

flip

rewind

remaining

hasRemaining

isReadOnly

hasArray

array

arrayOffset

isDirect

slice

slice

duplicate