对于Android开发来说，注解可是个好东西，但是利用的不多，我研究过国内不少SDK，发现很少有使用注解的，至于App的开发团队的使用情况不太清楚，但是就我接触的而言，使用的也不多。之前接触过国外的一些SDK，比如facebook相关的一些SDK，你查看一下源码，就会发现，注解是一个很普遍的存在。

注解库

如果你使用了com.android.support:appcompat-v7库不需要添加额外的依赖。
但是如果你没有使用这个库，也可以额外单独添加注解库。compile 'com.android.support:support-annotations:xx.xx.xx'。

Nullable NonNull

下面举个例子：

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        test1(null);
        test2(null);
    }
    private void test1(@NonNull String str){
        Log.e(this.getClass().getName(),str);
    }
    private void test2(@Nullable String str){
        if (str!=null){
            Log.e(this.getClass().getName(),str);
        }
    }
}

将上面代码放到IDE中，显示效果如下：

Paste_Image.png

我们可以看到test1传入的参数被加重标识出来，如果将鼠标放到上面会有如下显示：

这样，我们可以轻易发现错误，避免空指针的crash发生，养成在每个方法中加注解的习惯，增强代码的严谨性。

资源类型的注解

资源类型的注解，有以下几种：

• @StringRes
• @ColorRes
• @AnimationRes
• @DimensionRes
• @DimensionPixelOffsetRes
• @DimensionPixelSizeRes
• @BooleanRes
• @ColorStateListRes
• @DrawableRes
• @IntArrayRes
• @IntegerRes
• @LayoutRes
• @MovieRes
• @TextRes
• @TextArrayRes
• @StringArrayRes

这些注解在用法上都是一样的，只是标识的类型不一样（不一一介绍了，通过名字就能看出来），下面看一下用法：

 private void setText1(@StringRes int id){

    }
    private void setText2( int id){

    }

上面连个方法一个是带资源注解的，一个是不带的，我们在IDE中调用一下，看有什么区别：

从上图中可以看出，加了资源注解的方法，如果传入的资源是错的类型，就会报错，这样更容易发现程序中的bug。

IntDef StringDef

IntDef StringDef可以限制传入参数的内容，这在一些固定参数的方法中尤为重要，比如网络的get post方法：
比如：

 private static final int INTGET = 0;
    private static final int INTPOST = 1;
    private static final String STRGET = "get";
    private static final String STRPOST = "post";

然后使用IntDef StringDef定义注解接口

 @IntDef({INTGET, INTPOST})
    public @interface HttpMethod {
    }
    @StringDef({STRGET, STRPOST})
    public @interface MethodName {
    }

    public void setMethod(@HttpMethod int httpmethod) {

    }
    public void setMethod(@MethodName String httpmethod) {

    }

这时偶们再调用setMethod方法，会有如下效果：

传入的参数，只能是之前定义的那几个，如果是任意输入的都会提示报错。

权限注解

对于有些方法可能需要系统的一些权限，但是我们会忘了在Manifest中加入这些权限，导致程序报错。这时我们就可以使用权限注解：

 @RequiresPermission(Manifest.permission.INTERNET)
    private void getDataFromNet(){

    }

这时，如果没有这个权限，然后去调用这个方法：

强制super

比如我们写一个基类：

public class Base {
    @CallSuper
    public void test(){
        Log.e("","");
    }
}

这时如果我们写一个类，继承这个类，如果不去super父类的方法就会这样：

@keep

一看到这个词肯定第一反应就是跟混淆相关的，没错，这个就是标识该方法被keep出来，当然你也可以在混淆文件中keep，混淆文件的规则可以参考Android混淆机制

总结

基本的注解就总结到这里，使用注解，养成一个良好的代码习惯，可以使代码更加严谨。