CKTIS / Java
StringBuilder: pojemność, zapis i ponowne użycie bufora
Twórz bufory o dobranej pojemności, zachowuj wyniki jako niezmienne napisy i używaj oddzielnych buforów w wątkach. Formatuj każdy bajt jako dwie cyfry szesnastkowe.
Wersja: Java SE 21
Składnia
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() // StringBuilderW Java SE 21 konstruktor StringBuilder(int) z pakietu java.lang tworzy pusty bufor: length() zwraca 0, a capacity() podaje początkową pojemność w jednostkach kodowych UTF-16. Pojemność nie jest limitem długości: bufor rośnie w razie potrzeby. Ujemna pojemność powoduje NegativeArraySizeException.
append(String) dopisuje tekst (dla argumentu null typu String dopisuje null), append(int) dopisuje zapis dziesiętny, a append(char) dopisuje jedną jednostkę kodową. Każde z tych przeciążeń zwraca ten sam bufor, więc wywołania można łączyć. toString() utrwala bieżącą zawartość w niezmiennym String, którego późniejsze zmiany bufora nie zmienią.
setLength(0) opróżnia bufor logicznie, aby można było ponownie wywołać append(...) i toString(). To nie jest żądanie zmniejszenia pojemności ani metoda bezpiecznego wymazywania danych. Skrócenie zachowuje prefiks, wydłużenie dodaje U+0000, a ujemna długość powoduje IndexOutOfBoundsException. StringBuilder nie jest bezpieczny w użyciu współbieżnym: każdy wątek roboczy buduje cztery wiersze we własnym buforze, a wątek główny odczytuje gotowe napisy po join().
W zapisie hex bez separatorów każdy bajt zajmuje dokładnie dwie cyfry. Math.multiplyExact(bytes.length, 2) oblicza początkową pojemność i zgłasza ArithmeticException, jeśli wynik nie mieści się w int. Byte.toUnsignedInt daje wartość od 0 do 255; górne i dolne cztery bity wybierają po jednej małej cyfrze hex. Wynikowe String.length() liczy jednostki kodowe UTF-16, nie bajty wejściowe.
Przykłady
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());
}
}Wynik
A:1 A:2 A:3 A:4 B:1 B:2 B:3 B:4 hex=000fa5ff, length=8
Każdy wątek roboczy używa jednego bufora do czterech wierszy. Wątek główny po `join()` drukuje najpierw wiersze A, potem B, niezależnie od kolejności wykonania wątków. Cztery bajty dają `000fa5ff` o długości `8`.
Powiązane lekcje
- Java · Lekcja 28 · Zaawansowany · Wersja: 2
- Java · Lekcja 35 · Zaawansowany · Wersja: 2
- Java · Lekcja 62 · Zaawansowany · Wersja: 2