Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes