Java Enum值与标签转换为自定义列表对象教程-java教程-PHP中文网

Java Enum值与标签转换为自定义列表对象教程

DDD

发布： 2025-11-26 16:18:07

原创

158人浏览过

Java Enum值与标签转换为自定义列表对象教程

本教程详细介绍了如何利用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<ProductActionItem> 中。

INFINITE ALBUM

面向游戏玩家的生成式AI音乐

144

查看详情

错误的尝试与分析

一个常见的初步尝试可能只关注提取标签，例如：

// 这种方式只提取了label，没有包含枚举名称，也不是目标ProductActionItem类型
List<String> labels = Arrays.stream(ProductActions.values())
                             .map(ProductActions::getLabel) // 或 e -> e.label
                             .collect(Collectors.toList());

登录后复制

这种方法虽然能获取所有标签，但它返回的是 List<String>，而不是我们期望的 List<ProductActionItem>，并且丢失了枚举常量的名称信息。

正确的Stream转换方法

要实现将枚举的名称和标签都映射到 ProductActionItem 对象中，我们需要在 map 操作中构建新的 ProductActionItem 实例。

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()) // 获取所有枚举常量
                     .map(pav -> new ProductActionItem(pav.name(), pav.getLabel())) // 将每个枚举常量映射为ProductActionItem
                     .collect(Collectors.toList()); // 收集为List
    }

    public static void main(String[] args) {
        List<ProductActionItem> 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<ProductActions>。
.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<ProductActions> 转换为了 Stream<ProductActionItem>。
.collect(Collectors.toList()):
- 这是一个终端操作，用于将Stream中的所有元素收集到一个 List 中。最终返回一个 List<ProductActionItem>。

注意事项与最佳实践

枚举属性访问： 确保您的枚举类中为自定义属性提供了公共的访问方法（如 getLabel()），以便在 map 操作中可以安全地访问。
目标类构造器： ProductActionItem 类必须有匹配 (String, String) 参数的构造函数，或者您可以使用其Builder模式来构建实例。如果字段顺序或类型不匹配，会编译错误。
Lombok依赖： 如果使用Lombok注解（如 @Data, @Builder, @AllArgsConstructor），请确保项目中已添加Lombok依赖。
性能考量： 对于大多数枚举，其常量数量通常不大，Stream API的性能开销可以忽略不计。这种方式代码简洁、可读性高，是推荐的做法。
可变性： 转换后的 List<ProductActionItem> 包含的是新的 ProductActionItem 实例。如果 ProductActionItem 是可变的，对列表元素的修改不会影响原始枚举。通常建议POJO类设计为不可变，以提高代码健壮性。