WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

UTF-8-Bytes auslesen und schreibgeschützte CharBuffer-Ansichten nutzen

Lies die Bytes des UTF-8-Encoders vollständig aus und greife über eine schreibgeschützte Ansicht mit eigener Position erneut auf den Eingabepuffer zu.

Version: Java SE 21

Syntax

Java SE 21 — java.nio.ByteBuffer
static ByteBuffer wrap(byte[] array)
static ByteBuffer wrap(byte[] array, int offset, int length)
int remaining()
byte get()
ByteBuffer get(byte[] dst)
ByteBuffer get(byte[] dst, int offset, int length)
byte get(int index)
ByteBuffer get(int index, byte[] dst)
ByteBuffer get(int index, byte[] dst, int offset, int length)

java.nio.CharBuffer
CharBuffer asReadOnlyBuffer()
CharBuffer rewind()
int remaining()
int limit()
CharBuffer limit(int newLimit)
int position()
CharBuffer position(int newPosition)
CharBuffer slice()
CharBuffer slice(int index, int length)
char charAt(int index)
String toString()

In Java SE 21 ist [position(), limit()) der aktuelle Bereich eines java.nio-Puffers. Die Position bezeichnet den Anfang, das Limit gehört nicht zum Bereich. remaining() liefert limit() - position(): bei ByteBuffer in Bytes, bei CharBuffer in UTF-16-Codeeinheiten (char), nicht in Unicode-Codepunkten. position(int) akzeptiert 0..limit(), limit(int) akzeptiert 0..capacity() und senkt bei Bedarf die Position. Ungültige Werte führen zu IllegalArgumentException.

StandardCharsets.UTF_8.newEncoder().encode(cb) codiert den aktuellen Bereich. Bei Erfolg steht cb am Limit, ohne dass Zeichen gelöscht wurden. Der zurückgegebene ByteBuffer ist lesebereit: Seine Position ist null, sein Limit markiert das Ende der codierten Bytes. Rufe darauf nicht flip() auf. Lege zum vollständigen Auslesen byte[] bytes = new byte[encoded.remaining()] an und rufe encoded.get(bytes) auf. Fehlerhafte Eingaben meldet der Encoder standardmäßig mit CharacterCodingException.

ByteBuffer.wrap(array) bindet das Byte-Array ohne Kopie ein: Position null, Limit und Kapazität array.length. wrap(array, offset, length) behält die Kapazität des gesamten Arrays, setzt aber die Position auf offset und das Limit auf offset + length. Ein ungültiger Bereich führt zu IndexOutOfBoundsException. Das relative get() liest ein Byte, get(dst) füllt das Zielarray, und get(dst, offset, length) kopiert length Bytes ab dem angegebenen Zieloffset. Diese Aufrufe verschieben die Position; bei zu wenigen Bytes tritt BufferUnderflowException ohne Teilübertragung auf. Die absoluten Varianten get(index) und get(index, dst[, offset, length]) verschieben die Position nicht und melden ungültige Indizes oder Bereiche mit IndexOutOfBoundsException.

asReadOnlyBuffer() teilt den Inhalt und übernimmt die aktuellen Werte für Position, Limit und Marke als Anfangswerte; danach sind diese unabhängig. put über die Ansicht führt zu ReadOnlyBufferException, aber Änderungen am beschreibbaren Puffer sind in der Ansicht sichtbar. Nach dem Codieren hat eine neu erzeugte Ansicht zunächst remaining() == 0. rewind() setzt ihre Position auf null und verwirft die Marke, ohne das Limit zu ändern. Setze einen früheren Start ungleich null ausdrücklich, um denselben Bereich erneut zu lesen.

slice() erstellt eine Ansicht des verbleibenden Bereichs, ohne den Quellpuffer zu verschieben. Die neue Position ist null, Limit und Kapazität entsprechen der Bereichslänge, die Marke ist nicht gesetzt und der Schreibschutz bleibt erhalten. slice(index, length) verwendet einen absoluten Pufferindex statt eines Offsets zur Position. Der Bereich muss in [0, limit()) liegen; ein leerer Bereich darf am Limit beginnen. charAt(i) liest das char bei position() + i ohne Positionsänderung und verlangt 0 <= i < remaining(). Ungültige Slice-Bereiche oder charAt-Indizes führen zu IndexOutOfBoundsException. toString() liefert einen unveränderlichen String aus dem aktuellen Bereich, ohne die Position zu ändern.

Beispiele

import java.nio.ByteBuffer;
import java.nio.CharBuffer;
import java.nio.charset.CharacterCodingException;
import java.nio.charset.StandardCharsets;
import java.util.HexFormat;

public class BufferDemo {
    public static void main(String[] args) throws CharacterCodingException {
        CharBuffer cb = CharBuffer.wrap(new char[] {'[', '\u00E9', 'A', 'B', ']'});
        cb.position(1).limit(4);
        ByteBuffer encoded = StandardCharsets.UTF_8.newEncoder().encode(cb);
        System.out.println("input position=" + cb.position() + ", remaining=" + cb.remaining());

        byte[] bytes = new byte[encoded.remaining()];
        encoded.get(bytes);
        System.out.println("utf8=" + HexFormat.of().formatHex(bytes)
                + ", remaining=" + encoded.remaining());
        ByteBuffer suffix = ByteBuffer.wrap(bytes, 2, 2);
        System.out.println("suffix first=" + suffix.get() + ", remaining=" + suffix.remaining());

        CharBuffer view = cb.asReadOnlyBuffer();
        System.out.println("view initial remaining=" + view.remaining());
        view.rewind().position(2);
        CharBuffer tail = view.slice();
        System.out.println("charAt(0)=" + view.charAt(0) + ", view position=" + view.position()
                + ", input position=" + cb.position() + ", slice position=" + tail.position());

        String snapshot = tail.toString();
        cb.put(2, 'Z');
        System.out.println("snapshot=" + snapshot + ", slice now=" + tail.toString());
    }
}

Ergebnis

input position=4, remaining=0
utf8=c3a94142, remaining=0
suffix first=65, remaining=1
view initial remaining=0
charAt(0)=A, view position=2, input position=4, slice position=0
snapshot=AB, slice now=ZB

Drei `char`-Werte ergeben vier UTF-8-Bytes. Nach dem Schreiben in den Originalpuffer zeigt der Ausschnitt `ZB`; der vorher erzeugte String enthält weiterhin `AB`.

Zugehörige Lektionen

  • Java · Lektion 51 · Fortgeschritten · Version: 2

Quellen