本教程详细介绍了如何利用java stream api，将枚举（enum）中的名称（name）和自定义标签（label）高效地转换为一个包含特定数据结构的列表对象。通过清晰的代码示例和步骤解析，读者将学习如何将枚举常量映射到自定义的pojo类实例，从而实现灵活的数据转换与应用。
在Java开发中，枚举（Enum）常用于定义一组固定的常量，并且有时会为这些常量关联额外的属性，如描述性的标签。在某些业务场景下，我们需要将这些枚举常量及其关联的属性提取出来，并封装成一个更通用的数据结构列表，以便于前端展示、API响应或进一步的数据处理。本文将指导您如何使用Java Stream API优雅地完成这一转换。
定义枚举类型
首先，我们定义一个包含自定义标签的枚举类型 ProductActions。每个枚举常量除了其固有的名称外，还带有一个 label 属性。
public enum ProductActions {
BUY("Buy"),
SELL("Sell"),
TRANSFER("Transfer"); // 注意：原问题中Transfer拼写有误，此处修正为Transfer
public final String label;
ProductActions(String label) {
this.label = label;
}
// 为了方便外部访问，可以添加一个getter方法
public String getLabel() {
return label;
}
}定义目标数据结构
接下来，我们定义一个目标数据结构 ProductActionItem，用于封装从枚举中提取出的名称和标签。这个类通常是一个简单的POJO（Plain Old Java Object）。
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、构造函数和builder的生成。如果项目中不使用Lombok，需要手动添加相应的构造函数和getter/setter方法。
立即学习“Java免费学习笔记（深入）”；
实现枚举到列表的转换
核心的转换逻辑将使用Java Stream API。我们的目标是将 ProductActions 枚举中的每一个常量，转换成一个 ProductActionItem 对象，并最终收集到一个 List
错误的尝试与分析
一个常见的初步尝试可能只关注提取标签，例如：
// 这种方式只提取了label，没有包含枚举名称，也不是目标ProductActionItem类型 Listlabels = Arrays.stream(ProductActions.values()) .map(ProductActions::getLabel) // 或 e -> e.label .collect(Collectors.toList());
这种方法虽然能获取所有标签，但它返回的是 List
正确的Stream转换方法
要实现将枚举的名称和标签都映射到 ProductActionItem 对象中，我们需要在 map 操作中构建新的 ProductActionItem 实例。
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
public class EnumConverter {
public static List getProductActionItems() {
return Arrays.stream(ProductActions.values()) // 获取所有枚举常量
.map(pav -> new ProductActionItem(pav.name(), pav.getLabel())) // 将每个枚举常量映射为ProductActionItem
.collect(Collectors.toList()); // 收集为List
}
public static void main(String[] args) {
List actionItems = getProductActionItems();
actionItems.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
。
- .map(pav -> new ProductActionItem(pav.name(), pav.getLabel())):
- 这是Stream管道中的核心转换步骤。对于流中的每一个 ProductActions 枚举常量 pav：
- pav.name()：这是 Enum 类自带的方法，用于获取枚举常量的名称（即定义时的字面量，如 "BUY", "SELL"）。
- pav.getLabel()：这是我们在 ProductActions 枚举中自定义的getter方法，用于获取关联的标签字符串。
- new ProductActionItem(pav.name(), pav.getLabel())：使用这两个值作为参数，调用 ProductActionItem 的构造函数（或通过 ProductActionItem.builder().productAction(pav.name()).productLabel(pav.getLabel()).build() 使用Builder模式），创建一个新的 ProductActionItem 实例。
- map 操作将 Stream
转换为了 Stream 。
- 这是Stream管道中的核心转换步骤。对于流中的每一个 ProductActions 枚举常量 pav：
- .collect(Collectors.toList()):
- 这是一个终端操作，用于将Stream中的所有元素收集到一个 List 中。最终返回一个 List
。
- 这是一个终端操作，用于将Stream中的所有元素收集到一个 List 中。最终返回一个 List
注意事项与最佳实践
- 枚举属性访问： 确保您的枚举类中为自定义属性提供了公共的访问方法（如 getLabel()），以便在 map 操作中可以安全地访问。
- 目标类构造器： ProductActionItem 类必须有匹配 (String, String) 参数的构造函数，或者您可以使用其Builder模式来构建实例。如果字段顺序或类型不匹配，会编译错误。
- Lombok依赖： 如果使用Lombok注解（如 @Data, @Builder, @AllArgsConstructor），请确保项目中已添加Lombok依赖。
- 性能考量： 对于大多数枚举，其常量数量通常不大，Stream API的性能开销可以忽略不计。这种方式代码简洁、可读性高，是推荐的做法。
-
可变性： 转换后的 List
包含的是新的 ProductActionItem 实例。如果 ProductActionItem 是可变的，对列表元素的修改不会影响原始枚举。通常建议POJO类设计为不可变，以提高代码健壮性。
总结
通过Java Stream API，我们可以非常简洁高效地将枚举常量及其自定义属性转换为自定义的列表对象。这种模式在处理配置、下拉菜单数据、API响应模型等场景中非常实用，它提升了代码的可读性和维护性，是现代Java开发中值得掌握的技巧。遵循上述步骤和注意事项，您可以轻松地实现这类数据转换需求。
