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. 其他专业实践建议
除了上述的类型转换和空值处理，代码中还存在一些可以优化的点，以提升代码质量和可维护性。
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代码。
