|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
java.lang.Object
|
+--java.nio.Buffer
|
+--java.nio.ByteBuffer
byte 버퍼입니다.
이 클래스는 byte 버퍼에 대한 조작을 다음의 6 개의 카테고리로 분류합니다.
연속한 바이트 순차 순서를 이 버퍼로부터 배열로 전송 하는 상대「일괄 get」
연속한 바이트 순차 순서를 byte 배열이나 그 외의 byte 버퍼로부터 이 버퍼로 전송 하는 상대「일괄 put」
원시적형의 값의 read와 기입을 실시해, 이러한 값과 바이트 순차 순서를 특정의 바이트 순서로 상호 변환하는 절대 및 상대「get」「put」
원시적형의 값을 저장하는 버퍼로서 byte 버퍼를 표시할 수 있는 「뷰밧파」의 작성 메소드
byte 버퍼는 버퍼의 내용에 용량을 할당하는 방법 ( byte 버퍼에는 「다이렉트」버퍼와 「비다이렉트」버퍼가 있습니다. 다이렉트 byte 버퍼의 경우, Java 가상 머신은 네이티브의 입출력 조작을 직접 실행하려고 합니다. 이것은 기본이 되는 operating system 고유의 입출력 조작을 호출할 때, 중간 버퍼를 개없다고 하는 것입니다.
다이렉트 byte 버퍼는 이 클래스의 팩토리 메소드 다이렉트 byte 버퍼는 파일의 한 벌역을 다이레크트메모리에 MAP 하는 방법 ( 다이렉트 byte 버퍼일지 어떨지는 이 클래스는 그 외의 모든 원시적형 (boolean 를 제외한다)의 값의 read와 기입을 실시하는 메소드를 정의합니다. 원시적치는 버퍼의 현재의 바이트 순서에 따라, 바이트 순차 순서와 상호 변환됩니다. 버퍼 순서의 취득 및 변경에는 이종 바이너리 데이터, 즉 형태가 다른 값의 순차 순서에 액세스 할 수 있게 하기 위한(해), 이 클래스는 형태 마다 절대 및 상대 get / put 메소드의 패밀리를 정의합니다. 예를 들어, 32 비트의 부동 소수점수(실수) (float 치)의 경우, 다음의 메소드가 정의됩니다.
char,short,int,long,double 의 각 형에도, 같은 메소드가 정의됩니다. 절대 get / put 메소드의 인덱스 파라미터는 읽어들여 또는 기입의 대상이 되는 형태는 아니고, 바이트입니다.
동종의 바이너리 데이터, 즉 같은 형태의 값의 순차 순서에 액세스 할 수 있게 하기 위한(해), 이 클래스는 지정된 byte 버퍼의 「뷰」를 작성하는 메소드를 정의합니다. 「뷰밧파」의 내용은 byte 버퍼를 이용하고 있습니다. byte 버퍼의 내용으로 변경을 더하면(자), 뷰밧파에 그 내용이 표시됩니다. 반대로, 뷰밧파의 내용으로 변경을 더하면(자), byte 버퍼에 그 내용이 표시됩니다. 이 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 독립하고 있습니다. 예를 들어, 뷰밧파에는 전술한 형태 고유의 「get」나 「get」메소드의 패밀리에게 우수한 중요한 이점이 3 개 있습니다.
뷰밧파에는 바이트는 아니고, 그 값의 형태 고유의 사이즈에 의해 인덱스를 붙일 수 있다 뷰밧파는 버퍼와 배열 또는 같은 형태의 그 외의 버퍼간에 연속한 값의 순차 순서를 교환할 수 있는 상대 일괄 「get」 및 「put」메소드를 제공한다 뷰밧파는 보조 byte 버퍼가 다이렉트 버퍼인 경우에 한해 다이렉트 버퍼가 된다고 하는 점으로써, 잠재적으로 효율이 좋다 뷰의 생성시, 뷰밧파의 바이트 순서는 byte 버퍼의 바이트 순서와 같게 됩니다. 이 클래스의 메소드중 반환값을 돌려주지 않는 것은 자신을 호출한 버퍼의 정보를 돌려줍니다. 이것을 응용해, 메소드 호출을 연쇄시킬 수가 있습니다.
예를 들어, 다음과 같은 연속한 문장이 있다고 합시다.
새로운 버퍼의 위치는 0, 리밋트는 용량과 같은 값이 됩니다. 마크는 정의되지 않습니다.
새로운 버퍼의 위치는 0, 리밋트는 용량과 같은 값이 됩니다. 마크는 정의되지 않습니다. 이 버퍼는
새로운 버퍼는 지정된 byte 배열에 의해 지시받습니다. 버퍼로 변경을 더하면(자) byte 배열이 변경되어 byte 배열로 변경을 더하면(자) 버퍼가 변경됩니다. 새로운 버퍼의 용량은 array.length, 위치는 offset, 리밋트는 offset + length 가 됩니다. 마크는 정의되지 않습니다. 지정된 배열이
새로운 버퍼는 지정된 byte 배열에 의해 지시받습니다. 버퍼로 변경을 더하면(자) byte 배열이 변경되어 byte 배열로 변경을 더하면(자) 버퍼가 변경됩니다. 새로운 버퍼의 용량과 리밋트는 array.length, 위치는 0 이 됩니다. 마크는 정의되지 않습니다. 지정된 배열이
새로운 버퍼의 내용은 이 버퍼의 현재 위치로부터 시작됩니다. 이 버퍼의 내용으로 변경을 더하면(자), 그 내용이 새로운 버퍼에 반영됩니다. 역의 경우도 같습니다. 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 다릅니다.
새로운 버퍼의 위치는 0, 용량과 리밋트는 이 버퍼내에 남아 있는 바이트수가 됩니다. 마크는 정의되지 않습니다. 새로운 버퍼는 이 버퍼가 다이렉트 버퍼인 경우에 한해 다이렉트 버퍼가 됩니다. 또, 이 버퍼가 읽어들여 전용 버퍼인 경우에 한해 read 전용 버퍼가 됩니다.
새로운 버퍼의 내용은 이 버퍼의 내용과 같게 됩니다. 이 버퍼의 내용으로 변경을 더하면(자), 그 내용이 새로운 버퍼에 반영됩니다. 역의 경우도 같습니다. 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 다릅니다.
새로운 버퍼의 용량, 리밋트, 위치, 마크의 값은 이 버퍼의 대응하는 값과 같게 됩니다. 새로운 버퍼는 이 버퍼가 다이렉트 버퍼인 경우에 한해 다이렉트 버퍼가 됩니다. 또, 이 버퍼가 읽어들여 전용 버퍼인 경우에 한해 read 전용 버퍼가 됩니다.
새로운 버퍼의 내용은 이 버퍼의 내용과 같게 됩니다. 이 버퍼의 내용으로 변경을 더하면(자), 그 내용이 새로운 버퍼에 반영됩니다. 그러나, 새로운 버퍼 자체는 읽어들여 전용이며, 그 공유의 내용을 변경할 수 없습니다. 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 다릅니다.
새로운 버퍼의 용량, 리밋트, 위치, 마크의 값은 이 버퍼의 대응하는 값과 같게 됩니다.
이 버퍼가 읽어들여 전용의 경우, 이 메소드의 동작은
이 버퍼의 현재 위치로 지정된 바이트를 기입해, 그 위치의 값을 증가합니다.
용량의 할당랩다이렉트 버퍼와 비다이렉트 버퍼
allocateDirect 를 호출하면(자) 작성됩니다. 통상은 이쪽의 버퍼 쪽이, 비다이렉트 버퍼보다 할당 및 해방 코스트가 약간 비싸집니다. 다이렉트 버퍼의 내용이 표준의 가베지 컬렉트된 heap의 외부에 있다면, 어플리케이션의 메모리훗트프린트에 대한 영향은 불과입니다. 이것으로부터, 다이렉트 버퍼에는 기본이 되는 시스템 고유의 입출력 조작에 종속되는 수명이 길게 용량의 큰 버퍼를 지정하는 것을 추천합니다. 일반적으로, 다이렉트 버퍼의 할당은 프로그램의 성능을 충분히 개선할 수 있을 전망이 있는 경우에게만 실시해야 합니다.
매핑isDirect 메소드를 호출하는 것으로 판단할 수 있습니다. 이 메소드를 사용하면, 성능이 중시되는 코드내에서 명시적으로 버퍼 관리를 실시할 수가 있습니다.
바이너리 데이터에의 액세스
order 메소드를 사용합니다. 특정의 바이트 순서는 ByteOrder 클래스의 인스턴스로 나타내집니다. byte 버퍼의 초기 순서는 항상 BIG_ENDIAN 입니다.
float
getFloat()
float getFloat(int index)
void putFloat(float f)
void putFloat(int index, float f) asFloatBuffer 메소드는 이 메소드의 호출원 byte 버퍼를 이용하는 FloatBuffer 클래스의 인스턴스를 생성합니다. char,short,int,long,double 의 각 형에도, 같은 뷰 작성 메소드가 정의되고 있습니다.
호출의 연쇄
이것들은 다음의 일문으로 옮겨놓을 수 있습니다.
bb.putInt(0xCAFEBABE);
bb.putShort(3);
bb.putShort(45);
bb.putInt(0xCAFEBABE). putShort(3). putShort(45);
메소드의 개요
static ByteBuffer allocate (int capacity)
새로운 byte 버퍼를 할당합니다.
static ByteBuffer allocateDirect (int capacity)
새로운 다이렉트 byte 버퍼를 할당합니다.
byte[]array ()
이 버퍼를 보조하는 byte 배열을 돌려줍니다 (임의 조작).
intarrayOffset ()
이 버퍼의 보조 배열의 최초의 요소의 오프셋(offset)를 돌려줍니다 (임의 조작).
abstract CharBuffer asCharBuffer ()
char 버퍼로서 이 byte 버퍼의 뷰를 작성합니다.
abstract DoubleBuffer asDoubleBuffer ()
double 버퍼로서 이 byte 버퍼의 뷰를 작성합니다.
abstract FloatBuffer asFloatBuffer ()
float 버퍼로서 이 byte 버퍼의 뷰를 작성합니다.
abstract IntBuffer asIntBuffer ()
int 버퍼로서 이 byte 버퍼의 뷰를 작성합니다.
abstract LongBuffer asLongBuffer ()
long 버퍼로서 이 byte 버퍼의 뷰를 작성합니다.
abstract ByteBuffer asReadOnlyBuffer ()
이 버퍼의 내용을 공유하는 새로운 read 전용 byte 버퍼를 작성합니다.
abstract ShortBuffer asShortBuffer ()
short 버퍼로서 이 byte 버퍼의 뷰를 작성합니다.
abstract ByteBuffer compact ()
이 버퍼를 압축합니다 (임의 조작).
intcompareTo (Object ob)
이 버퍼를 다른 오브젝트와 비교합니다.
abstract ByteBuffer duplicate ()
이 버퍼의 내용을 공유하는 새로운 byte 버퍼를 작성합니다.
booleanequals (Object ob)
이 버퍼가 다른 오브젝트와 등가일지 어떨지를 판단합니다.
abstract byteget ()
상대 「get」메소드입니다.
ByteBuffer get (byte[] dst)
상대 「일괄 get」메소드입니다.
ByteBuffer get (byte[] dst,
int offset,
int length)
상대 「일괄 get」메소드입니다.
abstract byteget (int index)
절대 「get」메소드입니다.
abstract chargetChar ()
char 치를 읽어내는 상대 「get」메소드입니다.
abstract chargetChar (int index)
char 치를 읽어내는 절대 「get」메소드입니다.
abstract doublegetDouble ()
double 치를 읽어내는 상대 「get」메소드입니다.
abstract doublegetDouble (int index)
double 치를 읽어내는 절대 「get」메소드입니다.
abstract floatgetFloat ()
float 치를 읽어내는 상대 「get」메소드입니다.
abstract floatgetFloat (int index)
float 치를 읽어내는 절대 「get」메소드입니다.
abstract intgetInt ()
int 치를 읽어내는 상대 「get」메소드입니다.
abstract intgetInt (int index)
int 치를 읽어내는 절대 「get」메소드입니다.
abstract longgetLong ()
long 치를 읽어내는 상대 「get」메소드입니다.
abstract longgetLong (int index)
long 치를 읽어내는 절대 「get」메소드입니다.
abstract shortgetShort ()
short 치를 읽어내는 상대 「get」메소드입니다.
abstract shortgetShort (int index)
short 치를 읽어내는 절대 「get」메소드입니다.
booleanhasArray ()
이 버퍼가 액세스 가능한 byte 배열을 이용할지 어떨지를 판단합니다.
inthashCode ()
이 버퍼의 현재의 해시 코드를 돌려줍니다.
abstract booleanisDirect ()
이 버퍼가 다이렉트 버퍼일지 어떨지를 판단합니다.
ByteOrder order ()
이 버퍼의 바이트 순서를 취득합니다.
ByteBuffer order (ByteOrder bo)
이 버퍼의 바이트 순서를 변경합니다.
abstract ByteBuffer put (byte b)
상대 「put」메소드입니다 (임의 조작).
ByteBuffer put (byte[] src)
상대 일괄 「put」메소드입니다 (임의 조작).
ByteBuffer put (byte[] src,
int offset,
int length)
상대 「일괄 put」메소드입니다 (임의 조작).
ByteBuffer put (ByteBuffer src)
상대 「일괄 put」메소드입니다 (임의 조작).
abstract ByteBuffer put (int index,
byte b)
절대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putChar (char value)
char 치를 기입하는 상대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putChar (int index,
char value)
char 치를 기입하는 절대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putDouble (double value)
double 치를 기입하는 상대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putDouble (int index,
double value)
double 치를 기입하는 절대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putFloat (float value)
float 치를 기입하는 상대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putFloat (int index,
float value)
float 치를 기입하는 절대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putInt (int value)
int 치를 기입하는 상대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putInt (int index,
int value)
int 치를 기입하는 절대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putLong (int index,
long value)
long 치를 기입하는 절대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putLong (long value)
long 치를 기입하는 상대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putShort (int index,
short value)
short 치를 기입하는 절대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer putShort (short value)
short 치를 기입하는 상대 「put」메소드입니다 (임의 조작).
abstract ByteBuffer slice ()
이 버퍼의 공유의 서브 순차 순서를 내용으로 하는 새로운 byte 버퍼를 작성합니다.
String toString ()
이 버퍼 상태를 간단하게 설명하는 캐릭터 라인을 돌려줍니다.
static ByteBuffer wrap (byte[] array)
byte 배열을 버퍼에 랩 합니다.
static ByteBuffer wrap (byte[] array,
int offset,
int length)
byte 배열을 버퍼에 랩 합니다.
클래스 java.nio. Buffer 에서 상속받은 메소드
capacity , clear , flip , hasRemaining , isReadOnly , limit , limit , mark , position , position , remaining , reset , rewind
클래스 java.lang. Object 에서 상속받은 메소드
clone , finalize , getClass , notify , notifyAll , wait , wait , wait
메소드의 상세
allocateDirect
public static ByteBuffer allocateDirect(int capacity)
보조 배열
capacity - 새로운 버퍼의 용량 (바이트)
allocate
public static ByteBuffer allocate(int capacity)
보조 배열배열 오프셋(offset)
capacity - 새로운 버퍼의 용량 (바이트)
wrap
public static ByteBuffer wrap(byte[] array,
int offset,
int length)
보조 배열배열 오프셋(offset)는 0 이 됩니다.
array - 새로운 버퍼를 보조하는 배열offset - 사용하는 서브 배열의 길이. array.length 이하의 정의 수가 아니면 안된다. 새로운 버퍼의 위치는 이 값으로 설정되는length - 사용하는 서브 배열의 길이. array.length - offset 이하의 정의 수가 아니면 안된다. 새로운 버퍼의 리밋트는 offset + length 로 설정된다
IndexOutOfBoundsException - offset 파라미터와 length 파라미터의 전제 조건이 채워지지 않은 경우
wrap
public static ByteBuffer wrap(byte[] array)
보조 배열배열 오프셋(offset)
array - 이 버퍼를 보조하는 배열
slice
public abstract ByteBuffer slice()
duplicate
public abstract ByteBuffer duplicate()
asReadOnlyBuffer
public abstract ByteBuffer asReadOnlyBuffer()
duplicate 메소드와 완전히 같게 됩니다.
get
public abstract byte get()
BufferUnderflowException - 버퍼의 현재 위치가 리밋트 이상인 경우
put
public abstract ByteBuffer put(byte b)
b - 기입해지는 바이트
BufferOverflowException - 이 버퍼의 현재 위치가 리밋트 이상인 경우
ReadOnlyBufferException - 이 버퍼가 읽어들여 전용 버퍼인 경우
get
public abstract byte get(int index)
index - 바이트의 read 위치를 나타내는 인덱스
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트 이상인 경우
public abstract ByteBuffer put(int index,
byte b)
이 버퍼의 인덱스 위치로 지정된 바이트를 기입합니다.
index - 바이트의 기입처를 나타내는 인덱스b - 기입해지는 바이트치
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트 이상인 경우
ReadOnlyBufferException - 이 버퍼가 읽어들여 전용 버퍼인 경우
public ByteBuffer get(byte[] dst,
int offset,
int length)
이 메소드는 이 버퍼로부터 지정된 배열에 바이트를 전송 합니다. 이 버퍼내에 남아 있는 바이트수가 요구에 못 미친 경우 (length > remaining()), 바이트는 일절 전송 되지 않고 BufferUnderflowException 가 슬로우 됩니다.
그 이외의 경우, 이 메소드는 이 버퍼의 현재 위치로부터 length 바이트가 지정된 배열의 지정된 오프셋(offset) 위치에 카피합니다. 그때마다, 이 버퍼의 위치가 length 두개증가합니다.
이 메소드를 src.get(dst, off, len) 의 형식에서 호출하면(자), 이하의 루프와 완전히 같은 결과가 됩니다.
for (int i = off; i < off + len; i++)
dst[i] = src.get();
다만, 이 버퍼내에 충분한 수의 byte 수가 있는 것을 최초로 확인하는 동작은 제외합니다. 또, 이 메소드를 사용하는 편이 루프보다 아득하게 효율적입니다.
dst - 바이트의 기입처가 되는 배열offset - 최초의 바이트의 기입처가 되는 배열내의 오프셋(offset). dst.length 이하의 정의 수가 아니면 안되는length - 지정된 배열에 기입해지는 최대 바이트수. dst.length - offset 이하의 정의 수가 아니면 안된다
BufferUnderflowException - 이 버퍼내에 남아 있는 바이트수가 length 보다 적은 경우
IndexOutOfBoundsException - offset 파라미터와 length 파라미터의 전제 조건이 채워지지 않은 경우public ByteBuffer get(byte[] dst)
이 메소드는 이 버퍼로부터 지정된 배열에 바이트를 전송 합니다. 이 메소드를 src.get(a) 의 형식에서 호출하면(자), 이하의 호출과 같은 결과가 됩니다.
src.get(a, 0, a.length)
BufferUnderflowException - 이 버퍼내에 남아 있는 바이트수가 length 보다 적은 경우public ByteBuffer put(ByteBuffer src)
이 메소드는 지정된 소스 버퍼내에 남아 있는 바이트를 이 버퍼에 전송 합니다. 소스 버퍼내에 남아 있는 바이트수가 이 버퍼내에 남아 있는 바이트수보다 많은 경우 (src.remaining() > remaining()), 바이트는 일절 전송 되지 않고 BufferOverflowException 가 슬로우 됩니다.
그 이외의 경우, 이 메소드는 지정된 버퍼의 현재 위치로부터 이 버퍼의 현재 위치에 n = src.remaining() 바이트를 카피합니다. 그때마다, 양쪽 모두의 버퍼의 위치가 n 두개증가합니다.
이 메소드를 dst.put(src) 의 형식에서 호출하면(자), 이하의 루프와 완전히 같은 결과가 됩니다.
while (src.hasRemaining())
dst.put(src.get());
다만, 이 버퍼내에 충분한 용량이 있는 것을 최초로 확인하는 동작은 제외합니다. 또, 이 메소드를 사용하는 편이 루프보다 아득하게 효율적입니다.
src - 바이트가 읽히는 소스 버퍼 (이 버퍼 이외)
BufferOverflowException - 이 버퍼에, 소스 버퍼의 바이트를 저장 가능한 한의 용량이 없는 경우
IllegalArgumentException - 소스 버퍼로서 이 버퍼를 지정했을 경우
ReadOnlyBufferException - 이 버퍼가 읽어들여 전용 버퍼인 경우
public ByteBuffer put(byte[] src,
int offset,
int length)
이 메소드는 지정된 소스 배열로부터 이 버퍼에 바이트를 전송 합니다. 배열로부터 카피하는 바이트수가 이 버퍼내에 남아 있는 바이트수보다 많은 경우 (length > remaining()), 바이트는 일절 전송 되지 않고 BufferOverflowException 가 슬로우 됩니다.
그 이외의 경우, 이 메소드는 지정된 배열의 지정된 오프셋(offset) 위치로부터 이 버퍼의 현재 위치에 length 분 바이트를 카피합니다. 그때마다, 이 버퍼의 위치가 length 두개증가합니다.
이 메소드를 dst.put(src, off, len) 의 형식에서 호출하면(자), 이하의 루프와 완전히 같은 결과가 됩니다.
for (int i = off; i < off + len; i++)
dst.put(a[i]);
다만, 이 버퍼내에 충분한 용량이 있는 것을 최초로 확인하는 동작은 제외합니다. 또, 이 메소드를 사용하는 편이 루프보다 아득하게 효율적입니다.
offset - 최초의 바이트가 읽히는 배열내의 오프셋(offset). array.length 이하의 정의 수가 아니면 안되는length - 지정된 배열로부터 읽어내지는 바이트수. array.length - offset 이하의 정의 수가 아니면 안된다
BufferOverflowException - 이 버퍼내에 남아 있는 용량이 부족한 경우
IndexOutOfBoundsException - offset 파라미터와 length 파라미터의 전제 조건이 채워지지 않은 경우
ReadOnlyBufferException - 이 버퍼가 읽어들여 전용 버퍼인 경우public final ByteBuffer put(byte[] src)
이 메소드는 소스가 되는 지정된 byte 배열의 내용 전체를 이 버퍼에 전송 합니다. 이 메소드를 dst.put(a) 의 형식에서 호출하면(자), 이하의 호출과 같은 결과가 됩니다.
dst.put(a, 0, a.length)
BufferOverflowException - 이 버퍼내에 남아 있는 용량이 부족한 경우
ReadOnlyBufferException - 이 버퍼가 읽어들여 전용 버퍼인 경우public final boolean hasArray()
이 메소드의 반환값이 true 이면,array 메소드와 arrayOffset 메소드를 안전하게 호출할 수가 있습니다.
public final byte[] array()
이 버퍼의 내용으로 변경을 더하면(자), 돌려주어지는 배열의 내용도 변경됩니다. 그 역도 같습니다.
이 메소드를 호출하기 전에 hasArray 메소드를 호출해, 이 버퍼가 액세스 가능한 보조 배열을 가지고 있는 것을 확인합니다.
ReadOnlyBufferException - 이 버퍼가 배열을 이용해, 게다가 읽어들여 전용인 경우
UnsupportedOperationException - 이 버퍼가 액세스 가능한 배열을 이용하지 않는 경우public final int arrayOffset()
이 버퍼가 배열에 의해 보조되고 있으면, 그 위치 p 가 배열의 인덱스 p + arrayOffset() 와 일치합니다.
이 메소드를 호출하기 전에 hasArray 메소드를 호출해, 이 버퍼가 액세스 가능한 보조 배열을 가지고 있는 것을 확인합니다.
ReadOnlyBufferException - 이 버퍼가 배열에 의해 보조되어 게다가 읽어들여 전용인 경우
UnsupportedOperationException - 이 버퍼가 액세스 가능한 배열에 의해 보조되지 않는 경우public abstract ByteBuffer compact()
버퍼의 현재 위치로부터 리밋트까지의 사이에 바이트가 존재하는 경우, 이것들을 버퍼의 선두에 카피합니다. 즉, 인덱스 위치 p = position() 의 바이트가 인덱스 0 에 카피되어 인덱스 위치 p + 1 의 바이트가 인덱스 1 에 카피된다고 하는 것입니다. 인덱스 위치 limit() - 1 의 바이트가 인덱스 n = limit() - 1 - p 에 카피될 때까지 같은 처리가 반복해집니다. 최종적으로 버퍼의 위치는 n 로 설정되어 리밋트는 용량의 값과 동일해집니다. 마크는 파기됩니다.
버퍼의 위치는 0 은 아니고, 카피되는 바이트수로 동일해집니다. 따라서, 이 메소드를 호출한 뒤, 곧바로 다른 상대 「put」메소드를 호출할 수가 있습니다.
이 메소드는 기입이 종료하지 않았던 경우에 버퍼로부터의 데이터의 기입을 실행하기 전에 호출합니다. 이하의 루프는 버퍼 buf 를 사용해, 어느 채널로부터 다른 채널에 바이트를 카피합니다.
buf.clear(); // Prepare buffer for use
for (;;) {
if (in.read(buf) < 0 && ! buf.hasRemaining())
break; // No more bytes to transfer
buf.flip();
out.write(buf);
buf.compact(); // In case of partial write
}
ReadOnlyBufferException - 이 버퍼가 읽어들여 전용 버퍼인 경우public abstract boolean isDirect()
public String toString()
Object 내의 toString public int hashCode()
byte 버퍼의 해시 코드는 버퍼내에 남아 있는 나머지의 요소, 즉 position() ~ limit() - 1 의 요소인 만큼 의존합니다.
버퍼의 해시 코드는 내용 의존형입니다. 향후 버퍼의 내용이 변경되지 않는 것이 분명하지 않은 한, 버퍼를 해시 MAP 그 외의 데이터 구조의 키로서 사용하는 것은 피해 주세요.
Object 내의 hashCode Object.equals(java.lang.Object) ,
Hashtable public boolean equals(Object ob)
2 개의 byte 버퍼는 다음의 경우에 한해 등가입니다.
요소의 형태가 같다
버퍼내에 남아 있는 요소수가 같다
버퍼내에 남아 있는 요소의 순차 순서 (개시 위치와는 무관계)가 각 점으로써 동일하다
byte 버퍼가, 그 외의 형태의 오브젝트와 등가가 될 것은 없습니다.
Object 내의 equals ob - 이 버퍼와 비교하는 오브젝트
Object.hashCode() ,
Hashtable public int compareTo(Object ob)
2 개의 byte 버퍼를 비교할 때는 버퍼내에 남아 있는 요소의 순차 순서가 사전순서에 비교됩니다. 이 때, 쌍방의 버퍼내에 남아 있는 순차 순서의 개시 위치는 고려되지 않습니다.
byte 버퍼를 그 외의 형태의 오브젝트와 비교할 수 없습니다.
Comparable 내의 compareTo ob - 비교 대상의 Object
ClassCastException - 인수가 byte 버퍼가 아닌 경우public final ByteOrder order()
바이트 순서는 복수 바이트의 값을 읽어낼 때나 기입할 때, 그리고 이 byte 버퍼의 뷰가 되는 버퍼를 작성할 경우에 사용합니다. 새롭게 작성된 byte 버퍼의 순서는 항상 BIG_ENDIAN 가 됩니다.
public final ByteBuffer order(ByteOrder bo)
bo - 새로운 바이트 순서 BIG_ENDIAN 또는 LITTLE_ENDIAN
public abstract char getChar()
이 버퍼의 현재 위치로부터 2 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 char 치로 변환합니다. 위치의 값은 그때마다 2 두개증가합니다.
BufferUnderflowException - 이 버퍼내에 남아 있는 바이트수가 2 바이트보다 적은 경우public abstract ByteBuffer putChar(char value)
이 버퍼의 현재 위치에, 현재의 바이트 순서에 따라, 지정된 char 치를 포함한 2 바이트를 기입합니다. 위치의 값은 그때마다 2 두개증가합니다.
value - 기입해지는 char 치
BufferOverflowException - 이 버퍼내에 남아 있는 바이트수가 2 바이트보다 적은 경우public abstract char getChar(int index)
지정된 인덱스 위치에 있는 2 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 char 치로 변환합니다.
index - 바이트의 read 위치를 나타내는 인덱스
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 1 을 뺀 값이상인 경우
public abstract ByteBuffer putChar(int index,
char value)
이 버퍼의 지정된 인덱스 위치에, 현재의 바이트 순서에 따라, 지정된 char 치를 포함한 2 바이트를 기입합니다.
index - 바이트의 기입처를 나타내는 인덱스value - 기입해지는 char 치
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 1 을 뺀 값이상인 경우public abstract CharBuffer asCharBuffer()
새로운 버퍼의 내용은 이 버퍼의 현재 위치로부터 시작됩니다. 이 버퍼의 내용으로 변경을 더하면(자), 그 내용이 새로운 버퍼에 반영됩니다. 역의 경우도 같습니다. 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 다릅니다.
새로운 버퍼의 위치는 0, 용량과 리밋트는 이 버퍼내에 남아 있는 바이트수의 것 1/2 이 됩니다. 마크는 정의되지 않습니다. 새로운 버퍼는 이 버퍼가 다이렉트 버퍼인 경우에 한해 다이렉트 버퍼가 됩니다. 또, 이 버퍼가 읽어들여 전용 버퍼인 경우에 한해 read 전용 버퍼가 됩니다.
public abstract short getShort()
이 버퍼의 현재 위치로부터 2 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 short 치로 변환합니다. 위치의 값은 그때마다 2 두개증가합니다.
BufferUnderflowException - 이 버퍼내에 남아 있는 바이트수가 2 바이트보다 적은 경우public abstract ByteBuffer putShort(short value)
이 버퍼의 현재 위치에, 현재의 바이트 순서에 따라, 지정된 short 치를 포함한 2 바이트를 기입합니다. 위치의 값은 그때마다 2 두개증가합니다.
value - 기입해지는 short 치
BufferOverflowException - 이 버퍼내에 남아 있는 바이트수가 2 바이트보다 적은 경우public abstract short getShort(int index)
지정된 인덱스 위치에 있는 2 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 short 치로 변환합니다.
index - 바이트의 read 위치를 나타내는 인덱스
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 1 을 뺀 값이상인 경우
public abstract ByteBuffer putShort(int index,
short value)
이 버퍼의 지정된 인덱스 위치에, 현재의 바이트 순서에 따라, 지정된 short 치를 포함한 2 바이트를 기입합니다.
index - 바이트의 기입처를 나타내는 인덱스value - 기입해지는 short 치
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 1 을 뺀 값이상인 경우public abstract ShortBuffer asShortBuffer()
새로운 버퍼의 내용은 이 버퍼의 현재 위치로부터 시작됩니다. 이 버퍼의 내용으로 변경을 더하면(자), 그 내용이 새로운 버퍼에 반영됩니다. 역의 경우도 같습니다. 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 다릅니다.
새로운 버퍼의 위치는 0, 용량과 리밋트는 이 버퍼내에 남아 있는 바이트수의 것 1/2 이 됩니다. 마크는 정의되지 않습니다. 새로운 버퍼는 이 버퍼가 다이렉트 버퍼인 경우에 한해 다이렉트 버퍼가 됩니다. 또, 이 버퍼가 읽어들여 전용 버퍼인 경우에 한해 read 전용 버퍼가 됩니다.
public abstract int getInt()
이 버퍼의 현재 위치로부터 4 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 int 치로 변환합니다. 위치의 값은 그때마다 4 두개증가합니다.
BufferUnderflowException - 이 버퍼내에 남아 있는 바이트수가 4 바이트보다 적은 경우public abstract ByteBuffer putInt(int value)
이 버퍼의 현재 위치에, 현재의 바이트 순서에 따라, 지정된 int 치를 포함한 4 바이트를 기입합니다. 위치의 값은 그때마다 4 두개증가합니다.
value - 기입해지는 int 치
BufferOverflowException - 이 버퍼내에 남아 있는 바이트수가 4 바이트보다 적은 경우public abstract int getInt(int index)
지정된 인덱스 위치에 있는 4 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 int 치로 변환합니다.
index - 바이트의 read 위치를 나타내는 인덱스
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 3 을 뺀 값이상인 경우
public abstract ByteBuffer putInt(int index,
int value)
이 버퍼의 지정된 인덱스 위치에, 현재의 바이트 순서에 따라, 지정된 int 치를 포함한 4 바이트를 기입합니다.
index - 바이트의 기입처를 나타내는 인덱스value - 기입해지는 int 치
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 3 을 뺀 값이상인 경우public abstract IntBuffer asIntBuffer()
새로운 버퍼의 내용은 이 버퍼의 현재 위치로부터 시작됩니다. 이 버퍼의 내용으로 변경을 더하면(자), 그 내용이 새로운 버퍼에 반영됩니다. 역의 경우도 같습니다. 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 다릅니다.
새로운 버퍼의 위치는 0, 용량과 리밋트는 이 버퍼내에 남아 있는 바이트수의 것 1/4 이 됩니다. 마크는 정의되지 않습니다. 새로운 버퍼는 이 버퍼가 다이렉트 버퍼인 경우에 한해 다이렉트 버퍼가 됩니다. 또, 이 버퍼가 읽어들여 전용 버퍼인 경우에 한해 read 전용 버퍼가 됩니다.
public abstract long getLong()
이 버퍼의 현재 위치로부터 8 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 long 치로 변환합니다. 위치의 값은 그때마다 8 두개증가합니다.
BufferUnderflowException - 이 버퍼내에 남아 있는 바이트수가 8 바이트보다 적은 경우public abstract ByteBuffer putLong(long value)
이 버퍼의 현재 위치에, 현재의 바이트 순서에 따라, 지정된 long 치를 포함한 8 바이트를 기입합니다. 위치의 값은 그때마다 8 두개증가합니다.
value - 기입해지는 long 치
BufferOverflowException - 이 버퍼내에 남아 있는 바이트수가 8 바이트보다 적은 경우public abstract long getLong(int index)
지정된 인덱스 위치에 있는 8 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 long 치로 변환합니다.
index - 바이트의 read 위치를 나타내는 인덱스
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 7 을 뺀 값이상인 경우
public abstract ByteBuffer putLong(int index,
long value)
이 버퍼의 지정된 인덱스 위치에, 현재의 바이트 순서에 따라, 지정된 long 치를 포함한 8 바이트를 기입합니다.
index - 바이트의 기입처를 나타내는 인덱스value - 기입해지는 long 치
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 7 을 뺀 값이상인 경우public abstract LongBuffer asLongBuffer()
새로운 버퍼의 내용은 이 버퍼의 현재 위치로부터 시작됩니다. 이 버퍼의 내용으로 변경을 더하면(자), 그 내용이 새로운 버퍼에 반영됩니다. 역의 경우도 같습니다. 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 다릅니다.
새로운 버퍼의 위치는 0, 용량과 리밋트는 이 버퍼내에 남아 있는 바이트수의 것 1/8 이 됩니다. 마크는 정의되지 않습니다. 새로운 버퍼는 이 버퍼가 다이렉트 버퍼인 경우에 한해 다이렉트 버퍼가 됩니다. 또, 이 버퍼가 읽어들여 전용 버퍼인 경우에 한해 read 전용 버퍼가 됩니다.
public abstract float getFloat()
이 버퍼의 현재 위치로부터 4 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 float 치로 변환합니다. 위치의 값은 그때마다 4 두개증가합니다.
BufferUnderflowException - 이 버퍼내에 남아 있는 바이트수가 4 바이트보다 적은 경우public abstract ByteBuffer putFloat(float value)
이 버퍼의 현재 위치에, 현재의 바이트 순서에 따라, 지정된 float 치를 포함한 4 바이트를 기입합니다. 위치의 값은 그때마다 4 두개증가합니다.
value - 기입해지는 float 치
BufferOverflowException - 이 버퍼내에 남아 있는 바이트수가 4 바이트보다 적은 경우public abstract float getFloat(int index)
지정된 인덱스 위치에 있는 4 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 float 치로 변환합니다.
index - 바이트의 read 위치를 나타내는 인덱스
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 3 을 뺀 값이상인 경우
public abstract ByteBuffer putFloat(int index,
float value)
이 버퍼의 지정된 인덱스 위치에, 현재의 바이트 순서에 따라, 지정된 float 치를 포함한 4 바이트를 기입합니다.
index - 바이트의 기입처를 나타내는 인덱스value - 기입해지는 float 치
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 3 을 뺀 값이상인 경우public abstract FloatBuffer asFloatBuffer()
새로운 버퍼의 내용은 이 버퍼의 현재 위치로부터 시작됩니다. 이 버퍼의 내용으로 변경을 더하면(자), 그 내용이 새로운 버퍼에 반영됩니다. 역의 경우도 같습니다. 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 다릅니다.
새로운 버퍼의 위치는 0, 용량과 리밋트는 이 버퍼내에 남아 있는 바이트수의 것 1/4 이 됩니다. 마크는 정의되지 않습니다. 새로운 버퍼는 이 버퍼가 다이렉트 버퍼인 경우에 한해 다이렉트 버퍼가 됩니다. 또, 이 버퍼가 읽어들여 전용 버퍼인 경우에 한해 read 전용 버퍼가 됩니다.
public abstract double getDouble()
이 버퍼의 현재 위치로부터 8 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 double 치로 변환합니다. 위치의 값은 그때마다 8 두개증가합니다.
BufferUnderflowException - 이 버퍼내에 남아 있는 바이트수가 8 바이트보다 적은 경우public abstract ByteBuffer putDouble(double value)
이 버퍼의 현재 위치에, 현재의 바이트 순서에 따라, 지정된 double 치를 포함한 8 바이트를 기입합니다. 위치의 값은 그때마다 8 두개증가합니다.
value - 기입해지는 double 치
BufferOverflowException - 이 버퍼내에 남아 있는 바이트수가 8 바이트보다 적은 경우public abstract double getDouble(int index)
지정된 인덱스 위치에 있는 8 바이트를 읽어들여, 현재의 바이트 순서에 따라, 이것들을 double 치로 변환합니다.
index - 바이트의 read 위치를 나타내는 인덱스
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 7 을 뺀 값이상인 경우
public abstract ByteBuffer putDouble(int index,
double value)
이 버퍼의 지정된 인덱스 위치에, 현재의 바이트 순서에 따라, 지정된 double 치를 포함한 8 바이트를 기입합니다.
index - 바이트의 기입처를 나타내는 인덱스value - 기입해지는 double 치
IndexOutOfBoundsException - index 가 부의 수인 경우, 또는 버퍼의 리밋트로부터 7 을 뺀 값이상인 경우public abstract DoubleBuffer asDoubleBuffer()
새로운 버퍼의 내용은 이 버퍼의 현재 위치로부터 시작됩니다. 이 버퍼의 내용으로 변경을 더하면(자), 그 내용이 새로운 버퍼에 반영됩니다. 역의 경우도 같습니다. 2 개의 버퍼의 위치, 리밋트, 마크의 값은 각각 다릅니다.
새로운 버퍼의 위치는 0, 용량과 리밋트는 이 버퍼내에 남아 있는 바이트수의 것 1/8 이 됩니다. 마크는 정의되지 않습니다. 새로운 버퍼는 이 버퍼가 다이렉트 버퍼인 경우에 한해 다이렉트 버퍼가 됩니다. 또, 이 버퍼가 읽어들여 전용 버퍼인 경우에 한해 read 전용 버퍼가 됩니다.
|
JavaTM 2 Platform Std. Ed. v1. 4.0 |
||||||||||
| 전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음 | ||||||||||
| 개요: 상자 | 필드 | constructor | 메소드 | 상세: 필드 | constructor | 메소드 | ||||||||||
Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.