CKTIS / Java
ByteBuffer — datos binarios y estado del búfer
ByteBuffer almacena bytes y permite leer y escribir valores binarios. Aprende a crear un búfer, establecer el orden de los bytes y controlar position y limit con flip, clear y compact.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
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 es un búfer de bytes de capacidad fija que también se utiliza para operaciones de E/S. ByteBuffer.allocate(n) crea un búfer respaldado por un array, mientras que ByteBuffer.wrap(array) comparte un array existente sin copiarlo. ByteBuffer.allocateDirect(n) crea un búfer directo: la JVM intenta reducir las copias durante la E/S nativa, pero no garantiza un mayor rendimiento. ByteBuffer.isDirect() identifica este tipo de búfer.
ByteBuffer.capacity() devuelve la capacidad fija en bytes. ByteBuffer.position() señala el siguiente byte y ByteBuffer.limit() el primer índice inaccesible; las sobrecargas que reciben un argumento establecen estos valores. Se cumple 0 <= position <= limit <= capacity, y ByteBuffer.remaining() equivale a limit - position.
ByteBuffer.put y ByteBuffer.get escriben y leen bytes. ByteBuffer.putInt / ByteBuffer.getInt procesan 4 bytes, y ByteBuffer.putShort / ByteBuffer.getShort procesan 2. Las operaciones relativas avanzan la posición; las sobrecargas indexadas no la cambian, pero siguen respetando el límite. ByteBuffer.order() obtiene el orden de los bytes y order(ByteOrder.LITTLE_ENDIAN) lo cambia; el valor predeterminado es BIG_ENDIAN. Si no hay espacio o datos suficientes en una operación relativa, se produce BufferOverflowException o BufferUnderflowException, respectivamente.
Después de escribir, ByteBuffer.flip() establece el límite en la posición anterior y la posición en cero. ByteBuffer.compact() mueve los bytes no leídos al principio, coloca la posición justo después de ellos y establece el límite en la capacidad, lo que permite añadir más datos. ByteBuffer.clear() establece la posición en cero y el límite en la capacidad, pero no borra los datos. El acceso concurrente a un búfer requiere sincronización.
Ejemplos
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());
}
}
Resultado
7 8 8 16909060 7 2 9 10 0 8
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.