Java中如何声明固定3位长度的数值变量存储REST错误码？

这个需求我之前对接REST接口处理错误码时刚好碰到过！核心痛点在于：int/Integer这类数值类型本质上只存储数值大小，完全不保留前导零的格式信息——所以不管你存的是0、00还是000，在整数类型里都是同一个值0，前导零自然会丢失。要实现“始终存储固定3位长度数字（含前导零）”的需求，推荐下面几个实用方案：

方案1：直接用String存储（最简便高效） #

既然你的场景是接收REST返回的三位错误码，它更像是一个固定格式的标识符而非需要参与计算的数值，直接用String存储是最直观的选择：

// 场景1：从REST响应直接接收字符串格式的错误码
String errorCode = restResponse.getErrorCode(); // 直接拿到"000"、"031"、"100"这类字符串

// 场景2：如果拿到的是int类型，转成三位带前导零的String
int rawErrorCode = 31;
String formattedErrorCode = String.format("%03d", rawErrorCode); // 输出"031"

String.format("%03d", num)是Java里格式化数值为固定长度带前导零字符串的标准写法：%03d表示输出3位整数，不足的地方用0填充。

方案2：自定义封装类（兼顾类型安全与格式约束） #

如果担心直接用String会不小心存入非三位数字的非法值，可以自己封装一个类，内部用String存储，同时做格式校验，保证类型安全：

public class ThreeDigitErrorCode {
    private final String code;

    // 从int构造，自动格式化并校验范围
    public ThreeDigitErrorCode(int rawCode) {
        if (rawCode < 0 || rawCode > 999) {
            throw new IllegalArgumentException("错误码必须是0-999之间的整数");
        }
        this.code = String.format("%03d", rawCode);
    }

    // 从字符串构造，校验格式是否为三位数字
    public ThreeDigitErrorCode(String codeStr) {
        if (codeStr == null || !codeStr.matches("\\d{3}")) {
            throw new IllegalArgumentException("错误码必须是三位数字字符串");
        }
        this.code = codeStr;
    }

    // 获取格式化后的错误码字符串
    public String getCode() {
        return code;
    }

    // 转换为int数值（如果需要参与计算）
    public int toInt() {
        return Integer.parseInt(code);
    }

    @Override
    public String toString() {
        return code;
    }
}

使用这个类的好处：

• 避免非法值：比如不能传入1000或者"abc"这类不符合要求的错误码
• 对外暴露的永远是三位格式的字符串，不用担心格式丢失
• 同时支持从int和String两种方式构造，适配不同的输入场景

关键提醒 #

千万不要试图用int/Integer来存储带前导零的格式——数值类型的设计目标就是存储数值大小，不包含任何格式信息，前导零在数值语境下是没有意义的，所以必然会被丢弃。核心思路是把“数值”和“格式”分开：数值用来计算，格式字符串用来存储或展示固定长度的标识符。

内容的提问来源于stack exchange，提问作者geobudex