Для чего предназначен Optional?

Метод, который может ничего не найти, раньше возвращал null — и вызывающий легко забывал проверку, получая NullPointerException в неожиданном месте. Optional<T> делает отсутствие значения частью типа: по сигнатуре Optional<User> findById(long id) сразу видно, что пользователя может не быть.

Обработка без явных проверок:

• map и flatMap — преобразовать значение, если оно есть;
• filter — отбросить по условию;
• orElse(default) — значение по умолчанию (вычисляется всегда);
• orElseGet(supplier) — значение по умолчанию лениво;
• orElseThrow() — бросить исключение при отсутствии;
• ifPresent / ifPresentOrElse — выполнить действие.

Рекомендации: использовать как тип возвращаемого значения; не делать полями класса и параметрами методов; не возвращать null вместо Optional; для коллекций возвращать пустую коллекцию, а не Optional<List>. Для примитивов есть OptionalInt и подобные.

String city = userRepository.findById(id)
        .map(User::getAddress)
        .map(Address::getCity)
        .orElse("не указан");

User user = userRepository.findById(id)
        .orElseThrow(() -> new NotFoundException("user " + id));