我们定义的类有一个 int 型的状态参数要设置,但我们设置的状态又只能限定在[OPEN=1, CLOSE=2]这两种状态,如果我们要提供一个接口来设置的话,那么一种做法是定义一个Enum枚举来作为参数,这样就能限定参数的取值范围了,但是使用枚举会比常量占用更多的内存。
这里可以用注解来处理这种问题,也就是下面要讲的自定义源码注解,这里需要用到一个注解@IntDef,来看下代码:
/**
* 测试源码注解
*/
public class TestSourceAnnotation {
// 状态值
public static final int STATUS_OPEN = 1;
public static final int STATUS_CLOSE = 2;
private static int sStatus = STATUS_OPEN;
private TestSourceAnnotation() {}
// 定义适用于参数的注解,限定取值范围为{STATUS_OPEN, STATUS_CLOSE}
@Retention(RetentionPolicy.SOURCE)
@Target(ElementType.PARAMETER)
@IntDef({STATUS_OPEN, STATUS_CLOSE})
public @interface Status {
}
/**
* 定义方法并使用@Status限定参数的取值
* @param status
*/
public static void setStatus(@Status int status) {
sStatus = status;
}
public static int getStatus() {
return sStatus;
}
public static String getStatusDesc() {
if (sStatus == STATUS_OPEN) {
return "打开状态";
} else {
return "关闭状态";
}
}
}
这里定义了一个@Status注解,并用注解@IntDef限定了取值范围,最后将@Status注解用在参数上就行了,这样在调用方法时只能使用指定的参数{STATUS_OPEN, STATUS_CLOSE},就算用数值1编译器也会提示报错。除了@IntDef注解外还用一个@StringDef注解可以使用,用来处理字符串。
看下使用代码:
/**
* 测试源码注解
*/
private void _testSourceAnnotation() {
if (mIsOpen) {
// TestSourceAnnotation.setStatus(1); 直接设置数值编译器会直接提示错误
TestSourceAnnotation.setStatus(TestSourceAnnotation.STATUS_CLOSE);
mIsOpen = false;
} else {
TestSourceAnnotation.setStatus(TestSourceAnnotation.STATUS_OPEN);
mIsOpen = true;
}
mTvDesc.setText(TestSourceAnnotation.getStatusDesc());
}
网友评论