Android开发常用的注解语法

以前没太关注也没有在日常开发中使用注解。

最近看了一些“别人家的”代码,发现注解用的挺好的,尤其是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或数组的长度,感觉很有用,不过目前还没实战中使用到...

参考文章:

http://droidyue.com/blog/2016/08/14/android-annnotation/





 

猜你喜欢

转载自blog.csdn.net/bencheng06/article/details/79401088