SpringBoot中的Optional使用小结

@GetMapping("/users/{id}")
public ResponseEntity<User> getUser(@PathVariable Optional<Long> id) {
    // 链式处理：存在id则查询，不存在返回400
    return id.map(value -> 
        userService.findById(value)
            .map(ResponseEntity::ok)
            .orElse(ResponseEntity.notFound())
    ).orElse(ResponseEntity.badRequest().build());
}

// 查询结果存在时返回对象，不存在时抛出自定义异常
public User getUserOrThrow(Long id) {
    return userRepository.findById(id)
        .orElseThrow(() -> new NotFoundException("User not found"));
}
 
// 安全链式调用：查询、转换、处理空值
public Optional<UserDTO> findUserDTO(Long id) {
    return userRepository.findById(id)
        .map(this::mapToDTO)  // 安全转换DTO
        .filter(dto -> dto.isActive()); // 过滤无效数据
}

app.feature.toggle.new-ui=true
@ConfigurationProperties(prefix = "app.feature.toggle")
public class FeatureToggleProperties {
    private Optional<Boolean> newUi = Optional.empty(); // 默认空
 
    // Getter/Setter
    public boolean isNewUiEnabled() {
        return newUi.orElse(false); // 配置不存在时返回默认值
    }
}

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(NotFoundException.class)
    public ResponseEntity<Object> handleNotFound(NotFoundException ex) {
        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(ex.getMessage());
    }
}

public void logUserActivity(User user) {
    Optional.ofNullable(user)
        .map(User::getName)
        .ifPresent(name -> log.info("User {} logged in", name)); // 仅当name存在时记录
}

// 反例：返回null，调用方需自行判断
public User findUser(Long id) {
    return userRepository.findById(id).orElse(null);
}
 
// 正例：返回Optional，调用方必须处理空值
public Optional<User> findUser(Long id) {
    return userRepository.findById(id);
}

// 反例：参数为Optional，增加调用方负担
void process(Optional<User> user) {
    // ...
}
 
// 正例：使用null或重载
void process(User user) { ... }
void process() { process(null); } // 重载处理无参数情况

// 反例：直接get()，空值时崩溃
User user = optionalUser.get();
 
// 正例：安全取值
User user = optionalUser
    .orElse(new User()); // 提供默认对象
User user = optionalUser
    .orElseThrow(() -> new NotFoundException()); // 空值时抛出异常

List<String> validEmails = users.stream()
    .map(User::getContact)
    .filter(Optional::isPresent)    // 过滤空Optional
    .map(Optional::get)             // 解包Optional
    .map(Contact::getEmail)
    .filter(Objects::nonNull)       // 过滤null邮箱
    .collect(Collectors.toList());

@GetMapping("/search")
public String search(@RequestParam Optional<String> keyword) {
    String query = keyword.orElse("default"); // 无参数时使用默认值
    return service.search(query);
}

@Configuration
public class OptionalConverterConfig {
    @Bean
    public Converter<String, Optional<String>> optionalConverter() {
        return value -> value == null ? Optional.empty() : Optional.of(value);
    }
}

@Service
public class UserService {
    private final @NonNull UserRepository userRepository; // Lombok保证非空
 
    public Optional<User> findActiveUser() {
        return Optional.ofNullable(userRepository.findActiveUser());
    }
}