在Android中使用枚举注解而不是枚举

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 包中提供的注解帮我们解决这个问题。

@IntDef

我们先看用法，使用上面的例子

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(@FileTypeDef int fileType) 表示 fileType 的取值只能是 TYPE_MUSIC,TYPE_PHOTO,TYPE_TEXT。

如果在传参时没有按照指定的值那么编辑器就会发出警告，这样就可以在编码的时候进行提示。

@StringDef

同样地，还可以对字符串常量定义注解。例如对于以下文件

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 *。

有木有？

微信关注我们，可以获取更多

---