Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Čitanje UTF-8 bajtova i prikazi CharBuffer samo za čitanje

Pročitajte sve bajtove koje vraća koder UTF-8, a zatim pregledajte obrađeni CharBuffer putem prikaza samo za čitanje s vlastitom pozicijom.

Verzija: Java SE 21

Sintaksa

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

U izdanju Java SE 21 aktivni raspon međuspremnika java.nio jest [position(), limit()): pozicija označava početak, a granica nije uključena. remaining() vraća limit() - position() u bajtovima za ByteBuffer, odnosno u kodnim jedinicama UTF-16 (char), a ne kodnim točkama Unicodea, za CharBuffer. position(int) prihvaća 0..limit(), a limit(int) prihvaća 0..capacity() i po potrebi smanjuje poziciju. Nevaljana vrijednost izaziva IllegalArgumentException.

StandardCharsets.UTF_8.newEncoder().encode(cb) kodira aktivni raspon. Nakon uspješnog kodiranja pozicija cb dolazi do granice, ali znakovi ostaju. Vraćeni ByteBuffer spreman je za čitanje: pozicija je nula, a granica označava kraj kodiranih bajtova. Nemojte na njemu pozvati flip(). Za čitanje svih bajtova stvorite byte[] bytes = new byte[encoded.remaining()] i pozovite encoded.get(bytes). Koder prema zadanim postavkama prijavljuje nepravilno oblikovan ulaz iznimkom CharacterCodingException.

ByteBuffer.wrap(array) dijeli polje bajtova bez kopiranja: pozicija je nula, a granica i kapacitet su array.length. wrap(array, offset, length) zadržava kapacitet cijelog polja, ali postavlja poziciju na offset i granicu na offset + length. Nevaljani raspon izaziva IndexOutOfBoundsException. Relativni get() čita jedan bajt, get(dst) popunjava odredišno polje, a get(dst, offset, length) kopira length bajtova počevši od zadanog indeksa u odredištu. Pomiču poziciju i, ako nema dovoljno bajtova, izazivaju BufferUnderflowException bez djelomičnog prijenosa. Apsolutne inačice get(index) i get(index, dst[, offset, length]) ne mijenjaju poziciju, a za nevaljane indekse ili raspone izazivaju IndexOutOfBoundsException.

asReadOnlyBuffer() dijeli sadržaj i preuzima trenutačnu poziciju, granicu i oznaku kao početne vrijednosti; nakon toga vrijednosti su neovisne. put kroz prikaz izaziva ReadOnlyBufferException, ali upisi kroz međuspremnik koji dopušta pisanje vidljivi su u prikazu. Prikaz stvoren nakon kodiranja isprva ima remaining() == 0. rewind() postavlja njegovu poziciju na nulu i odbacuje oznaku, ne mijenjajući granicu. Za ponovno čitanje istog raspona izričito postavite prethodnu početnu poziciju ako nije bila nula.

slice() dijeli preostali raspon bez pomicanja pozicije izvornog međuspremnika. Nova je pozicija nula, granica i kapacitet jednaki su duljini raspona, oznaka nije postavljena i način rada samo za čitanje ostaje isti. slice(index, length) koristi apsolutni indeks u međuspremniku, a ne pomak od pozicije. Raspon mora stati u [0, limit()); prazan raspon smije početi na granici. charAt(i) čita char na position() + i bez pomicanja i zahtijeva 0 <= i < remaining(). Nevaljan raspon za slice ili indeks za charAt izaziva IndexOutOfBoundsException. toString() vraća nepromjenjivi String iz aktivnog raspona bez promjene pozicije.

Primjeri

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

Rezultat

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 vrijednosti `char` daju četiri UTF-8 bajta. Nakon upisa u izvorni međuspremnik prikaz isječka pokazuje `ZB`, a raniji String i dalje sadrži `AB`.

Povezane lekcije

  • Java · Lekcija 51 · Napredno · Verzija: 2

Izvori