Android 注解的一些应用以及原理

在这边文章之前你首先需要对java 的注解部分有一个基本的了解(不需要太过的深入)。

简单来说,注解这个东西就是用于辅助我们开发java代码的,注解本身无法干扰java源代码的执行。

在android 里面 注解主要用来干这么几件事:

1.和编译器一起给你一些提示警告信息。

2.配合一些ide 可以更加方便快捷 安全有效的编写java代码。谷歌出的support-annotations这个库 就是主要干这个的。

3.和反射一起 提供一些类似于spring 可配置的功能,方便简洁(这部分有过j2ee 开发经验的可以直接跳过了)。

首先来看一下官方提供的库吧。首先在build文件里 增加一句话

compile ‘com.android.support:support-annotations:22.2.0‘

这个地方要注意,我现在是取得version22.2的版本,你们引用的时候如果有更新,android studio可能会提示你sync失败,这个时候你要自己去谷歌官网查询一下最新的版本号自己替换。

然后我们就可以看看这个谷歌的注解库 为我们提供了哪些功能。

http://tools.android.com/tech-docs/support-annotations 这个是官方的文档 我也是主要根据这个来讲解这个库的使用。

首先来看 Nullness 注解 这个主要是有两种@Nullable  和 @NonNull。

前者表示可以为空 后者表示不能为空。

我只演示后者(前者可以自己测试)定义一个函数

然后我们去调用他 看看。

1  String a=null;
2         sayHello(a);

这个时候IDE就自动会给我们警告信息了(其实ide 的警告信息多数也是从编译器而来)

1 Argument ‘a‘ might be null less... (Ctrl+F1)
2 This inspection analyzes method control and data flow to report possible conditions that are always true or false, expressions whose value is statically proven to be constant, and situations that can lead to nullability contract violations.
3 Variables, method parameters and return values marked as @Nullable or @NotNull are treated as nullable (or not-null, respectively) and used during the analysis to check nullability contracts, e.g. report possible NullPointerException errors.
4 More complex contracts can be defined using @Contract annotation, for example:
5 @Contract("_, null -> null") — method returns null if its second argument is null @Contract("_, null -> null; _, !null -> !null") — method returns null if its second argument is null and not-null otherwise @Contract("true -> fail") — a typical assertFalse method which throws an exception if true is passed to it
6 The inspection can be configured to use custom @Nullable
7 @NotNull annotations (by default the ones from annotations.jar will be used)

再介绍一下

Resource Type Annotations

定义一个方法

1  private String sayHello(@StringRes int resId) {
2         return "";
3     }

然后调用

1         sayHello(R.layout.activity_main);

这个地方这个注解的意思是你只能传string 类型的id进去 而我们传了layout类型的,如果你不加那个注解的话 ide和编译器是没有反应的,到运行期才会有错误。

但是你加了以后就会发现

IDE也是直接报错的!

再比如这样一段代码

 1  class TestAnoataion {
 2
 3         public void testAnoation() {
 4             Log.v("main", "test anoation");
 5         }
 6     }
 7
 8     class TestAnoataion2 extends TestAnoataion
 9     {
10         public void testAnoation()
11         {
12
13         }
14     }

假使我们父类的设计的时候本意是 如果你要重写testAnoation这个方法一定得调用父类的testAnation这个方法。就跟我们activity的oncreate方法一样。

哪如果子类没有写super.testAnoation的话 你根本就不知道 就很容易报错。但是如果你加了注解。那么ide就会很明确的提示你错误

是不是很强大?当你调用了super语句以后 一切就和谐了!

那这个support库 就暂时介绍到这里,个人建议大家有时间一定要自己过一遍一个官方文档。

这里定义的注解 对提高大家的代码质量 会非常非常有帮助。一定要掌握学会。

最后再上一个小例子吧,很多android 开发者都喜欢依赖注入的一些开源库,来绑定你的控件id。

这样写法不但优雅而且好用。

Butterknife

这个开源库大家一定很多人都用过,我就写一个小demo 来演示一下这些库的原理,其实还蛮简单的。

需要注意的是 要理解这个小demo 需要你除了知道注解的基础知识以外还需要有反射的基础知识。

关于反射我很久之前也写过一个教程

http://www.cnblogs.com/punkisnotdead/p/3384464.html

不会的可以赶紧补一下。

首先定义一个InjectView注解

 1 package com.example.administrator.testfab;
 2
 3 import java.lang.annotation.ElementType;
 4 import java.lang.annotation.Retention;
 5 import java.lang.annotation.RetentionPolicy;
 6 import java.lang.annotation.Target;
 7
 8 /**
 9  * Created by Administrator on 2015/8/5.
10  */
11
12 @Target(ElementType.FIELD)
13 @Retention(RetentionPolicy.RUNTIME)
14 public @interface InjectView {
15     //id就表示哪些控件,-1就表示取不到时候的默认值
16     int id() default -1;
17 }

然后定义一个解释器

 1 package com.example.administrator.testfab;
 2
 3 import android.app.Activity;
 4 import android.view.View;
 5
 6 import java.lang.reflect.Field;
 7
 8 /**
 9  * Created by Administrator on 2015/8/5.
10  */
11 public class InjectViewParser {
12
13     public static void inject(Object object) {
14
15         try {
16             parse(object);
17         } catch (Exception e) {
18             e.printStackTrace();
19         }
20     }
21
22     public static void parse(Object object) throws Exception {
23         final Class<?> clazz = object.getClass();
24         View view = null;
25         Field[] fields = clazz.getDeclaredFields();
26         for (Field field : fields) {
27             if (field.isAnnotationPresent(InjectView.class)) {
28                 InjectView injectView = field.getAnnotation(InjectView.class);
29                 int id = injectView.id();
30                 if (id < 0) {
31                     throw new Exception("id must not be null");
32                 } else {
33                     field.setAccessible(true);
34                     if (object instanceof View) {
35                         view = ((View) object).findViewById(id);
36                     } else if (object instanceof Activity) {
37                         view = ((Activity) object).findViewById(id);
38                     }
39                     field.set(object, view);
40                 }
41
42             }
43
44         }
45
46     }
47 }

最后在actity里使用即可

 1 package com.example.administrator.testfab;
 2
 3 import android.os.AsyncTask;
 4 import android.os.Bundle;
 5 import android.support.annotation.CallSuper;
 6 import android.support.annotation.NonNull;
 7 import android.support.annotation.Nullable;
 8 import android.support.annotation.StringRes;
 9 import android.support.v7.app.AppCompatActivity;
10 import android.util.Log;
11 import android.view.Menu;
12 import android.view.MenuItem;
13 import android.widget.Button;
14
15 public class MainActivity extends AppCompatActivity {
16
17     @InjectView(id = R.id.bt)
18     private Button bt;
19
20
21     @Override
22     protected void onCreate(Bundle savedInstanceState) {
23         super.onCreate(savedInstanceState);
24         setContentView(R.layout.activity_main);
25         //开始注入
26         InjectViewParser.inject(this);
27         //这个主要是测试注入id 成功没有 成功了就不会报错~
28         bt.setText("inject done");
29
30
31     }
32
33
34     @Override
35     public boolean onCreateOptionsMenu(Menu menu) {
36         // Inflate the menu; this adds items to the action bar if it is present.
37         getMenuInflater().inflate(R.menu.menu_main, menu);
38         return true;
39     }
40
41     @Override
42     public boolean onOptionsItemSelected(MenuItem item) {
43         // Handle action bar item clicks here. The action bar will
44         // automatically handle clicks on the Home/Up button, so long
45         // as you specify a parent activity in AndroidManifest.xml.
46         int id = item.getItemId();
47
48         //noinspection SimplifiableIfStatement
49         if (id == R.id.action_settings) {
50             return true;
51         }
52
53         return super.onOptionsItemSelected(item);
54     }
55
56
57
58 }

  
时间: 2024-07-30 16:50:57

Android 注解的一些应用以及原理的相关文章

Java Android 注解(Annotation) 及几个常用开源项目注解原理简析

不少开源库(ButterKnife.Retrofit.ActiveAndroid等等)都用到了注解的方式来简化代码提高开发效率. 本文简单介绍下 Annotation 示例.概念及作用.分类.自定义.解析,并对几个 Android 开源库 Annotation 原理进行简析.PDF 版: Java Annotation.pdf, PPT 版:Java Annotation.pptx, Keynote 版:Java Annotation.key 完整版原文见:Java Android 注解(Ann

Android注解使用之通过annotationProcessor注解生成代码实现自己的ButterKnife框架

前言: Annotation注解在Android的开发中的使用越来越普遍,例如EventBus.ButterKnife.Dagger2等,之前使用注解的时候需要利用反射机制势必影响到运行效率及性能,直到后来android-apt的出现通过注解根据反射机制动态编译生成代码的方式来解决在运行时不再使用发射机制,不过随着android-apt的退出不再维护,我们今天利用Android studio的官方插件annotationProcessor来实现一下自己的ButterKnife UI注解框架. 需

android注解使用详解(图文)

在使用Java的SSH框架的时候,一直在感叹注解真是方便啊,关于注解的原理,大家可以参考我的另一片文章Java注解详解.最近有时间研究了android注解的使用,今天与大家分享一下. android中注解的使用用到了GitHub上的开源框架androidannotations,下载地址.这个开源框架应该是目前使用人数最多的android注解框架了,主要是由于它设计的注解标签非常多,能够满足我们日常开发中的大部分需求.androidannotations将许多可以抽取出来的方法都包装成了注解标签供

【金阳光测试】Android自动化 -- 学习历程:MonkeyRunner原理初步

章节:自动化基础篇——MonkeyRunner原理初步 网易云课堂: http://study.163.com/course/courseLearn.htm?courseId=712011#/learn/video?lessonId=877115&courseId=712011 主要讲解内容及笔记: 一.理论知识和脚本演示 最佳方式是上官网文档去查看monkeyrunner的介绍,官网上不去,就找了一个本地的android 4.2 的查看,基本内容没啥变化 First,什么是MonkeyRunn

Android 手机裸眼 3D 技术原理和编程实现

"-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> android手机裸眼3D技术原理和编程实现 - 懒人日志 - 博客频道 - CSDN.NET 懒人日志 懒人 目录视图 摘要视图 订阅 [活动]2017 CSDN博客专栏评选 &nbsp [5月书讯]流畅的Python,终于等到你!    &nbsp CSD

Android通用脱壳工具DexHunter的原理分析和使用说明(二)

本文博客地址:http://blog.csdn.net/qq1084283172/article/details/53715325 前面的博文<Android通用脱壳工具DexHunter的原理分析和使用说明(一)>中已经记录了很多关于DexHunter脱壳工具的脱壳原理和思考的思路问题并没有涉及到DexHunter脱壳工具的代码的分析,今天我就代码分析.理解和DexHunter脱壳工具的使用以及需要注意的地方进行博文的记录. 在阅读DexHunter的代码之前,复习下几个须知: 1>.

Android大图片裁剪终极解决方案 原理分析

约几个月前,我正为公司的APP在Android手机上实现拍照截图而烦恼不已. 上网搜索,确实有不少的例子,大多都是抄来抄去,而且水平多半处于demo的样子,可以用来讲解知识点,但是一碰到实际项目,就漏洞百出. 当时我用大众化的解决方案,暂时性的做了一个拍照截图的功能,似乎看起来很不错.问题随之而来,我用的是小米手机,在别的手机上都运行正常,小米这里却总是碰钉子.虽然我是个理性的米粉,但是也暗地里把小米的工程师问候了个遍.真是惭愧! 翻文档也找不出个答案来,我一直对com.android.came

android系统自带的Service原理与使用

1. 说明 android的后台运行在很多service,它们在系统启动时被SystemServer开启,支持系统的正常工作,比如 MountService监听是否有SD卡安装及移除,ClipboardService提供剪切板功能,PackageManagerService提 供软件包的安装移除及查看等等,应用程序可以通过系统提供的Manager接口来访问这些Service提供的数据,以下将说明他们的工具流程 2. 举例说明基本流程 以android系统支持sensor(传感器)实例来说明框架层

Android ScrollView的基本使用及原理。

Android ScrollView的基本使用及原理如下: 结构 继承关系 public class ScrollView extends FrameLayout java.lang.Object android.view.View android.view.ViewGroup android.widget.FrameLayout android.widget.ScrollView 类概述 一种可供用户滚动的层次结构布局容器,允许显示比实际多的内容.ScrollView是一种FrameLayou