本文详细介绍了如何利用java stream api将自定义枚举类型中的常量名称及其关联标签高效地转换为一个自定义数据传输对象（dto）列表。通过实例代码，演示了从枚举值流化到映射为新对象并最终收集为列表的完整过程，旨在帮助开发者优化枚举数据处理，实现数据模型的灵活转换。
在现代Java应用开发中，枚举（Enum）常用于定义一组固定的常量。然而，有时我们需要将这些枚举常量及其内部属性（如标签、描述等）转换为其他数据结构，例如一个包含特定字段的列表对象，以便于前端展示或与其他服务进行数据交互。本文将详细阐述如何利用Java 8及更高版本提供的Stream API，优雅地实现这一转换过程。
1. 理解核心需求
我们的目标是将一个自定义枚举类型中的每个常量，连同其内部定义的标签，映射到一个新的自定义数据传输对象（DTO）实例中，并最终将所有这些DTO实例收集成一个列表。
原始枚举定义：
假设我们有一个 ProductActions 枚举，它包含了一系列产品操作及其对应的用户友好标签：
立即学习“Java免费学习笔记（深入）”；
public enum ProductActions {
BUY("Buy"),
SELL("Sell"),
TRANSFER("Transfer"); // 注意：原问题中的Transfer首字母大写，Java枚举常量通常全大写，这里保持原样
public final String label;
ProductActions(String label) {
this.label = label;
}
// 可选：提供一个获取label的方法，虽然直接访问public final字段也可以
public String getLabel() {
return label;
}
}目标数据传输对象（DTO）：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
我们希望将上述枚举常量转换为 ProductActionItem 类的实例，该类包含两个字段：productAction 用于存储枚举常量的名称，productLabel 用于存储枚举的标签。
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;
@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class ProductActionItem {
private String productAction;
private String productLabel;
}为了方便，这里使用了Lombok注解来自动生成构造函数、Getter/Setter等。如果没有Lombok，需要手动添加相应的构造函数。
2. 使用Stream API进行转换
Java Stream API 提供了一种声明式、函数式的方式来处理集合数据。要将枚举转换为自定义对象列表，我们可以遵循以下步骤：
- 获取所有枚举常量： 使用 Enum.values() 方法可以获取枚举类型中所有常量的数组。
- 创建流： 将枚举常量数组转换为一个Stream。
- 映射（map）操作： 对Stream中的每个枚举常量执行映射操作，将其转换为 ProductActionItem 的实例。
- 收集（collect）操作： 将映射后的 ProductActionItem 实例收集到一个 List 中。
具体实现代码：
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
public class EnumConverter {
public static List<ProductActionItem> getProductActionItems() {
return Arrays.stream(ProductActions.values()) // 1. 获取所有枚举常量并创建Stream
.map(action -> new ProductActionItem(action.name(), action.getLabel())) // 2. 映射每个枚举常量到ProductActionItem
.collect(Collectors.toList()); // 3. 收集为List
// 对于Java 16及以上版本，可以使用更简洁的 .toList();
// .toList();
}
public static void main(String[] args) {
List<ProductActionItem> items = getProductActionItems();
items.forEach(item -> System.out.println("Action: " + item.getProductAction() + ", Label: " + item.getProductLabel()));
/*
* 预期输出:
* Action: BUY, Label: Buy
* Action: SELL, Label: Sell
* Action: TRANSFER, Label: Transfer
*/
}
}代码解析：
- Arrays.stream(ProductActions.values()): ProductActions.values() 返回一个 ProductActions 类型的数组，Arrays.stream() 则将其转换为 Stream<ProductActions>。
- .map(action -> new ProductActionItem(action.name(), action.getLabel())): 这是转换的核心。
- action 代表Stream中的每一个 ProductActions 枚举常量。
- action.name()：这是一个非常重要的点。Enum 类型自带 name() 方法，它返回枚举常量本身的字符串名称（例如 "BUY", "SELL"）。这正是我们 ProductActionItem 中 productAction 字段所需的值。
- action.getLabel()：调用我们为 ProductActions 枚举定义的 getLabel() 方法（或者直接访问 action.label 字段），获取其关联的标签字符串。
- new ProductActionItem(...)：使用 ProductActionItem 的全参构造函数（由Lombok的 @AllArgsConstructor 生成）来创建新的DTO实例。
- .collect(Collectors.toList()): 将Stream中所有转换后的 ProductActionItem 对象收集到一个新的 List<ProductActionItem> 中。如果项目使用Java 16或更高版本，可以直接使用 .toList() 方法，代码会更简洁。
3. 注意事项与最佳实践
-
Enum.name() 与 Enum.toString()：
- name() 方法总是返回枚举常量的声明名称，例如 ProductActions.BUY.name() 将返回 "BUY"。
- toString() 方法默认也返回枚举常量的声明名称，但它可以在枚举内部被重写。为避免不必要的混淆和潜在的错误，当需要获取枚举常量的字面名称时，推荐使用 name() 方法。
- 目标DTO的构造函数： 确保你的目标DTO（如 ProductActionItem）有一个合适的构造函数，能够接收枚举名称和标签作为参数。如果使用Lombok的 @Builder 或 @AllArgsConstructor，则会自动生成。
- Java版本兼容性： Stream.toList() 方法是Java 16引入的。如果你的项目使用旧版Java（如Java 8或11），则必须使用 Collectors.toList()。
- 代码可读性： 尽管Stream API很强大，但过度复杂的Stream链可能会降低代码的可读性。对于本例这种简单的映射，Stream API的简洁性优势非常明显。
- 异常处理： 在本例中，由于枚举常量是固定的，通常不会出现运行时异常。但在处理外部数据源或更复杂的映射逻辑时，应考虑潜在的 NullPointerException 或其他业务逻辑异常。
4. 总结
通过Java Stream API，我们可以非常高效和优雅地将枚举类型中的常量及其自定义属性转换为目标数据传输对象列表。这种模式不仅减少了样板代码，提高了代码的可读性和维护性，也充分利用了Java函数式编程的优势。掌握这一技巧，将有助于开发者在处理复杂数据转换场景时更加得心应手。
