Java Academy · 课时

Optional 最佳实践

Q: 「Optional 最佳实践」这节课中我会学到什么？

应用 orElse、orElseGet 和 orElseThrow，并避免常见的 Optional 反模式 你通过在浏览器中直接运行的动手代码来练习 Java Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

应用 orElse、orElseGet 和 orElseThrow，并避免常见的 Optional 反模式

Optional 最佳实践 是 CoddyKit 上的免费 Java Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Java Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Java Academy 课程共包含 4 节课。

Optional 最佳实践

正确使用时，Optional 是一种强大的工具。本课通过真实代码库中的具体示例，介绍应当做什么以及应当避免什么。

应做：将 Optional 用作返回类型

Optional 的主要用途是作为可能找不到或无法生成值的方法的返回类型。

import java.util.Optional;

// Good: signals to caller that result might be absent
public Optional<User> findByUsername(String username) { ... }
public Optional<Config> getConfig(String key) { ... }
public Optional<String> getHeader(String name) { ... }

// These are all cases where absence is a normal outcome,
// not an exceptional condition

不应做：将 Optional 用作字段

Optional 字段会增加对象开销，并使序列化变得复杂。对于类中的可选字段，请使用空值或哨兵值。

// BAD
class User {
    private Optional<String> middleName; // wrong
}

// GOOD: use null for absent optional field
class User {
    private final String middleName; // null = absent
    public Optional<String> middleName() {
        return Optional.ofNullable(middleName); // expose as Optional in getter
    }
}
User u = new User(null); // null field
System.out.println(u.middleName().isPresent()); // false

不应做：将 Optional 用作方法参数

Optional 参数会迫使调用方不必要地将值包装为 Optional。请改用重载或 @Nullable。

// BAD
void sendNotification(String message, Optional<String> subject) { ... }
// caller must write: sendNotification("Hello", Optional.of("News"))

// GOOD: overloading
void sendNotification(String message) { sendNotification(message, null); }
void sendNotification(String message, String subject) {
    // subject may be null
}
// caller writes: sendNotification("Hello", "News") — clean

不应做：在集合中使用 Optional

绝不要将 Optional 放入 List、Set 或 Map 的值中。集合中的空 Optional 没有意义——直接省略该条目即可。

// BAD: List of Optionals
List<Optional<User>> results = ...; // meaningless empty Optionals

// GOOD: List of present values only
List<User> presentUsers = maybeUsers.stream()
    .flatMap(Optional::stream)
    .collect(Collectors.toList());

// BAD: Map with Optional values
Map<String, Optional<String>> config = ...;

// GOOD: just use null or omit the key for absent values
Map<String, String> config2 = ...;
String value = config2.getOrDefault("key", "default");

应做：使用 orElseGet 提供开销较大的默认值

当默认值需要计算（数据库查询、网络调用）时，请始终使用 orElseGet——supplier 只会在需要时调用。

import java.util.Optional;

// BAD: buildDefault() always called, even when value is present!
String config = getConfig("timeout").orElse(buildDefault());

// GOOD: supplier called lazily only when empty
String config2 = getConfig("timeout").orElseGet(() -> buildDefault());

// Or with method reference:
String config3 = getConfig("timeout").orElseGet(this::buildDefault);

// For cheap literals, orElse is fine
String name = getConfig("name").orElse("default");

应做：使用 orElseThrow 获取必需值

当值缺失表示编程错误或违反不变量时，请使用 orElseThrow 并提供描述性异常。

import java.util.Optional;

// Good: throw when absence is an error
User user = userRepository.findById(userId)
    .orElseThrow(() -> new UserNotFoundException("User not found: " + userId));

// Good: in validation code
String apiKey = Optional.ofNullable(System.getenv("API_KEY"))
    .orElseThrow(() -> new IllegalStateException(
        "API_KEY environment variable is required"));

System.out.println("Key found: " + apiKey.length() + " chars");

反模式：isPresent + get()

避免先检查 isPresent()、再调用 get() 的反模式。这并不比空值检查更好，而且违背了 Optional 的设计目的。

import java.util.Optional;

Optional<String> opt = findValue();

// BAD: isPresent() + get() — no improvement over null check
if (opt.isPresent()) {
    String val = opt.get();
    process(val);
}

// GOOD: use the functional API
opt.ifPresent(this::process);

// GOOD: transform and return
return opt.map(this::process).orElse(null);

// GOOD: provide a default
String result = opt.orElse("default");

串联操作的最佳实践

构建清晰的调用链：查找 → 过滤 → 转换 → 备用方案。每一步的意图都能自行说明。

import java.util.Optional;

record User(long id, String plan, boolean active) {}

static Optional<User> findUser(long id) { return Optional.empty(); }

String result = findUser(42L)
    .filter(User::active)           // keep only active users
    .filter(u -> "PRO".equals(u.plan())) // keep only PRO users
    .map(u -> "Welcome, Pro user #" + u.id()) // transform
    .orElse("Upgrade to Pro!");     // fallback

System.out.println(result); // Upgrade to Pro!

服务层中的 Optional

一个遵循最佳实践的真实服务层示例。

import java.util.Optional;

class OrderService {
    public Optional<OrderSummary> getOrderSummary(long orderId) {
        return orderRepo.findById(orderId)
            .filter(o -> !o.isCancelled())
            .map(this::toSummary);
    }

    public OrderSummary requireOrderSummary(long orderId) {
        return getOrderSummary(orderId)
            .orElseThrow(() -> new OrderNotFoundException(orderId));
    }

    private OrderSummary toSummary(Order o) { return new OrderSummary(o); }
}
// API callers choose: Optional (handle absence) or require (exception)

Optional 与空值安全工具

Optional 可以与 @Nullable/@NonNull 注解以及 SpotBugs/NullAway 等工具互补，从而实现完整的空值安全覆盖。

// Annotation-based: declares intent for in-class nulls
import org.jetbrains.annotations.*;

class ProductService {
    @Nullable  // may return null — for framework/bean use
    public String getCachedName(String id) { return cache.get(id); }

    // Optional — for service API that handles absence
    public Optional<Product> findProduct(String id) {
        return repo.findById(id);
    }
}
// Use @Nullable for fields/parameters; Optional for return types

快速检查

下面的代码有什么问题？

if (opt.isPresent()) {
    process(opt.get());
}

回顾：Optional 最佳实践

关键要点：

仅将 Optional 用作返回类型——绝不要用作字段或方法参数
当默认值计算开销较大时，优先使用 orElseGet 而不是 orElse
当缺失表示编程错误时，使用 orElseThrow
避免 isPresent() + get()——改用 ifPresent、map 或 orElse
绝不要将 Optional 放入集合中——改为过滤流
构建可读的调用链：filter → map → orElse，使数据流向清晰

常见问题解答

「Optional 最佳实践」课时是免费的吗？

是的 — 「Optional 最佳实践」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Java Academy 课程的其余内容，请升级到 CoddyKit PRO。 Java Academy 课程共包含 4 节课。

「Optional 最佳实践」这节课中我会学到什么？

应用 orElse、orElseGet 和 orElseThrow，并避免常见的 Optional 反模式你通过在浏览器中直接运行的动手代码来练习 Java Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Java Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Java Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「Optional 最佳实践」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Java Academy 课中编写并运行代码吗？

能。每节 Java Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Java Academy