Enums often require more than twice as much memory as static constants. You should strictly avoid using enums on Android.
很多开发规范都是不建议在Android中使用枚举的,在Android系统中使用枚举的开销是使用常量的2倍。一般地,在一个文件中定义常量
public class FileType {
public static final int TYPE_MUSIC = 0;
public static final int TYPE_PHOTO = 1;
public static final int TYPE_TEXT = 2;
public final int fileType;
public FileType(int fileType) {
this.fileType = fileType;
}
}
但这样的定义会有一定有小问题。就是这个类在给他人使用时,构造函数由于参数是 int
类型。所以他可以传递我们定义好的3种类型中的其它任意 int
数值,这就有可能会产生某种错误。我们希望 当用户输入了我们定义之外的数值,编辑器可以给我们提示。下面我们就看看 android.support.annotation
包中提供的注解帮我们解决这个问题。
我们先看用法,使用上面的例子
public class FileType {
public static final int TYPE_MUSIC = 0;
public static final int TYPE_PHOTO = 1;
public static final int TYPE_TEXT = 2;
public final int fileType;
//Retention 是元注解,简单地讲就是系统提供的,用于定义注解的“注解”
@Retention(RetentionPolicy.SOURCE)
//这里指定int的取值只能是以下范围
@IntDef({TYPE_MUSIC, TYPE_PHOTO, TYPE_TEXT})
@interface FileTypeDef {
}
public FileType(@FileTypeDef int fileType) {
this.fileType = fileType;
}
}
@Retention
是元注解,简单地讲就是系统提供的,用于定义注解的“注解”。使用这个标识了注解的生命周期,这里指定值为 RetentionPolicy.SOURCE
说明这个注解保留在源码阶段。还有 RetentionPolicy.RUNTIME
, RetentionPolicy.CLASS
分别表示这个注解保留到运行时,和字节码阶段。
我们这里使用 RetentionPolicy.SOURCE
的用意就是在编码时能够识别出错误的 FileType
,至于 RUNTIME
和 CLASS
阶段的状态,我们是不关心的。
@IntDef
是 android.support.annotation
包定义的注解,使用它来规范我们的 fileType
变量的取值范围。例如在构造函数中使用 FileType(@FileTypeDefintfileType)
表示 fileType
的取值只能是 TYPE_MUSIC,TYPE_PHOTO,TYPE_TEXT
。
如果在传参时没有按照指定的值那么编辑器就会发出警告,这样就可以在编码的时候进行提示。
同样地,还可以对字符串常量定义注解。例如对于以下文件
public class FileType {
public static final String TYPE_MUSIC = "mp3";
public static final String TYPE_PHOTO = "png";
public static final String TYPE_TEXT = "txt";
public final String fileType;
public FileType(String fileType) {
this.fileType = fileType;
}
}
使用 @StringDef
注解
public class FileType {
//...类型定义
public final String fileType;
//Retention 是元注解,简单地讲就是系统提供的,用于定义注解的“注解”
@Retention(RetentionPolicy.SOURCE)
//这里指定int的取值只能是以下范围
@StringDef({TYPE_MUSIC, TYPE_PHOTO, TYPE_TEXT})
@interface FileTypeDef {
}
public FileType(@FileTypeDef int fileType) {
this.fileType = fileType;
}
}
使用注解除了可以避免不必要错误外,还能瞬间提升自己写代码的 Level。
有木有?
鼓励我