KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

UTF-8-bytes uitlezen en alleen-lezen-weergaven van CharBuffer gebruiken

Lees alle bytes uit die de UTF-8-encoder teruggeeft en bekijk de verwerkte CharBuffer via een alleen-lezen-weergave met een eigen positie.

Versie: 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 is [position(), limit()) het actieve bereik van een java.nio-buffer: de positie is het begin en de limiet telt niet mee. remaining() geeft limit() - position() terug: in bytes voor ByteBuffer en in UTF-16-code-eenheden (char), niet in Unicode-codepunten, voor CharBuffer. position(int) accepteert 0..limit(); limit(int) accepteert 0..capacity() en verlaagt zo nodig de positie. Een ongeldige waarde leidt tot IllegalArgumentException.

StandardCharsets.UTF_8.newEncoder().encode(cb) codeert het actieve bereik. Bij succes schuift cb door tot de limiet zonder de tekens te wissen. De geretourneerde ByteBuffer is klaar om uit te lezen: de positie is nul en de limiet markeert het einde van de gecodeerde bytes. Roep daarop geen flip() aan. Maak voor het uitlezen byte[] bytes = new byte[encoded.remaining()] en roep encoded.get(bytes) aan. De encoder meldt ongeldige invoer standaard via CharacterCodingException.

ByteBuffer.wrap(array) deelt de byte-array zonder kopie: de positie is nul en de limiet en capaciteit zijn array.length. wrap(array, offset, length) behoudt de capaciteit van de hele array, maar stelt de positie in op offset en de limiet op offset + length. Een ongeldig bereik leidt tot IndexOutOfBoundsException. De relatieve methoden get(), get(dst) en get(dst, offset, length) lezen respectievelijk één byte, vullen de doelarray of kopiëren length bytes vanaf de opgegeven index in de doelarray. Ze schuiven de positie op en werpen bij te weinig bytes BufferUnderflowException op zonder iets over te dragen. De absolute varianten get(index) en get(index, dst[, offset, length]) veranderen de positie niet en werpen IndexOutOfBoundsException op bij ongeldige indexen of bereiken.

asReadOnlyBuffer() deelt de inhoud en neemt de huidige positie, limiet en markering over als beginwaarden; daarna zijn die onafhankelijk. put op de weergave geeft ReadOnlyBufferException, maar wijzigingen via de beschrijfbare buffer zijn zichtbaar. Een weergave die na het coderen wordt gemaakt, begint met remaining() == 0. rewind() zet de positie op nul en wist de markering, zonder de limiet aan te passen. Stel een eerdere beginpositie die niet nul was expliciet opnieuw in om hetzelfde bereik te herlezen.

slice() deelt het resterende bereik zonder de bronbuffer te verplaatsen. De nieuwe positie is nul, de limiet en capaciteit zijn de lengte van het bereik, de markering is niet ingesteld en de alleen-lezenstatus blijft behouden. slice(index, length) gebruikt een absolute bufferindex, niet een offset ten opzichte van de positie. Het bereik moet binnen [0, limit()) passen; een leeg bereik mag op de limiet beginnen. charAt(i) leest de char op position() + i zonder op te schuiven en vereist 0 <= i < remaining(). Een ongeldig slice-bereik of een ongeldige charAt-index geeft IndexOutOfBoundsException. toString() levert een onveranderlijke String voor het actieve bereik zonder de positie te wijzigen.

Voorbeelden

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

Resultaat

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

Drie `char`-waarden leveren vier UTF-8-bytes op. Na een wijziging via de oorspronkelijke buffer toont de deelweergave `ZB`, terwijl de eerdere String `AB` bevat.

Gerelateerde lessen

  • Java · Les 51 · Gevorderd · Versie: 2

Bronnen