以前没太关注也没有在日常开发中使用注解。
最近看了一些“别人家的”代码,发现注解用的挺好的,尤其是SDK的开发中可以使用注解对代码做一些约束,不仅能提高编码效率,还能提高代码的可读性和约束性。下面主要举几个使用场景。
1. 仿枚举写法
众所周知,Java中的枚举在内存敏感的环境下是不建议使用的(Android 中的 Enum 到底占多少内存?),所以Google提供了@StringDef和@IntDef来做一个仿枚举的效果。
Talk is cheap, show me the fucking code.
//用户信息中有个用户状态的属性,取值有两种
public static final String STATUS_VALID="VALID";
public static final String STATUS_INVALID="INVALID";
//声明一个可取值为STATUS_VALID和STATUS_INVALID的枚举类型。
//RetentionPolicy.SOURCE标记新的注解只在源码生效
@Retention(RetentionPolicy.SOURCE)
@StringDef({
STATUS_VALID,
STATUS_INVALID
})
public@interfaceUserStatusEnum{}
//使用新注解
private@UserStatusEnumStringstatus;
publicvoidsetStatus(@UserStatusEnumStringstatus){
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或数组的长度,感觉很有用,不过目前还没实战中使用到...
参考文章: