Java设备通信命令优化：如何设计通用字段读写方法？

你完全找对方向了！用枚举（Enum）来封装每个字段对应的命令规则，绝对是解决这类重复代码问题的最优解之一——既解决了命令格式因字段而异的问题，又能大幅简化API设计、消除冗余代码。

核心思路：用枚举集中管理字段的命令规则 #

每个字段的读写命令都有固定的格式差异，我们可以把每个字段的读取命令模板和写入命令模板封装到枚举常量中，然后通过通用的getField()和setField()方法来调用这些模板生成命令，再发送给设备。

具体实现步骤 #

1. 定义字段枚举，封装命令模板

首先创建一个枚举类，每个枚举常量对应一个设备字段，同时存储该字段的读取命令、写入命令模板：

public enum DeviceField {
    FIELD_ALPHA("\u001BABCDEF\u000D", "\u001BABC*%sDEF\u000D"),
    FIELD_BETA("\u001BOPQRST\u000D", "\u001BOPQ*%sRST\u000D"),
    // 依次添加其他字段...
    ;

    private final String getCommand;
    private final String setCommandTemplate;

    // 构造方法：初始化读写命令模板
    DeviceField(String getCommand, String setCommandTemplate) {
        this.getCommand = getCommand;
        this.setCommandTemplate = setCommandTemplate;
    }

    // 生成读取命令的字节数组
    public byte[] buildGetCommandBytes() {
        return getCommand.getBytes();
    }

    // 生成写入命令的字节数组（传入要设置的值）
    public byte[] buildSetCommandBytes(String value) {
        return String.format(setCommandTemplate, value).getBytes();
    }
}

如果想让模板更清晰，可以把ESC和CR字符抽成常量，避免直接写转义字符：

private static final char ESC = '\u001B';
private static final char CR = '\u000D';

public enum DeviceField {
    FIELD_ALPHA(
        String.format("%sABCDEF%s", ESC, CR),
        String.format("%sABC*%%sDEF%s", ESC, CR)
    ),
    FIELD_BETA(
        String.format("%sOPQRST%s", ESC, CR),
        String.format("%sOPQ*%%sRST%s", ESC, CR)
    ),
    // ...
}

2. 实现通用的读写方法

接下来只需要两个通用方法，替代原来20多个重复的字段读写方法：

// 通用读取字段方法
public String getField(DeviceField field) {
    byte[] commandBytes = field.buildGetCommandBytes();
    return sendMessage(commandBytes);
}

// 通用写入字段方法
public String setField(DeviceField field, String value) {
    byte[] commandBytes = field.buildSetCommandBytes(value);
    return sendMessage(commandBytes);
}

3. 调用示例

使用的时候非常简洁，而且类型安全（只能传入预定义的枚举值，不会出现拼写错误）：

// 读取fieldAlpha
String alphaValue = getField(DeviceField.FIELD_ALPHA);

// 设置fieldBeta
String betaResponse = setField(DeviceField.FIELD_BETA, "newBetaValue");

为什么这个方案更优？ #

• 彻底消除重复代码：原来每个字段都要写几乎一样的方法，现在只需要在枚举里添加一行常量定义即可，维护成本直接下降。
• 类型安全：编译期就能检查传入的字段是否合法，避免了字符串字段名拼写错误导致的运行时问题。
• 命令规则集中管理：所有字段的命令格式都集中在枚举类里，后续修改某个字段的命令格式时，只需要修改对应枚举常量的模板，不用到处找对应的方法。
• API简洁易用：调用方的代码更清晰，一眼就能看出是在操作哪个字段，可读性大幅提升。

你的顾虑“命令序列因字段而异”完全不用担心——每个枚举常量可以独立定义自己的命令模板，完美适配不同字段的格式差异，同时又通过通用方法统一了对外的API，兼顾了灵活性和简洁性。

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