CKTIS / Java
Leggere i byte UTF-8 e usare viste CharBuffer di sola lettura
Leggi tutti i byte prodotti dal codificatore UTF-8 e rileggi il CharBuffer consumato tramite una vista di sola lettura con posizione indipendente.
Versione: Java SE 21
Sintassi
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()In Java SE 21, l’intervallo attivo di un buffer java.nio è [position(), limit()): la posizione indica l’inizio, mentre il limite è escluso. remaining() restituisce limit() - position(), in byte per ByteBuffer e in unità di codice UTF-16 (char), non in punti di codice Unicode, per CharBuffer. position(int) accetta 0..limit(); limit(int) accetta 0..capacity() e abbassa la posizione se necessario. Un valore non valido genera IllegalArgumentException.
StandardCharsets.UTF_8.newEncoder().encode(cb) codifica l’intervallo attivo. Se l’operazione riesce, cb avanza fino al limite senza cancellare i caratteri. Il ByteBuffer restituito è pronto per la lettura: la posizione è zero e il limite segna la fine dei byte codificati. Non chiamare flip() su di esso. Per leggere tutti i byte, crea byte[] bytes = new byte[encoded.remaining()] e chiama encoded.get(bytes). Per impostazione predefinita il codificatore segnala un input malformato con CharacterCodingException.
ByteBuffer.wrap(array) condivide l’array di byte senza copiarlo: la posizione è zero, limite e capacità sono array.length. wrap(array, offset, length) mantiene la capacità dell’intero array ma imposta la posizione a offset e il limite a offset + length. Un intervallo non valido genera IndexOutOfBoundsException. Le letture relative get(), get(dst) e get(dst, offset, length) leggono rispettivamente un byte, riempiono l’array di destinazione o copiano length byte a partire dall’offset di destinazione. Fanno avanzare la posizione e, se i byte non bastano, generano BufferUnderflowException senza trasferimento parziale. Le forme assolute get(index) e get(index, dst[, offset, length]) lasciano invariata la posizione e generano IndexOutOfBoundsException per indici o intervalli non validi.
asReadOnlyBuffer() condivide il contenuto e prende come valori iniziali la posizione, il limite e il contrassegno correnti; da quel momento sono indipendenti. put sulla vista genera ReadOnlyBufferException, ma le scritture nel buffer modificabile sono visibili nella vista. Una vista creata dopo la codifica parte con remaining() == 0. rewind() azzera la posizione e scarta il contrassegno senza cambiare il limite. Per rileggere lo stesso intervallo, reimposta esplicitamente la posizione iniziale se non era zero.
slice() condivide l’intervallo rimanente senza spostare il buffer di origine. La nuova posizione è zero, limite e capacità sono pari alla lunghezza dell’intervallo, il contrassegno è indefinito e lo stato di sola lettura si conserva. slice(index, length) usa un indice assoluto del buffer, non un offset relativo alla posizione. L’intervallo deve rientrare in [0, limit()); se vuoto, può iniziare al limite. charAt(i) legge il char a position() + i senza avanzare e richiede 0 <= i < remaining(). Un intervallo slice o un indice charAt non valido genera IndexOutOfBoundsException. toString() restituisce uno String immutabile dell’intervallo attivo senza cambiare la posizione.
Esempi
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());
}
}
Risultato
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
Tre valori `char` producono quattro byte UTF-8. Dopo la scrittura nel buffer originale, la vista della porzione mostra `ZB`, mentre lo String precedente conserva `AB`.
Lezioni correlate
- Java · Lezione 51 · Avanzato · Versione: 2