java.nio
클래스 Buffer

java.lang.Object 
  java.nio.Buffer

알려진 직계 서브 클래스:

ByteBuffer, CharBuffer, DoubleBuffer, FloatBuffer, IntBuffer, LongBuffer, ShortBuffer

public abstract class Buffer
extends Object 

특정의 원시형 데이터의 컨테이너입니다.

버퍼는 특정의 원시형 요소의 리니어로 유한의 순서입니다. 컨텐츠 외에 용량, 리밋트, 위치라고 하는 필수 프로퍼티가 있습니다.

「용량」은 그 버퍼에 포함되는 요소수에 결정됩니다. 용량의 값은 고정으로 반드시 정의 값이 됩니다.

「리밋트」는 읽기 또는 write를 행해서는 안 되는 최초의 요소의 인덱스입니다. 용량 아래의 정의 값이 됩니다.

「위치」는 다음에 읽기 또는 write를 실시하는 요소의 인덱스입니다. 리밋트 아래의 정의 값이 됩니다.

비불형의 원시형에 는 이 클래스의 서브 클래스가 1개 씩 할당할 수 있고 있습니다.

데이터의 전송

이 클래스의 서브 클래스는 각각 다음의 2개의 카테고리에 해당하는 「get」 및 「put」를 정의합니다.

「상대」조작. 현재 위치로부터 1개 이상의 요소의 읽기 또는 write를 실시해, 전송 된 요소의 수만큼 위치를 증가합니다. 요구된 전송이 리밋트를 넘는 경우, 상대 「get」는 BufferUnderflowException를, 상대 「put」는 BufferOverflowException를 Throw 합니다. 어느 쪽의 경우도, 데이터는 일절 전송 되지 않습니다.

「절대」조작. 명시적인 요소 인덱스를 사용하기 위해, 위치는 변화하지 않습니다. 인덱스 인수가 리밋트를 넘는 경우, 절대 「get」, 절대 「put」라고도에 IndexOutOfBoundsException를 Throw 합니다.

적절한 채널의 입출력 조작을 실시하면, 데이터의 전송 (버퍼와의 주고받아)은 가능합니다. 이 조작은 항상 현재 위치에 대해서 상대적으로 행해집니다.

마크와 리셋

버퍼의 「마크」는 reset 메서드를 실행했을 때에 돌아오는 위치를 지정하는 인덱스입니다. 정의되어 있지 않은 경우도 있습니다만, 정의되고 있는 경우는 반드시 위치 아래의 정의 값이 됩니다. 위치나 리밋트의 값이 마크의 값보다 작은 경우, 마크는 파기됩니다. 마크가 정의되어 있지 않은 상태로 reset 메서드를 호출하면, InvalidMarkException을 발생시킵니다.

인 변형 (불변식)

마크, 위치, 리밋트, 용량의 각 치의 사이에는 다음의 불변식이 성립됩니다.

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

새롭게 작성된 버퍼의 위치는 항상 0, 마크는 미정도리입니다. 리밋트의 초기값 는 0 인가 버퍼의 구축 방법이나 종류에 따라서는 그 이외의 값이 됩니다. 일반적으로 버퍼의 초기 컨텐츠는 미정도리입니다.

클리어, 플립, 되감기

이 클래스에는 위치, 리밋트, 용량의 각 치에 액세스 하는 메서드 및 마크와 리셋를 실시하는 메서드에 더해버퍼에 대한 다음과 같은 조작도 정의되고 있습니다.

• clear() 는 새로운 일련의 채널 read 조작 또는 상대 「put」조작을 위해서 버퍼를 준비합니다. 리밋트를 용량의 값으로 설정해, 위치를 0 으로 설정합니다.

• flip() 는 새로운 채널 출력 순서 (상대 「get」)를 위해서 버퍼를 준비합니다. 리밋트의 값을 현재 위치의 값에 맞춘뒤 위치의 값을 0 으로 합니다.

• rewind() 는 이미 버퍼 포함되고 있는 데이터를 재차 읽어들일 수 있도록, 버퍼를 준비합니다. 리밋트의 값은 그대로 위치의 값을 0 으로 합니다.

읽기 전용 버퍼

모든 버퍼는 읽기 가능하지만, 출력도 가능하다라고는 한정하지 않습니다. 각 버퍼 클래스의 변이 메서드는 「생략 가능한 조작」으로 지정되고 있어 읽기 전용 버퍼상에서 불려가 면 ReadOnlyBufferException를 Throw 합니다. 읽기 전용 버퍼의 컨텐츠는 변경할 수 없습니다. 그러나, 마크, 위치, 리밋트의 값은 변경 가능합니다. 버퍼가 읽기 전용 일지 어떨지는 isReadOnly 메서드를 호출하는 것으로 판단할 수 있습니다.

thread의 안전성

버퍼는 복수의 병렬 thread에 한 사용에 대해 안전하지는 않습니다. 복수의 thread로 사용하는 경우는 적절한 동기 처리에 의해 버퍼에의 액세스를 제어할 필요가 있습니다.

호출의 연쇄

돌려주고야 할 값을 가지고 있지 않은 이 클래스의 메서드는 자신을 호출하는 버퍼를 돌려주기 위해서 지정됩니다. 이것을 응용해, 메서드 호출을 연쇄시킬 수가 있습니다. 예를 들어 다음과 같은 문장이 있다고 합시다.

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

이것들은 보다 컴팩트한 형식의 일행으로 옮겨놓을 수 있습니다.

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

도입된 버전 :

1.4

메서드 개요

int	capacity () 이 버퍼의 용량을 리턴합니다.
Buffer	clear () 이 버퍼를 클리어 합니다.
Buffer	flip () 이 버퍼를 플립 (반전) 합니다.
boolean	hasRemaining () 현재 위치로부터 리밋트까지 요소가 1개에 서도 존재할지 어떨지를 판단합니다.
abstract boolean	isReadOnly () 이 버퍼가 읽기 전용 일지 어떨지를 판단합니다.
int	limit () 이 버퍼의 리밋트를 리턴합니다.
Buffer	limit (int newLimit) 이 버퍼의 리밋트를 설정합니다.
Buffer	mark () 이 버퍼의 현재 위치에 마크를 설정합니다.
int	position () 이 버퍼의 위치를 리턴합니다.
Buffer	position (int newPosition) 이 버퍼의 위치를 설정합니다.
int	remaining () 현재 위치로부터 리밋트까지 존재하는 요소의 수를 리턴합니다.
Buffer	reset () 버퍼의 위치를 이전에 마크 한 위치에 되돌립니다.
Buffer	rewind () 이 버퍼를 되감기 (되감아) 합니다.

클래스 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 final Buffer  position(int newPosition)

이 버퍼의 위치를 설정합니다. 새로운 위치의 값보다 마크의 값 쪽이 큰 경우, 마크의 정의는 파기됩니다.

파라미터:

newPosition - 새로운 위치의 값. 0 이상 또한 현재의 리밋트 이하가 아니면 안된다

반환값:

현재의 버퍼

예외:

IllegalArgumentException - newPosition 전제 조건이 채워지지 않은 경우

limit

public final int limit()

이 버퍼의 리밋트를 리턴합니다.

반환값:

이 버퍼의 리밋트

limit

public final Buffer  limit(int newLimit)

이 버퍼의 리밋트를 설정합니다. 위치의 값이 새로운 리밋트보다 큰 경우, 리밋트와 같은 값으로 변경됩니다. 마크의 값이 새로운 리밋트보다 큰 경우, 마크의 정의는 파기됩니다.

파라미터:

newLimit - 새로운 리밋트치는 이 버퍼의 용량 아래의 정의 값이 아니면 안된다

반환값:

현재의 버퍼

예외:

IllegalArgumentException - newLimit 전제 조건이 채워지지 않은 경우

mark

public final Buffer  mark()

이 버퍼의 현재 위치에 마크를 설정합니다.

반환값:

현재의 버퍼

reset

public final Buffer  reset()

버퍼의 위치를 이전에 마크 한 위치에 되돌립니다.

이 메서드를 호출해도, 마크의 값은 변경되지 않습니다. 마크가 파기되는 일도 없습니다.

반환값:

현재의 버퍼

예외:

InvalidMarkException - 마크가 설정되어 있지 않은 경우

clear

public final Buffer  clear()

이 버퍼를 클리어 합니다. 버퍼의 위치는 0, 리밋트는 용량의 값으로 설정됩니다. 마크는 파기됩니다.

일련의 채널 read 조작 또는 「put」조작을 사용해 이 버퍼에 데이터를 포함하기 전에 이 메서드를 호출합니다.

 buf.clear();
     // Prepare buffer for reading in.read(buf);
    // Read data

이 메서드는 버퍼내의 데이터를 실제로 소거하는 것은 아닙니다. 그러나, 그러한 상황으로 사용되기 때문에 클리어 (clear)라고 명명해지고 있습니다.

반환값:

현재의 버퍼

flip

public final Buffer  flip()

이 버퍼를 플립 (반전) 합니다. 리밋트는 현재 위치의 값으로 설정되어 현재 위치를 나타내는 값은 0 으로 설정됩니다. 마크가 정의되고 있는 경우, 그 마크는 파기됩니다.

채널 read 조작 (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 final Buffer  rewind()

이 버퍼를 되감기 (되감아) 합니다. 위치는 0 으로 설정되어 마크는 파기됩니다.

이 메서드는 리밋트를 올바르게 설정한뒤 채널 출력 조작 (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