CKTIS / Java
StringBuilder: capacità, risultati immutabili e riuso del buffer
Dimensiona un buffer di testo mutabile, conserva risultati immutabili e assegna un buffer a ogni thread. Formatta ogni byte con due cifre esadecimali.
Versione: Java SE 21
Sintassi
StringBuilder(int capacity)
StringBuilder append(String str)
StringBuilder append(int i)
StringBuilder append(char c)
String toString()
void setLength(int newLength)
int length() // StringBuilder and String
int capacity() // StringBuilderIn Java SE 21, StringBuilder(int) del package java.lang crea un buffer vuoto: length() parte da 0 e capacity() indica la capacità iniziale in unità di codice UTF-16. La capacità non è un limite di lunghezza: il buffer cresce quando serve. Una capacità negativa causa una NegativeArraySizeException.
append(String) aggiunge testo (un argomento null di tipo String aggiunge null), append(int) aggiunge la rappresentazione decimale e append(char) aggiunge un'unità di codice. Ogni overload restituisce lo stesso buffer, quindi le chiamate si possono concatenare. toString() fissa il contenuto corrente in una String immutabile, che le modifiche successive al buffer non alterano.
setLength(0) svuota logicamente il buffer prima di produrre il risultato successivo con append(...) e toString(). Non è una richiesta di ridurre la capacità né un modo per cancellare i dati in sicurezza. Accorciare conserva il prefisso, allungare aggiunge U+0000 e una lunghezza negativa causa una IndexOutOfBoundsException. StringBuilder non è thread-safe: ogni thread di lavoro produce quattro righe con il proprio buffer e il thread principale legge le stringhe ottenute dopo join().
In esadecimale senza separatori, ogni byte occupa esattamente due cifre. Math.multiplyExact(bytes.length, 2) calcola la capacità iniziale e causa una ArithmeticException se il risultato non è rappresentabile come int. Byte.toUnsignedInt restituisce un valore da 0 a 255; i quattro bit alti e i quattro bassi selezionano ciascuno una cifra esadecimale minuscola. Nel risultato, String.length() conta le unità di codice UTF-16, non i byte in ingresso.
Esempi
public class BuilderDemo {
private static final String HEX = "0123456789abcdef";
private static void writeRows(String worker, String[] rows) {
StringBuilder line = new StringBuilder(8);
for (int i = 0; i < rows.length; i++) {
line.setLength(0);
rows[i] = line.append(worker).append(":").append(i + 1).toString();
}
}
private static String toHex(byte[] bytes) {
StringBuilder hex = new StringBuilder(Math.multiplyExact(bytes.length, 2));
for (byte b : bytes) {
int value = Byte.toUnsignedInt(b);
hex.append(HEX.charAt(value >>> 4));
hex.append(HEX.charAt(value & 0x0f));
}
return hex.toString();
}
public static void main(String[] args) throws InterruptedException {
String[] aRows = new String[4];
String[] bRows = new String[4];
Thread a = new Thread(() -> writeRows("A", aRows));
Thread b = new Thread(() -> writeRows("B", bRows));
a.start();
b.start();
a.join();
b.join();
for (String row : aRows) System.out.println(row);
for (String row : bRows) System.out.println(row);
String hex = toHex(new byte[] {0x00, 0x0f, (byte) 0xa5, (byte) 0xff});
System.out.println("hex=" + hex + ", length=" + hex.length());
}
}Risultato
A:1 A:2 A:3 A:4 B:1 B:2 B:3 B:4 hex=000fa5ff, length=8
Ogni thread di lavoro riusa il proprio buffer per quattro righe. Dopo `join()`, il thread principale stampa prima le righe di A e poi quelle di B, a prescindere dall'ordine di esecuzione. I quattro byte producono `000fa5ff`, di lunghezza `8`.
Lezioni correlate
- Java · Lezione 28 · Avanzato · Versione: 2
- Java · Lezione 35 · Avanzato · Versione: 2
- Java · Lezione 62 · Avanzato · Versione: 2