CKTIS / Java
StringBuilder: капацитет, неизменяеми резултати и повторна употреба
Задай капацитета на изменяем текстов буфер, запази неизменяеми резултати и използвай отделен буфер за всяка нишка. Запиши всеки байт с две шестнадесетични цифри.
Версия: Java SE 21
Синтаксис
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() // StringBuilderВ Java SE 21 StringBuilder(int) от пакета java.lang създава празен буфер: length() започва от 0, а capacity() показва началния капацитет в кодови единици UTF-16. Капацитетът не е ограничение на дължината: буферът нараства при нужда. Отрицателен капацитет предизвиква NegativeArraySizeException.
append(String) добавя текст (аргумент null от тип String добавя текста null), append(int) добавя десетичния запис, а append(char) добавя една кодова единица. Всеки от тези варианти връща същия буфер, така че извикванията могат да се свързват във верига. toString() запазва текущото съдържание като неизменяем String, който не се влияе от по-късни промени в буфера.
setLength(0) изпразва логически буфера, преди с append(...) и toString() да се създаде следващият резултат. Това не е заявка за намаляване на капацитета и не осигурява сигурно изтриване на данните. Скъсяването запазва началната част, удължаването добавя U+0000, а отрицателна дължина предизвиква IndexOutOfBoundsException. StringBuilder не е безопасен при едновременна употреба от няколко нишки: всяка работна нишка съставя четири реда в собствен буфер, а главната нишка чете готовите низове след join().
В шестнадесетичен запис без разделители всеки байт заема точно две цифри. Math.multiplyExact(bytes.length, 2) изчислява началния капацитет и предизвиква ArithmeticException, ако резултатът не се побира в int. Byte.toUnsignedInt дава стойност от 0 до 255; старшите и младшите четири бита избират по една шестнадесетична цифра, като буквите са малки. String.length() брои кодовите единици UTF-16 в резултата, а не входните байтове.
Примери
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());
}
}Резултат
A:1 A:2 A:3 A:4 B:1 B:2 B:3 B:4 hex=000fa5ff, length=8
Всяка работна нишка използва повторно собствения си буфер за четири реда. След `join()` главната нишка отпечатва първо редовете на A, после тези на B, независимо от реда на изпълнение. Четирите байта дават `000fa5ff` с дължина `8`.
Свързани уроци
- Java · Урок 28 · Напреднало · Версия: 2
- Java · Урок 35 · Напреднало · Версия: 2
- Java · Урок 62 · Напреднало · Версия: 2