Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Čítanie bajtov UTF-8 a pohľady na CharBuffer iba na čítanie

Prečítajte všetky bajty vrátené kódovačom UTF-8 a prezrite si spracovaný CharBuffer cez pohľad iba na čítanie s vlastnou pozíciou.

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

V Java SE 21 je aktívny rozsah vyrovnávacej pamäte java.nio daný ako [position(), limit()): pozícia označuje začiatok a limit do rozsahu nepatrí. remaining() vracia limit() - position(), pre ByteBuffer v bajtoch a pre CharBuffer v kódových jednotkách UTF-16 (char), nie v kódových bodoch Unicode. position(int) prijíma 0..limit(); limit(int) prijíma 0..capacity() a podľa potreby zníži pozíciu. Neplatná hodnota vyvolá IllegalArgumentException.

StandardCharsets.UTF_8.newEncoder().encode(cb) zakóduje aktívny rozsah. Po úspechu sa pozícia cb posunie na limit bez vymazania znakov. Vrátený ByteBuffer je pripravený na čítanie: pozícia je nula a limit označuje koniec zakódovaných bajtov. Nevolajte na ňom flip(). Na prečítanie všetkých bajtov vytvorte byte[] bytes = new byte[encoded.remaining()] a zavolajte encoded.get(bytes). Kódovač štandardne hlási chybne utvorený vstup pomocou CharacterCodingException.

ByteBuffer.wrap(array) zdieľa pole bajtov bez kopírovania: pozícia je nula, limit a kapacita sú array.length. wrap(array, offset, length) zachová kapacitu celého poľa, ale nastaví pozíciu na offset a limit na offset + length. Neplatný rozsah vyvolá IndexOutOfBoundsException. Relatívne get() prečíta jeden bajt, get(dst) naplní cieľové pole a get(dst, offset, length) skopíruje length bajtov od zadaného indexu v cieli. Posunú pozíciu a pri nedostatku bajtov vyvolajú BufferUnderflowException bez čiastočného prenosu. Absolútne get(index) a get(index, dst[, offset, length]) pozíciu nemenia a pri neplatných indexoch alebo rozsahoch vyvolajú IndexOutOfBoundsException.

asReadOnlyBuffer() zdieľa obsah a prevezme počiatočné hodnoty pozície, limitu a značky, ktoré sa potom menia nezávisle. put na pohľade vyvolá ReadOnlyBufferException, ale zápisy do zapisovateľnej pamäte sú v pohľade viditeľné. Pohľad vytvorený po kódovaní má najprv remaining() == 0. rewind() nastaví pozíciu pohľadu na nulu a zahodí značku bez zmeny limitu. Ak pôvodná začiatočná pozícia nebola nula, nastavte ju výslovne, aby ste znova prečítali rovnaký rozsah.

slice() zdieľa zostávajúci rozsah bez posunu zdrojovej pamäte. Nová pozícia je nula, limit a kapacita sa rovnajú dĺžke rozsahu, značka nie je nastavená a režim iba na čítanie sa zachová. slice(index, length) používa absolútny index v pamäti, nie posun od pozície. Rozsah sa musí zmestiť do [0, limit()); prázdny rozsah môže začínať na limite. charAt(i) prečíta char na position() + i bez posunu a vyžaduje 0 <= i < remaining(). Neplatný rozsah slice alebo index charAt vyvolá IndexOutOfBoundsException. toString() vráti nemenný String z aktívneho rozsahu bez zmeny pozície.

Prí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ýsledok

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

Tri hodnoty `char` vytvoria štyri bajty UTF-8. Po zápise do pôvodnej pamäte pohľad na výrez ukazuje `ZB`, kým skorší String stále obsahuje `AB`.

Súvisiace lekcie

  • Java · Lekcia 51 · Pokročilá · Verzia: 2

Zdroje