CKTIS / Java
StringBuilder : capacité, instantanés et réutilisation du tampon
Dimensionnez un tampon de texte mutable, conservez des résultats immuables et utilisez un tampon par thread. Formatez chaque octet sur deux chiffres hexadécimaux.
Version : Java SE 21
Syntaxe
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() // StringBuilderDans Java SE 21, StringBuilder(int), dans java.lang, crée un tampon vide : length() vaut initialement 0 et capacity() indique la capacité initiale en unités de code UTF-16. La capacité n'est pas une limite de longueur : le tampon grandit au besoin. Une capacité négative déclenche une NegativeArraySizeException.
append(String) ajoute du texte (un argument null de type String ajoute null), append(int) ajoute la représentation décimale et append(char) ajoute une unité de code. Chaque surcharge renvoie le même tampon, ce qui permet de chaîner les appels. toString() fige le contenu courant dans une String immuable que les modifications ultérieures du tampon n'affectent pas.
setLength(0) vide logiquement le tampon avant de produire le résultat suivant avec append(...) et toString(). Cette opération ne demande ni de réduire la capacité ni d'effacer les données de manière sûre. Un raccourcissement conserve le préfixe, un allongement ajoute des U+0000 et une longueur négative déclenche une IndexOutOfBoundsException. StringBuilder n'est pas conçu pour les accès concurrents : chaque thread de travail produit quatre lignes dans son propre tampon, puis le thread principal lit les chaînes obtenues après join().
En hexadécimal sans séparateurs, chaque octet occupe exactement deux chiffres. Math.multiplyExact(bytes.length, 2) calcule la capacité initiale et déclenche une ArithmeticException si le résultat ne tient pas dans un int. Byte.toUnsignedInt donne une valeur de 0 à 255 ; les quatre bits de poids fort et les quatre de poids faible sélectionnent chacun un chiffre hexadécimal en minuscules. Sur le résultat, String.length() compte les unités de code UTF-16, pas les octets d'entrée.
Exemples
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());
}
}Résultat
A:1 A:2 A:3 A:4 B:1 B:2 B:3 B:4 hex=000fa5ff, length=8
Chaque thread de travail réutilise son tampon pour quatre lignes. Après `join()`, le thread principal affiche les lignes de A puis celles de B, quel que soit l'ordre d'exécution. Les quatre octets donnent `000fa5ff`, de longueur `8`.
Leçons associées
- Java · Leçon 28 · Avancé · Version : 2
- Java · Leçon 35 · Avancé · Version : 2
- Java · Leçon 62 · Avancé · Version : 2