KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

ByteBuffer — binaire gegevens en bufferstatus

ByteBuffer slaat bytes op en ondersteunt het lezen en schrijven van binaire waarden. Leer hoe je een buffer maakt, de bytevolgorde instelt en position en limit beheert met flip, clear en compact.

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

Syntax

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 is een bytebuffer met een vaste capaciteit, die ook voor I/O wordt gebruikt. ByteBuffer.allocate(n) maakt een buffer met een array als onderliggende opslag, terwijl ByteBuffer.wrap(array) een bestaande array deelt zonder deze te kopiëren. ByteBuffer.allocateDirect(n) maakt een directe buffer: de JVM probeert kopiëren tijdens native I/O te verminderen, maar garandeert geen hogere snelheid. ByteBuffer.isDirect() herkent dit buffertype.

ByteBuffer.capacity() geeft de vaste capaciteit in bytes terug. ByteBuffer.position() geeft de volgende byte aan en ByteBuffer.limit() de eerste niet-toegankelijke index; overloads met een argument stellen deze waarden in. De invariant is 0 <= position <= limit <= capacity, en ByteBuffer.remaining() is gelijk aan limit - position.

ByteBuffer.put en ByteBuffer.get schrijven en lezen bytes. ByteBuffer.putInt / ByteBuffer.getInt verwerken 4 bytes en ByteBuffer.putShort / ByteBuffer.getShort 2 bytes. Relatieve bewerkingen verhogen de position; overloads met een index doen dat niet, maar houden zich nog steeds aan de limit. ByteBuffer.order() haalt de bytevolgorde op en order(ByteOrder.LITTLE_ENDIAN) wijzigt deze; standaard is de volgorde BIG_ENDIAN. Als er bij een relatieve bewerking onvoldoende ruimte of gegevens zijn, volgt respectievelijk een BufferOverflowException of BufferUnderflowException.

Na het schrijven stelt ByteBuffer.flip() de limit in op de vorige position en de position op nul. ByteBuffer.compact() verplaatst ongelezen bytes naar het begin, stelt de position in direct na die bytes en de limit op de capaciteit, zodat er meer gegevens kunnen worden toegevoegd. ByteBuffer.clear() stelt de position in op nul en de limit op de capaciteit, maar wist de gegevens niet. Gelijktijdige toegang tot een buffer vereist synchronisatie.

Voorbeelden

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

Resultaat

7 8 8
16909060 7
2 9 10
0 8

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen