java枚举传给前端

### 如何将Java枚举传递到前端

为了实现Java枚举向前端的传输，通常有几种方法可以考虑：

#### 方法一：通过API返回JSON对象表示枚举值

在服务器端定义好枚举类之后，可以通过创建RESTful API来提供这些枚举数据。当客户端请求时，服务端会把枚举转换成JSON格式发送出去。

// 枚举示例
public enum Status {
    PENDING, COMPLETED, CANCELLED;
}

@RestController
@RequestMapping("/api/statuses")
class StatusController {

    @GetMapping(produces = "application/json")
    public ResponseEntity<List<String>> getStatuses() {
        List<String> statuses = Arrays.stream(Status.values())
                                      .map(Enum::name)
                                      .collect(Collectors.toList());
        return new ResponseEntity<>(statuses, HttpStatus.OK);
    }
}

此方式简单明了，适合于只需要获取枚举名称的情况[^1]。

#### 方法二：序列化为DTO并附带描述信息

如果除了名字外还需要其他属性比如显示名，则可以在DTO中封装更多细节，并将其作为响应的一部分传送给前端应用。

@Data // Lombok annotation for getters/setters
@AllArgsConstructor(staticName = "of")
@NoArgsConstructor(access = AccessLevel.PRIVATE, force = true)
static class EnumDto {
    private final String code;       // 枚举常量的名字
    private final String message;   // 对应的文字说明或其他元数据
}

@GetMapping(value="/enums", produces="application/json")
@ResponseBody
public Map<String,Object> getAllEnums(){
    Map<String,Object> enumsMap=new HashMap<>();
    
    Stream.of(Status.values()).forEach(e->{
        enumsMap.put(e.name(),EnumDto.of(e.name(),"状态"+e.ordinal()));
    });
        
    return enumsMap;
}

这种方法更灵活，允许携带额外的信息给前端开发者使用[^2]。

#### 方法三：利用Spring框架特性自动处理

对于基于Spring的应用程序来说，还可以借助`@JsonFormat(shape= JsonFormat.Shape.OBJECT)`注解让Jackson库帮助完成复杂的映射工作，从而简化编码过程。

@JsonFormat(shape= JsonFormat.Shape.OBJECT)
enum Color {
    RED("红色"), GREEN("绿色");

    private final String description;

    Color(String desc){
        this.description = desc;
    }

    public String getDescription(){return description;}
}

上述配置使得每次Color类型的变量被序列化时都会按照自定义的对象结构输出而不是简单的字符串形式[^3]。