База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Четене на UTF-8 байтове и изгледи на CharBuffer само за четене

Прочетете всички байтове, върнати от UTF-8 кодиращия модул, и разгледайте обработения CharBuffer чрез изглед само за четене с независима позиция.

Версия: Java SE 21

Синтаксис

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

В Java SE 21 активният диапазон на буфер от java.nio е [position(), limit()): позицията е началото, а границата не е включена. remaining() връща limit() - position() в байтове за ByteBuffer и в кодови единици UTF-16 (char), а не в кодови точки на Unicode, за CharBuffer. position(int) приема 0..limit(), а limit(int) приема 0..capacity() и при нужда намалява позицията. Невалидна стойност предизвиква IllegalArgumentException.

StandardCharsets.UTF_8.newEncoder().encode(cb) кодира активния диапазон. При успех позицията на cb достига границата, без знаците да се изтриват. Върнатият ByteBuffer е готов за четене: позицията е нула, а границата отбелязва края на кодираните байтове. Не извиквайте flip() върху него. За да прочетете всички байтове, създайте byte[] bytes = new byte[encoded.remaining()] и извикайте encoded.get(bytes). По подразбиране кодиращият модул съобщава за неправилно формиран вход чрез CharacterCodingException.

ByteBuffer.wrap(array) споделя масива от байтове без копиране: позицията е нула, а границата и капацитетът са array.length. wrap(array, offset, length) запазва капацитета на целия масив, но задава позиция offset и граница offset + length. Невалиден диапазон предизвиква IndexOutOfBoundsException. Относителният get() чете един байт, get(dst) запълва целевия масив, а get(dst, offset, length) копира length байта от посочения индекс в целевия масив нататък. Тези методи преместват позицията и при недостиг на байтове хвърлят BufferUnderflowException без частично прехвърляне. Абсолютните варианти get(index) и get(index, dst[, offset, length]) не променят позицията и хвърлят IndexOutOfBoundsException при невалиден индекс или диапазон.

asReadOnlyBuffer() споделя съдържанието и взема текущите позиция, граница и отметка като начални стойности; след това те са независими. put през изгледа предизвиква ReadOnlyBufferException, но записите през буфера, който позволява запис, се виждат в изгледа. Изглед, създаден след кодирането, първоначално има remaining() == 0. rewind() задава позицията му на нула и премахва отметката, без да променя границата. За да прочетете повторно същия диапазон, задайте изрично предишната начална позиция, ако тя не е била нула.

slice() споделя оставащия диапазон, без да премества позицията на изходния буфер. Новата позиция е нула, границата и капацитетът са равни на дължината на диапазона, отметката е неопределена и режимът само за четене се запазва. slice(index, length) използва абсолютен индекс в буфера, а не отместване от позицията. Диапазонът трябва да се побира в [0, limit()); празен диапазон може да започва на границата. charAt(i) чете char на position() + i без преместване и изисква 0 <= i < remaining(). Невалиден диапазон за slice или индекс за charAt предизвиква IndexOutOfBoundsException. toString() връща неизменим String от активния диапазон, без да променя позицията.

Примери

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

Резултат

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

Три стойности `char` дават четири UTF-8 байта. След запис в първоначалния буфер изгледът на поддиапазона показва `ZB`, а по-рано създаденият String все още съдържа `AB`.

Свързани уроци

  • Java · Урок 51 · Напреднало · Версия: 2

Източници