如何在 Java 中安全地检查一个字符串是否被另一个字符串包含？-java教程-PHP中文网

如何在 Java 中安全地检查一个字符串是否被另一个字符串包含？

Java 中没有直接的 isContained() 方法，但可通过 Optional 和 String.contains() 组合实现 null 安全的子串反向检查，避免显式判空和 NullPointerException。

java 中没有直接的 `iscontained()` 方法，但可通过 `optional` 和 `string.contains()` 组合实现 null 安全的子串反向检查，避免显式判空和 nullpointerexception。

在实际开发中，我们常需判断某个动态字符串（如方法返回值）是否作为子串出现在一个已知常量或固定字符串中。例如：

final String testStr = anyMethod(); // 可能为 null
if (testStr.contains(AnyClass.STRING_CONSTANT)) { /* ... */ }

但这种写法存在风险：一旦 testStr 为 null，调用 contains() 将抛出 NullPointerException。虽然可先加 if (testStr != null) 判空，但代码冗余且易遗漏。

更优雅的解法是反转检查方向——将非空常量作为主字符串，动态字符串作为待查子串，并确保主字符串始终非 null。Java 8+ 的 Optional 提供了简洁、函数式的 null 安全处理能力：

✅ 推荐方案：使用 `Optional.ofNullable().map().orElse()`

boolean contains = Optional.ofNullable(fullString)
    .map(s -> s.contains(testStr))
    .orElse(false);

✅ 完全 null 安全：当 fullString == null 时，map() 不执行，直接返回 false；
✅ 语义清晰：明确表达“若 fullString 存在，则检查是否含 testStr；否则视为不包含”；
✅ 符合契约：即使 testStr 为 null（虽本例中不出现），s.contains(null) 本身会抛异常，因此该方案隐含要求 testStr 非 null —— 这与你的使用场景一致（testStr 来自 anyMethod() 但保证非 null）。

⚠️ 注意：String.contains(null) 会抛出 NullPointerException，因此 testStr 必须确保非 null。若存在 testStr 也可能为 null 的场景，需额外校验：

Alibabacloud Sdk Client Initialization For Java
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载
boolean contains = Optional.ofNullable(fullString)
    .filter(s -> testStr != null)  // 先确保 testStr 非 null
    .map(s -> s.contains(testStr))
    .orElse(false);

❌ 不推荐方案：`Optional.ofNullable(...).orElse("").contains(...)`

Optional.ofNullable(fullString).orElse("").contains(testStr)

该写法虽能避免 NPE，但存在逻辑陷阱：当 fullString == null 时，退化为 "".contains(testStr)。此时仅当 testStr.equals("") 时返回 true，其余情况返回 false。这看似合理，但掩盖了“主字符串缺失”这一重要状态，不利于调试和语义表达，且违反 fail-fast 原则。

总结

方案	Null 安全	语义明确性	推荐度
`fullString.contains(testStr)`（无判空）	❌	✅	❌
`fullString != null && fullString.contains(testStr)`	✅	△（需多行）	△
`Optional.ofNullable(fullString).map(...).orElse(false)`	✅	✅（函数式、意图清晰）	✅✅✅