Особенности использования defaultValue в @RequestParam в Spring

Быстрый ответ

@GetMapping("/example")
public String handleRequest(
    @RequestParam(defaultValue = "default") String param) {
    return "Параметр: " + param;
}

В приведенном выше примере, аннотация Spring @RequestParam использует атрибут defaultValue, задающий заменитель для ситуаций, когда параметр запроса отсутствует. Это помогает предотвратить появление значений null в вашем приложении.

Защита от значений null и пустых параметров

В некоторых сценариях наши запросы могут получать пустые строки или значения null, в результате чего может возникнуть NumberFormatException, особенно при обработке числовых значений. Чтобы успешно справляться с такими ситуациями, можно присвоить тип String для @RequestParam и программно преобразовывать его значение в необходимый формат.

Защита от несоответствия типов

@GetMapping("/example")
public String handleNumericRequest(
    @RequestParam(required = false) String param) {
    Integer numericValue = (param != null && !param.isEmpty()) ? Integer.parseInt(param) : 42;
    return "Числовое значение: " + numericValue;
}

В приведённом здесь образце кода мы удостоверяемся, что param не является null и не представляет собой пустую строку перед попыткой его конвертирования. Если условия не выполняются, мы ограничиваем значение числом 42, что позволяет избежать NumberFormatException.

Подробнее об этом расскажет наш спикер на видео

Использование обновлений Spring

Начиная с версии 3.2.2, фреймворк Spring автоматически обрабатывает пустые параметры, используя defaultValue. В результате Ваш код становится более чистым и эффективным.

Совместимость разных версий Spring

Пометка параметров аннотацией @Nullable поможет точно указать Ваши намерения и гарантировать совместимость с разными версиями Spring. При этом предотвращение отправки пустых параметров на уровне клиента также поможет избежать возникновения множества нежелательных ситуаций.

Визуализация

Применение значений по умолчанию в аннотации @RequestParam, когда параметры отсутствуют:

Вообразите вокзал с двумя путями:

Путь 1: Обычный поезд (🚂)- ожидает получения параметров от пользователя для начала пути.
Путь 2: Резервный автобус (🚌) — в случае отсутствия поезда проблемы отсутствуют, использование альтернативных значений становится спасением!

@RequestParam(value="stop", defaultValue="ГлавнаяСтанция")

Возможно ли станция отсутствует? 🚉:❓

🚂: "Есть ли данные от пользователя? Великолепно, в путь!"
🚌: "Если данных нет, курс на Главную Станцию!"

Мы двигаемся по верному пути! 🛤️💡

Анализ крайних случаев и альтернатив

Проведение валидации на клиентской стороне

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

Использование службы преобразования типов

Служба преобразования типов в Spring может оказаться весьма полезным инструментом. Она позволяет преобразовывать пустые строки в значения null или устанавливать значения по умолчанию для различных типов данных.

Применение глобальной конфигурации для значений по умолчанию

Если у вас есть общие значения по умолчанию для различных запросов, то применение глобальных предустановок упростит поддержку кода и позволит придерживаться принципа DRY.

Следите за актуальной документацией

Следите за новейшими обновлениями, такими как SPR-10180, и документацией Spring, чтобы быть в курсе изменений в поведении @RequestParam в разных версиях фреймворка.

Полезные материалы

1. java – @RequestParam в Spring MVC для обработки необязательных параметров – Stack Overflow — подробное описание работы с необязательными параметрами в Spring MVC.
2. Перенаправление... — официальная документация Spring Framework по использованию @RequestParam.
3. GitHub – spring-projects/spring-framework: Spring Framework — для более глубокого ознакомления с работой систeмы приведен официальный репозиторий Spring Framework.
4. Spring Boot Java Tutorial – REST API using PostgreSQL and JWT – YouTube — подробный учебник по использованию @RequestParam в Spring, отличный ресурс для дополнительного изучения.