问题
我们偶尔能在项目中看到如下风格的代码:
public class ResponseCode {
public static final int SUCCESS = 0;
public static final int FAILURE = 10000;
public static final int ILLEGAL_ARGUMENT = 10001;
//........
}
这样的代码一般被叫做int枚举模式。其包含着大量缺点:
- int枚举是编译时常量,被编译到客户端中,如果枚举常量关联的int发生变化,客户端必须重新编译,如果没有重新编译,程序仍可以运行,但行为就不确定了。
- 将int枚举常量翻译成可打印的字符串很麻烦。
在本例中,我要向客户端返回一个错误码和错误信息,错误码可以通过
ResponseCode.FAILURE获得
,但是错误信息恐怕只能以"FAILURE"
这样的hard code返回了。
- 遍历一个组中所有的int枚举常量,获得int枚举组的大小,没有可靠的方法。
在这种int枚举模式
的基础上,还有一种变体,我们称之为String枚举模式
。虽然它提供了可打印的字符串,但这种方式存在性能问题,因为依赖于字符串的比较操作。
还有一种代码类似:
public interface CascadeConstant {
String DELETION_CHECK_CODE = "deletion.check";
String DELETION_DELETE_CODE = "deletion.delete";
String DELETION_FORCE_DELETE_CODE = "deletion.forceDelete";
String DELETION_CLEANUP_CODE = "deletion.cleanup";
List<String> DELETION_CODES = Arrays.asList(DELETION_CHECK_CODE, DELETION_DELETE_CODE, DELETION_FORCE_DELETE_CODE);
}
这样的代码我们一般称之为常量接口(constant interface)——这种接口不包含任何方法,它只包含静态的final域,每个域都导出一个常量。
类实现接口时,接口就充当可以引用这个类的实例类型。因此,类实现了接口,就表明客户端对这个类的实例可以实施某些动作。为了任何其他目的而定义的接口是不恰当的。
常量接口是对接口的一种不良使用。类在内部使用某些常量,纯粹是实现细节,实现常量接口,会导致把这样的实现细节泄露到该类的导出API中,因为接口中所有的域都是及方法public的。类实现常量接口,这对于这个类的用户来讲并没有实际的价值。实际上,这样做返回会让他们感到更糊涂,这还代表了一种承诺:如果在将来的发行版本中,这个类被修改了,它不再需要使用这些常量了,依然必须实现这个接口,以确保二进制兼容性。如果非final类实现了常量接口,它的所有子类的命名空间都受到了污染。Java平台类库中存在几个常量接口,如java.io.ObjectStreamConstants,这些接口都是反面典型,不值得效仿。
那既然不适合存在全部都是导出常量的常量接口,那么如果需要导出常量,它们应该放在哪里呢?如果这些常量与某些现有的类或者接口紧密相关,就应该把这些常量添加到这个类或者接口中,注意,这里说添加到接口中并不是指的常量接口。在Java平台类库中所有的数值包装类都导出MIN_VALUE和MAX_VALUE常量。如果这些常量最好被看作是枚举类型成员,那就应该用枚举类型来导出。否则,应该使用不可实例化的工具类来导出这些常量。
实践
我们先看改良版的ResponseCode :
public enum ResponseCode {
SUCCESS(0),
ERROR(10000),
ILLEGAL_ARGUMENT(10001);
private final int code;
ResponseCode(int code) {
this.code = code;
}
public int getCode() {
return code;
}
public static ResponseCode getEnum(int value) {
for (ResponseCode responseCode : ResponseCode.values()) {
if (responseCode.getCode()==value) {
return responseCode;
}
}
return null;
}
}
这样就克服了我们之前提到的缺点:类型确定。
在int枚举模式中或者String枚举模式中,我们会写出这样的方法签名:
//int 枚举模式
SendResponse(String description,int value)
//String枚举模式
//SendResponse(String description,int value)
这样的代码其实并不可靠,我们可以考虑:
SendResponse(String description,int code)
那么在调用的时候实质上是:
SendResponse(ResponseCode.ERROR.toString(),ResponseCode.ERROR.getCode())
为了更加方便,我们可以在此之上简单的封装一层:
AutoBuildAndSendResponse(ResponseCode responseCode){
SendResponse(responseCode.toString(),responseCode.getCode();
}
这就很美滋滋。
在这个情况下,我们甚至还可以考虑在SendResponse方法中再加一个名为
errorDetail
的参数。利用方法重载,使Reponse的返回信息更为灵活。
不仅如此,Java的枚举类是很强大的。其本质是int值,并且背后基本原理也非常简单:它们就是通过共有的静态final域为每个枚举常量导出实例的类。因为没有可以访问的构造器,枚举类是真正的final。因为客户端既不能创建枚举类型的实例,也不能对它进行扩展,因此很可能没有实例,而只有声明过的枚举常量。换句话说,枚举类型是实例受控的。而且,Java的枚举类还可以添加任意的方法和域,并实现任意接口,而且也提供了所有的Object方法的高级实现。
关于StringValue的较佳实践
public enum SourceDiskType {
SYSTEM("system"),
DATA("data"),;
private String stringValue;
SourceDiskType(String stringValue) {
setStringValue(stringValue);
}
public String getStringValue() {
return stringValue;
}
public void setStringValue(String stringValue) {
this.stringValue = stringValue;
}
public static SourceDiskType getEnum(String stringValue) {
if (null == stringValue) {
return null;
}
for (SourceDiskType sourceDiskType : SourceDiskType.values()) {
if (sourceDiskType.getStringValue().equals(stringValue)) {
return sourceDiskType;
}
}
return null;
}
}
这是阿里云早期版本SDK中的一段代码。
网友评论