以前没太关注也没有在日常开发中使用注解。
最近看了一些“别人家的”代码,发现注解用的挺好的,尤其是SDK的开发中可以使用注解对代码做一些约束,不仅能提高编码效率,还能提高代码的可读性和约束性。下面主要举几个使用场景。
1. 仿枚举写法
众所周知,Java中的枚举在内存敏感的环境下是不建议使用的(Android 中的 Enum 到底占多少内存?),所以Google提供了@StringDef 和 @IntDef 来做一个仿枚举的效果。
Talk is cheap, show me the fucking code.
* 1.变量声明
//用户信息中有个用户状态的属性,取值有两种
public static final String STATUS_VALID="VALID";
public static final String STATUS_INVALID="INVALID";
2.类型定义,简单的相当于以前的枚举的定义
//声明一个可取值为STATUS_VALID和STATUS_INVALID的枚举类型。
//RetentionPolicy.SOURCE标记新的注解只在源码生效
@Retention(RetentionPolicy.SOURCE)
@StringDef({
STATUS_VALID,
STATUS_INVALID
})
除了上面的这些Google还提供了 @intDef 等等类型
3. 强制约束变量为上述定义的其中之一,如果不符合规则,编译器将在编译器报错,抛出异常
public @interface UserStatusEnum{}
//使用新注解
3.1 成员变量这样使用
private @UserStatusEnum String status;
3.2 当然捏可以在方法中这样去使用
public void setStatus(@UserStatusEnum String status){
this.status=status;
}
如果赋值不对,则会提示:
2. 资源注解
在Android中所有ResourceId都是int类型,有些用ResourceId做参数的地方因为没有任何限制所以可能传入的int值不是合法的ResourceId。So, Android支持通过注解限制ResourceId。
比如下面的例子:
无注解:
使用注解:
@Override
publicvoidsetContentView(@LayoutResintlayoutResID){
super.setContentView(layoutResID);
unbinder=ButterKnife.bind(this);
}
这样调用方,如果直接传int参数就会提示异常喽:
Android中支持的资源文件注解:
AnimRes AnimatorRes AnyRes ArrayRes AttrRes BoolRes ColorRes DimenRes DrawableRes FractionRes IdRes IntegerRes InterpolatorRes LayoutRes MenuRes PluralsRes RawRes StringRes StyleRes StyleableRes TransitionRes XmlRes
3. 一些零散又实用的注解
@Nullable, @NonNull 这是编译器常提示的俩注解了,主要是帮助做一些空值的判断。
@CheckResult
用这个注解标记的方法,必须要求有返回值处理。
@CallSuper
在父类添加此标签,强制要求重写的方法的子类必须调用父类方法。
@Size可以限制String或数组的长度,感觉很有用,不过目前还没实战中使用到...
参考文章: