Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Čtení bajtů UTF-8 a pohledy na CharBuffer jen pro čtení

Přečtěte všechny bajty vrácené kodérem UTF-8 a znovu si prohlédněte obsah zpracovaného CharBuffer přes pohled jen pro čtení s vlastní pozicí.

Verze: Java SE 21

Syntaxe

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

V Java SE 21 je aktivní rozsah vyrovnávací paměti java.nio dán jako [position(), limit()): pozice označuje začátek a limit do rozsahu nepatří. remaining() vrací limit() - position(), u ByteBuffer v bajtech a u CharBuffer v kódových jednotkách UTF-16 (char), nikoli v kódových bodech Unicode. position(int) přijímá 0..limit(), limit(int) přijímá 0..capacity() a podle potřeby sníží pozici. Neplatná hodnota vyvolá IllegalArgumentException.

StandardCharsets.UTF_8.newEncoder().encode(cb) zakóduje aktivní rozsah. Po úspěchu je pozice cb na limitu, ale znaky se nesmažou. Vrácený ByteBuffer je připraven ke čtení: pozice je nula a limit značí konec zakódovaných bajtů. Nevolejte na něm flip(). Ke čtení všech bajtů vytvořte byte[] bytes = new byte[encoded.remaining()] a zavolejte encoded.get(bytes). Chybně utvořený vstup kodér ve výchozím nastavení hlásí pomocí CharacterCodingException.

ByteBuffer.wrap(array) sdílí pole bajtů bez kopírování: pozice je nula a limit i kapacita jsou array.length. wrap(array, offset, length) zachová kapacitu celého pole, ale nastaví pozici na offset a limit na offset + length. Neplatný rozsah vyvolá IndexOutOfBoundsException. Relativní get() přečte jeden bajt, get(dst) naplní cílové pole a get(dst, offset, length) zkopíruje length bajtů od zadaného indexu v cíli. Tyto metody posunou pozici a při nedostatku bajtů vyvolají BufferUnderflowException bez částečného přenosu. Absolutní get(index) a get(index, dst[, offset, length]) pozici nemění a neplatný index či rozsah způsobí IndexOutOfBoundsException.

asReadOnlyBuffer() sdílí obsah a přebírá počáteční hodnoty pozice, limitu a značky, které se poté mění nezávisle. put na pohledu vyvolá ReadOnlyBufferException, ale zápisy do zapisovatelné paměti jsou v pohledu vidět. Pohled vytvořený po kódování má zprvu remaining() == 0. rewind() nastaví jeho pozici na nulu a zahodí značku, aniž změní limit. Pokud původní začátek nebyl na nule, nastavte ho výslovně, chcete-li znovu přečíst stejný rozsah.

slice() sdílí zbývající rozsah bez posunu zdrojové paměti. Nová pozice je nula, limit a kapacita odpovídají délce rozsahu, značka není nastavena a režim jen pro čtení se zachová. slice(index, length) používá absolutní index v paměti, nikoli posun od pozice. Rozsah se musí vejít do [0, limit()); prázdný rozsah může začínat na limitu. charAt(i) přečte char na position() + i bez posunu a vyžaduje 0 <= i < remaining(). Neplatný rozsah slice nebo index charAt vyvolá IndexOutOfBoundsException. toString() vrátí neměnný String z aktivního rozsahu, aniž změní pozici.

Příklady

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

Výsledek

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

Tři hodnoty `char` vytvoří čtyři bajty UTF-8. Po zápisu do původní paměti pohled na výřez ukazuje `ZB`, zatímco dřívější String stále obsahuje `AB`.

Související lekce

  • Java · Lekce 51 · Pokročilá · Verze: 2

Zdroje