Java中从Optional到List的转换：处理空值与最佳实践-java教程-PHP中文网

Java中从Optional到List的转换：处理空值与最佳实践

花韻仙語

发布： 2025-09-25 10:35:31

原创

309人浏览过

Java中从Optional到List的转换：处理空值与最佳实践

本文详细探讨了在Java代码中将Optional类型转换为List类型时可能遇到的问题及解决方案，重点聚焦于如何正确判断集合是否为空，以及如何返回空的列表。此外，文章还提供了关于Java命名规范、返回不可变列表、方法设计考量以及使用文本块优化SQL语句等一系列专业实践建议，旨在帮助开发者编写更健壮、更规范的代码。

1. 从Optional到List的转换：空值判断的差异

当我们将代码中原本使用optional<t>的地方改为list<t>时，最常见的错误之一是继续沿用optional的判断逻辑。optional类型通过ispresent()方法来检查它是否包含一个非空的值，而list类型则通过isempty()方法来检查它是否包含任何元素。

错误示例：

public List<Department> delete(String department_ID) {
    // ...
    List<Department> existing = get(department_ID);
    if (existing.isPresent()) { // 错误：List类型没有isPresent()方法
        // ...
    }
    // ...
}

登录后复制

原因分析：isPresent()方法是java.util.Optional类特有的，用于指示该Optional实例是否包含一个非空的值。而java.util.List接口及其实现类（如LinkedList）并没有提供isPresent()方法。因此，尝试在List对象上调用此方法会导致编译错误：“The method isPresent() is undefined for the type List”。

正确实践： 要判断一个List是否包含元素，应该使用isEmpty()方法。如果列表不为空（即包含一个或多个元素），则!list.isEmpty()为真。

public List<Department> delete(String department_ID) {
    if ((department_ID == null) || (department_ID.isEmpty())) {
        return new LinkedList<>();
    }

    List<Department> existing = get(department_ID);
    if (!existing.isEmpty()) { // 正确：检查List是否为空
        String sql = "DELETE employee.*, department.* " + "FROM employee, department "
            + "WHERE employee.department_ID = :department_ID AND department.department_ID = :department_ID;";

        // ... (省略部分代码)

        int rows = jdbcTemplate.update(sql, parameters);
        if (rows > 0) {
            return existing;
        }
    }
    return new LinkedList<>();
}

登录后复制

注意事项： 在某些情况下，你可能需要检查List对象本身是否为null。虽然良好的编程习惯通常会避免返回null的List，而是返回一个空列表，但如果存在返回null的可能性，可以使用Objects.nonNull(list)进行防御性检查。然而，如果你的方法始终保证返回一个非null的List（即使是空列表），则此检查是多余的。

2. 返回空列表的最佳实践

在从Optional.empty()转换为返回空列表时，使用new LinkedList<>()是有效的，因为它确实创建并返回了一个空的LinkedList实例。

// 原始代码：
// return Optional.empty();

// 转换后：
return new LinkedList<>(); // 有效，但有更好的选择

登录后复制

然而，在Java中，更推荐的做法是返回一个不可变的空列表。这有几个优点：

立即学习“Java免费学习笔记（深入）”；

安全性： 调用者无法修改返回的列表，避免了意外的副作用。
性能： 对于空列表，通常可以重用同一个不可变实例，减少内存开销。
清晰性： 明确表示该列表不应被修改。

推荐实践：使用 List.of() 返回不可变空列表

从Java 9开始，可以使用List.of()方法创建不可变列表。要返回一个空的不可变列表，只需调用List.of()而不传入任何参数。

public List<Department> delete(String department_ID) {
    if ((department_ID == null) || (department_ID.isEmpty())) {
        return List.of(); // 推荐：返回不可变的空列表
    }

    List<Department> existing = get(department_ID);
    if (!existing.isEmpty()) {
        // ... (数据库操作)
        int rows = jdbcTemplate.update(sql, parameters);
        if (rows > 0) {
            return existing;
        }
    }
    return List.of(); // 推荐：返回不可变的空列表
}

登录后复制

如果调用方需要一个可修改的列表，他们可以根据返回的不可变列表轻松创建一个新的可修改列表，例如：new ArrayList<>(returnedList)。

3. 其他专业实践建议

除了上述的类型转换和空值处理，代码中还存在一些可以优化的点，以提升代码质量和可维护性。

Swapface人脸交换

一款创建逼真人脸交换的AI换脸工具

查看详情

3.1 命名规范

Java社区普遍遵循驼峰命名法（camelCase），并且避免在变量名和方法名中使用下划线。同时，通常不建议使用全大写来命名普通变量（全大写通常用于常量）。

建议： 将department_ID改为departmentId。

3.2 方法返回类型设计

在delete方法中返回List<Department>的设计值得商榷。通常，delete操作的目的是删除数据，其结果通常是：

操作是否成功： 可以返回boolean。
受影响的行数： 可以返回int（如jdbcTemplate.update()的返回值）。
无返回值： 如果删除操作是幂等的且不需要反馈具体删除内容，可以返回void。

返回一个List<Department>可能会让调用者误以为该列表包含了被删除的部门信息，但实际上，它可能只是返回了在删除操作之前查询到的existing列表。这可能导致语义上的混淆。

建议： 根据delete方法的实际业务需求，重新评估其返回类型。例如，如果目的是告知调用者有多少条记录被删除，可以返回int。

// 示例：返回受影响的行数
public int delete(String departmentId) {
    if ((departmentId == null) || (departmentId.isEmpty())) {
        return 0; // 无效输入，返回0
    }

    // ... (查询现有部门，判断是否执行删除)
    List<Department> existing = get(departmentId);
    if (!existing.isEmpty()) {
        String sql = "DELETE employee.*, department.* " + "FROM employee, department "
            + "WHERE employee.department_ID = :departmentId AND department.department_ID = :departmentId;";

        MapSqlParameterSource parameters = new MapSqlParameterSource();
        parameters.addValue("departmentId", departmentId);

        return jdbcTemplate.update(sql, parameters); // 返回受影响的行数
    }
    return 0; // 未执行删除，返回0
}

登录后复制

3.3 使用文本块（Text Blocks）优化SQL字符串

对于多行的SQL语句，使用字符串拼接或转义字符会使代码难以阅读和维护。Java 15引入的文本块（Text Blocks）可以显著改善这种情况。

示例：

// 原始SQL字符串：
String sql = "DELETE employee.*, department.* " + "FROM employee, department "
    + "WHERE employee.department_ID = :department_ID AND department.department_ID = :department_ID;";

// 使用文本块优化：
String sql = """
    DELETE employee.*, department.*
    FROM employee, department
    WHERE employee.department_ID = :departmentId AND department.department_ID = :departmentId;
    """;

登录后复制

文本块以三个双引号"""开始和结束，允许在其中直接书写多行文本，无需手动处理换行符或引号转义，极大地提高了SQL语句的可读性。

总结

从Optional到List的类型转换需要我们重新审视对空值的判断逻辑，将isPresent()替换为!isEmpty()。同时，在返回空列表时，优先选择List.of()来提供不可变且高效的空列表实例。此外，遵循Java的命名规范、合理设计方法返回类型以及利用文本块等现代Java特性，能够进一步提升代码的专业性和可维护性。通过采纳这些建议，开发者可以编写出更健壮、更易读、更符合最佳实践的Java代码。

以上就是Java中从Optional到List的转换：处理空值与最佳实践的详细内容，更多请关注php中文网其它相关文章！