CKTIS / Java
ByteBuffer — двоични данни и състояние на буфера
ByteBuffer съхранява байтове и позволява четене и записване на двоични стойности. Научете как да създавате буфер, да задавате реда на байтовете и да управлявате position и limit с flip, clear и compact.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
ByteBuffer b = ByteBuffer.allocate(capacity).order(ByteOrder.BIG_ENDIAN);
b.putInt(value).putShort((short) count);
b.flip();
int valueRead = b.getInt();
short countRead = b.getShort();java.nio.ByteBuffer е буфер с байтове и фиксиран капацитет, който се използва и за I/O. ByteBuffer.allocate(n) създава буфер с масив като основа, а ByteBuffer.wrap(array) споделя съществуващ масив без копиране. ByteBuffer.allocateDirect(n) създава директен буфер: JVM се опитва да намали копирането при нативен I/O, но не гарантира по-висока скорост. ByteBuffer.isDirect() разпознава този вид буфер.
ByteBuffer.capacity() връща фиксирания капацитет в байтове. ByteBuffer.position() обозначава следващия байт, а ByteBuffer.limit() — първия недостъпен индекс; претоварените методи с аргумент задават тези стойности. В сила е 0 <= position <= limit <= capacity, а ByteBuffer.remaining() е равно на limit - position.
ByteBuffer.put и ByteBuffer.get записват и четат байтове. ByteBuffer.putInt / ByteBuffer.getInt обработват 4 байта, а ByteBuffer.putShort / ByteBuffer.getShort — 2 байта. Относителните операции придвижват позицията; претоварените методи с индекс не я променят, но продължават да спазват лимита. ByteBuffer.order() извлича реда на байтовете, а order(ByteOrder.LITTLE_ENDIAN) го променя; по подразбиране е BIG_ENDIAN. Ако при относителна операция няма достатъчно място или данни, съответно възниква BufferOverflowException или BufferUnderflowException.
След записване ByteBuffer.flip() задава лимита на предишната позиция и позицията на нула. ByteBuffer.compact() премества непрочетените байтове в началото, задава позицията непосредствено след тях и лимита на капацитета, така че да могат да се добавят още данни. ByteBuffer.clear() задава позицията на нула и лимита на капацитета, но не изтрива данните. Едновременният достъп до буфер изисква синхронизация.
Примери
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
public class Main {
public static void main(String[] args) {
ByteBuffer b = ByteBuffer.allocate(8).order(ByteOrder.LITTLE_ENDIAN);
b.putInt(16909060).putShort((short) 7).put((byte) 9);
System.out.println(b.position() + " " + b.limit() + " " + b.capacity());
b.flip();
System.out.println(b.getInt() + " " + b.getShort());
b.compact();
b.put((byte) 10);
b.flip();
System.out.println(b.remaining() + " " + b.get() + " " + b.get());
b.clear();
System.out.println(b.position() + " " + b.limit());
}
}
Резултат
7 8 8 16909060 7 2 9 10 0 8
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.