引言：类型转换的必要性
在Java编程中，Optional<T>通常用于表示一个值可能存在也可能不存在的场景，旨在避免NullPointerException。而List<T>则是一个集合接口，用于表示一个有序的、可包含零个或多个元素的序列。在某些业务逻辑演进或代码重构时，我们可能会遇到需要将原本返回Optional<T>的方法修改为返回List<T>的情况，例如当一个查询操作原本只预期返回一个结果（或没有），但现在可能返回多个结果时。这种类型转换涉及对空值处理和内容检查逻辑的相应调整。
处理空值返回：从Optional.empty()到空List
当一个方法使用Optional<T>作为返回类型时，如果没有任何结果，它通常会返回Optional.empty()来明确表示值的缺失。在转换为List<T>后，对应的“没有结果”状态应该通过返回一个不包含任何元素的空列表来表示。
-
Optional的空值表示：
// 原始 Optional 返回，表示没有值 return Optional.empty();
-
List的空值表示：
在List的上下文中，返回一个空列表（即列表的size()为0）是表示没有元素的标准方式。通常有两种推荐的做法：
-
返回可变的空LinkedList或ArrayList：
return new LinkedList<>(); // 返回一个空的 LinkedList 实例 // 或者 // return new ArrayList<>(); // 返回一个空的 ArrayList 实例
这种方式返回的列表是可变的，调用者可以向其中添加元素。
-
返回不可变的空List：
return List.of(); // Java 9+ 推荐，返回一个不可变的空列表
List.of()方法（Java 9及更高版本）提供了一种简洁的方式来创建不可变列表。对于返回空列表的场景，List.of()是更推荐的选择，因为它能保证返回的列表不会被意外修改，从而提升代码的健壮性。
立即学习“Java免费学习笔记（深入）”；
-
返回可变的空LinkedList或ArrayList：
检查内容存在性：从isPresent()到!isEmpty()
Optional.isPresent()方法是Optional类的一个核心功能，用于判断Optional实例是否包含一个非空值。当我们将类型转换为List<T>后，List接口并没有isPresent()方法。因此，我们需要使用List接口提供的相应方法来检查列表是否包含元素。
-
Optional的内容检查：
// 原始 Optional 检查，判断 Optional 是否包含值 if (existingOptional.isPresent()) { // ... 执行包含值时的逻辑 } -
List的内容检查：
对于List<T>类型，我们应该使用isEmpty()方法来判断列表是否为空。
List<Department> existingDepartments = get(departmentId); if (!existingDepartments.isEmpty()) { // 检查列表是否非空，即是否包含元素 // ... 执行包含元素时的逻辑 }这里需要注意的是，existingDepartments变量本身不应为null。在良好的Java编程实践中，如果一个方法声明返回List<T>，它应该始终返回一个List实例（即使是空列表），而不是null。这样可以避免调用者进行额外的null检查，直接使用!isEmpty()即可。如果存在List变量可能为null的极少数情况，则可以增加Objects.nonNull()进行防御性检查：
if (Objects.nonNull(existingDepartments) && !existingDepartments.isEmpty()) { // ... }但在大多数情况下，如果遵循返回空列表而非null的约定，此处的Objects.nonNull()检查是不必要的。
整合示例：delete方法重构
以下是一个将Optional<Department>转换为List<Department>的delete方法重构示例，它整合了上述的空值处理和内容检查的最佳实践。
import java.util.LinkedList;
import java.util.List;
import java.util.Objects; // 用于 Objects.nonNull()，如果需要
import org.springframework.jdbc.core.namedparam.MapSqlParameterSource;
import org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate;
// 假设 Department 类已定义，包含 departmentId 字段
class Department {
private String departmentId;
// ... 构造函数, getter, setter, toString 等
public Department(String departmentId) {
this.departmentId = departmentId;
}
public String getDepartmentId() {
return departmentId;
}
// 简化示例，实际类会更复杂
}
public class DepartmentService { // 假设这是某个服务类
private NamedParameterJdbcTemplate jdbcTemplate; // 假设已通过构造函数或@Autowired注入
// 构造函数注入 jdbcTemplate
public DepartmentService(NamedParameterJdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
/**
* 根据部门ID删除部门及其关联员工。
*
* @param departmentId 部门ID
* @return 返回被删除的部门列表（如果存在），否则返回一个空列表。
* 注意：此方法的返回类型语义可能需要根据实际业务需求进一步评估。
*/
public List<Department> delete(String departmentId) { // 遵循Java命名规范：departmentId
// 1. 处理输入参数为空或空字符串的情况
if (departmentId == null || departmentId.isEmpty()) {
return List.of(); // 推荐使用 List.of() 返回不可变空列表
}
// 2. 获取待删除的现有部门信息
// 假设 get 方法返回一个 List<Department>
List<Department> existingDepartments = get(departmentId);
// 3. 检查列表是否非空，以决定是否执行删除操作
if (!existingDepartments.isEmpty()) { // 使用 !isEmpty() 替代 isPresent()
// 使用Java 15+ 的文本块（Text Blocks）提升SQL语句的可读性
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); // 参数名也应遵循命名规范
int rowsAffected = jdbcTemplate.update(sql, parameters);
if (rowsAffected > 0) {
// 如果删除成功，返回之前获取的被删除部门列表
// 注意：这里返回的是删除前的快照，如果业务需要返回实际删除的列表，需要进一步查询确认
return existingDepartments;
}
}
// 4. 如果没有找到要删除的部门，或者删除失败，返回空列表
return List.of(); // 推荐使用 List.of()
}
/**
* 模拟获取部门信息的方法。
* 实际应用中会从数据库查询。
*
* @param departmentId 部门ID
* @return 匹配的部门列表，如果不存在则返回空列表。
*/
private List<Department> get(String departmentId) {
// 模拟数据获取逻辑
if ("dept123".equals(departmentId)) {
List<Department> departments = new LinkedList<>();
departments.add(new Department("dept123"));
// 假设还有其他部门信息
return departments;
}
return List.of(); // 返回不可变空列表
}
}Java编程最佳实践与注意事项
在进行类型转换和代码重构时，除了功能上的正确性，还应关注以下几点最佳实践，以提升代码质量和可维护性：
-
返回不可变列表： 当一个方法返回List<T>时，如果调用者不应修改此列表的内容，那么返回一个不可变列表是最佳实践。这可以防止意外的副作用和并发问题。
- List.of() (Java 9+)： 最简洁的方式，用于创建小的、固定的不可变列表。
-
Collections.unmodifiableList()： 如果你有一个现有的可变列表，并希望提供一个不可变的视图给外部，可以使用此方法。
List<Department> mutableList = new ArrayList<>(); // ... 添加元素到 mutableList return Collections.unmodifiableList(mutableList);
在上面的delete方法中，我们使用了List.of()来返回空列表，这确保了返回的空列表是不可变的。
-
命名规范： Java有明确的命名约定，遵循这些约定可以使代码更易读、更专业。
- 变量和方法名： 使用camelCase（驼峰命名法），首字母小写。例如：departmentId优于department_ID。
- 常量： 通常使用全大写和下划线分隔。 在示例代码中，我们将department_ID改为了departmentId。
-
方法返回类型语义：delete方法返回List<Department>的语义需要仔细考量。
- 常见做法： delete操作通常返回void（不返回任何值）、boolean（表示删除是否成功）或int（表示受影响的行数）。
- 返回被删除实体： 如果业务需求确实需要返回被删除的实体列表，那么当前实现需要确保返回的是实际被删除的实体（例如，在删除操作成功后，再次查询以获取被删除的实体，而不是返回删除前的快照）。否则，返回删除前的existingDepartments可能会引起误解。 在示例中，我们暂时保留了返回List<Department>，但添加了注释提醒对其语义的评估。
-
使用文本块（Text Blocks）： 对于多行字符串，特别是像SQL查询这样的场景，Java 15引入的文本块（Text Blocks）可以显著提升代码的可读性，避免了繁琐的字符串拼接和转义字符。
String sql = """ DELETE employee.*, department.* FROM employee, department WHERE employee.department_ID = :departmentId AND department.department_ID = :departmentId; """;这比传统的字符串拼接或单行字符串更清晰。
总结
从Optional<T>到List<T>的类型转换是Java开发中常见的重构场景。核心在于理解两种类型处理“无值”和“有值”的机制差异：Optional.empty()对应List.of()或new LinkedList<>()，而Optional.isPresent()则对应!list.isEmpty()。
在进行此类转换时，除了功能上的正确性，还应积极采纳Java的编程最佳实践，包括：优先返回不可变列表以增强代码安全性、遵循标准的命名规范以提高可读性、以及审慎评估方法返回类型的语义以确保其与业务逻辑一致。通过这些实践，我们能够构建出更健壮、更易于维护和理解的Java应用程序。
