Почему после Stream.toList() нельзя добавить элемент?

При работе со Stream часто нужно собрать результаты обратно в список. Короткая запись выглядит естественно:

var names = Stream.of("Ana", "Bob").toList();

Но у Stream.toList() есть важное свойство, он возвращает немодифицируемый список. Такой код не добавит третье имя:

names.add("Cyd");

Вместо изменения списка программа получит UnsupportedOperationException. То же произойдёт при remove или set.

Если нужен готовый результат только для чтения, это как раз удобно:

List<String> labels = users.stream()
    .map(User::name)
    .toList();

Вызывающий код не сможет случайно поменять состав labels. При этом сами элементы могут оставаться изменяемыми, не модифицируемость списка не делает глубоко неизменяемыми объекты внутри него.

Если список нужно дополнять после сбора, задайте изменяемую коллекцию явно:

var names = Stream.of("Ana", "Bob")
    .collect(Collectors.toCollection(ArrayList::new));

Теперь add и remove доступны. Есть и вариант обернуть готовый результат:

var names = new ArrayList<>(stream.toList());

Выбирайте способ сбора по тому, что будет происходить со списком дальше. Для чтения подойдёт toList(), для дальнейших изменений лучше явно создать ArrayList.

👉 Java Ready | #совет

Безопасная настройка retry для всей системы!

В статье Java-разработчик делится опытом внедрения политики повторных попыток в проекте с Kafka и цепочкой микросервисов. Одной аннотации недостаточно, когда результат операции может оказаться неизвестным, а сообщение пройти обработку дважды.

Автор разбирает:
• какие ошибки имеет смысл повторять, а какие нет
• чем отличаются блокирующие и неблокирующие retry у Kafka consumer
• как повторы на нескольких уровнях создают лишнюю нагрузку

Продолжай читать на Habr!

👉 Java Ready | #статья

Почему split(".") в Java не делит строку по точке?

На первый взгляд кажется, что достаточно передать в split нужный символ:

String[] parts = "app.log".split(".");

Но split принимает регулярное выражение. Точка в regex означает любой символ, поэтому такой вызов не ищет буквальную точку между app и log.

Для настоящей точки её нужно экранировать в регулярном выражении. В Java-строке обратный слеш тоже экранируется, поэтому в исходнике получается два слеша:

String[] parts = "app.log".split("\\.");
System.out.println(Arrays.toString(parts));

Теперь результатом будут app и log.

Та же ловушка есть у других специальных символов regex. Например, вертикальная черта обозначает альтернативу. Когда разделитель приходит из переменной, удобнее не вспоминать все правила экранирования:

String separator = "|";
String[] fields = line.split(Pattern.quote(separator));

Pattern.quote превращает текст разделителя в буквальный шаблон. Если пользователь выберет точку, плюс или квадратную скобку, смысл разделения не изменится.

Есть ещё нюанс в конце строки. По умолчанию split убирает пустые элементы справа:

System.out.println(Arrays.toString("a,b,".split(",")));

Вы увидите только a и b. Если формат данных считает завершающее пустое поле значимым, передайте отрицательный limit:

String[] fields = "a,b,".split(",", -1);

Здесь будет три элемента, последний из них пустая строка.

👉 Java Ready | #совет

Почему String.format может заменить точку на запятую?

Представим, что программа сохраняет числовое значение в текстовый файл. Хочется получить 12.50, поэтому пишем:

String value = String.format("%.2f", 12.5);

Но результат без явной локали зависит от настроек среды, в которой запущена JVM. На одной машине это будет 12.50, на другой 12,50. Для интерфейса пользователя локальные правила полезны, а для машинного формата такой сюрприз может испортить импорт.

Разницу легко показать без изменения настроек компьютера:

String de = String.format(Locale.GERMANY, "%.2f", 12.5);

Здесь получится 12,50. Если строку должен читать другой сервис с точкой в качестве разделителя, укажите нейтральную локаль явно:

String stable = String.format(Locale.ROOT, "%.2f", 12.5);

Теперь получится 12.50 независимо от локали пользователя. Это важно для логов с фиксированным форматом.

Для текста, который читает человек, наоборот, можно передать нужную ему локаль:

String label = String.format(userLocale, "%.2f", 12.5);

Так отображение будет привычным для пользователя. Но если вы записываете структурированные данные, лучше использовать подходящий формат и библиотеку, например JSON-сериализатор, а не собирать документ через String.format.

👉 Java Ready | #совет