Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Odczyt bajtów UTF-8 i widoki CharBuffer tylko do odczytu

Odczytaj wszystkie bajty zwrócone przez koder UTF-8 i utwórz widok CharBuffer ze współdzieloną zawartością, ale niezależną pozycją.

Wersja: Java SE 21

Składnia

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

W Java SE 21 zakres bufora java.nio to [position(), limit()): pozycja wskazuje początek, a limit jest wyłączną granicą. remaining() zwraca limit() - position() w bajtach dla ByteBuffer, a w jednostkach kodowych UTF-16 (char) dla CharBuffer, nie w punktach kodowych Unicode. position(int) przyjmuje 0..limit(), a limit(int) przyjmuje 0..capacity() i w razie potrzeby obniża pozycję. Nieprawidłowa wartość powoduje IllegalArgumentException.

StandardCharsets.UTF_8.newEncoder().encode(cb) koduje bieżący zakres. Po udanym kodowaniu pozycja cb osiąga limit, ale zawartość nie znika. Zwrócony ByteBuffer jest gotowy do odczytu: pozycja wynosi zero, a limit wskazuje koniec wyniku. Nie wywołuj na nim flip(). Odczytaj wszystkie bajty przez encoded.get(new byte[encoded.remaining()]), zachowując w praktyce referencję do tablicy. Domyślnie koder zgłasza niepoprawne wejście przez CharacterCodingException.

ByteBuffer.wrap(array) używa tablicy bajtów bez kopiowania: pozycja to zero, a limit i pojemność to array.length. wrap(array, offset, length) nadal ma pojemność całej tablicy, lecz pozycję offset i limit offset + length; nieprawidłowy zakres powoduje IndexOutOfBoundsException. Względne get() odczytuje jeden bajt, get(dst) wypełnia całą tablicę docelową, a get(dst, offset, length) kopiuje length bajtów od podanego indeksu w tablicy docelowej. Te odczyty przesuwają pozycję i przy braku bajtów zgłaszają BufferUnderflowException bez częściowego transferu. Wersje bezwzględne get(index) i get(index, dst[, offset, length]) nie przesuwają pozycji; nieprawidłowy indeks lub zakres powoduje IndexOutOfBoundsException.

asReadOnlyBuffer() współdzieli zawartość i przejmuje początkowe wartości pozycji, limitu i znacznika, ale później te wartości są niezależne. put przez widok zgłasza ReadOnlyBufferException, lecz zapis przez zapisywalny bufor jest widoczny w widoku. Widok utworzony po kodowaniu początkowo ma remaining() == 0. rewind() ustawia pozycję widoku na zero i usuwa znacznik bez zmiany limitu. Nie przywraca poprzedniej pozycji początkowej: jeśli nie była zerem, ustaw ją jawnie, aby ponownie odczytać ten sam zakres.

slice() tworzy widok na pozostały zakres bez przesuwania bufora źródłowego. Nowa pozycja to zero, limit i pojemność są równe długości zakresu, znacznik jest nieustawiony, a tryb tylko do odczytu zostaje zachowany. slice(index, length) zamiast tego używa bezwzględnego indeksu w buforze, nie przesunięcia od pozycji; zakres musi mieścić się w [0, limit()), a pusty zakres może zaczynać się na limicie. charAt(i) odczytuje char pod position() + i bez przesuwania pozycji i wymaga 0 <= i < remaining(). Nieprawidłowy zakres slice(index, length) lub indeks charAt(i) powoduje IndexOutOfBoundsException. toString() zwraca niezmienny String z bieżącego zakresu, bez przesuwania pozycji.

Przykłady

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

Wynik

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

Trzy jednostki `char` dają cztery bajty UTF-8. Po zmianie bufora źródłowego wycinek pokazuje `ZB`, a wcześniej utworzony `String` nadal zawiera `AB`.

Powiązane lekcje

  • Java · Lekcja 51 · Zaawansowany · Wersja: 2

Źródła