Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

ByteBuffer — dati binari e stato del buffer

ByteBuffer memorizza byte e consente di leggere e scrivere valori binari. Scopri come creare un buffer, impostare l’ordine dei byte e controllare position e limit con flip, clear e compact.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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 è un buffer di byte a capacità fissa, usato anche per le operazioni di I/O. ByteBuffer.allocate(n) crea un buffer basato su un array, mentre ByteBuffer.wrap(array) condivide un array esistente senza copiarlo. ByteBuffer.allocateDirect(n) crea un buffer diretto: la JVM tenta di ridurre le copie durante l’I/O nativo, ma non garantisce prestazioni superiori. ByteBuffer.isDirect() identifica questo tipo di buffer.

ByteBuffer.capacity() restituisce la capacità fissa in byte. ByteBuffer.position() indica il byte successivo e ByteBuffer.limit() il primo indice non accessibile; gli overload che ricevono un argomento impostano questi valori. Vale l’invariante 0 <= position <= limit <= capacity e ByteBuffer.remaining() equivale a limit - position.

ByteBuffer.put e ByteBuffer.get scrivono e leggono byte. ByteBuffer.putInt / ByteBuffer.getInt gestiscono 4 byte, mentre ByteBuffer.putShort / ByteBuffer.getShort ne gestiscono 2. Le operazioni relative avanzano la posizione; gli overload indicizzati non la modificano, ma rispettano comunque il limite. ByteBuffer.order() recupera l’ordine dei byte e order(ByteOrder.LITTLE_ENDIAN) lo modifica; quello predefinito è BIG_ENDIAN. Se in un’operazione relativa lo spazio o i dati non sono sufficienti, viene generata rispettivamente una BufferOverflowException o una BufferUnderflowException.

Dopo la scrittura, ByteBuffer.flip() imposta il limite sulla posizione precedente e la posizione a zero. ByteBuffer.compact() sposta i byte non letti all’inizio, imposta la posizione subito dopo di essi e il limite alla capacità, consentendo di aggiungere altri dati. ByteBuffer.clear() imposta la posizione a zero e il limite alla capacità, ma non cancella i dati. L’accesso concorrente a un buffer richiede sincronizzazione.

Esempi

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());
    }
}

Risultato

7 8 8
16909060 7
2 9 10
0 8

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti