AndroidAnnotations详解

最新推荐文章于 2021-05-27 05:36:52 发布
最新推荐文章于 2021-05-27 05:36:52 发布
阅读量784 收藏 1
点赞数
文章标签： 注解 Annotations Android android开发 开源框架
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u014254481/article/details/78838659
版权

几年前整理的攻略，放上来自己消化。

AndroidAnnotations是一个能够让你快速进行Android开发的开源注解框架，相比原生的android开发，它能够帮助你减少大量的重复代码，将精力集中于真正精髓的部分，降低代码冗余，提高代码可维护性。框架的机制类似于java spring框架中的IOC，jar包小，功能强大，使用非常方便。

对于使用了 AndroidAnnotations的代码和原生代码的区别，举最简单的例子来看：

布局文件：

[html] view plaincopy

<LinearLayoutxmlns:androidLinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"  

xmlns:tools="http://schemas.android.com/tools"  

android:layout_width="match_parent"  

android:layout_height="match_parent"  

android:orientation="vertical"  

tools:context=".MainActivity">  

<EditText  

android:id="@+id/et"  
android:layout_width="match_parent"  

android:layout_height="wrap_content"  

android:hint="Enter thecontent"/>  
<TextView  

android:id="@+id/tv"  

android:layout_width="match_parent"  

android:layout_height="wrap_content"  

android:text="Content:"/>  
<Button  

android:id="@+id/btn"  
android:layout_width="match_parent"  

android:layout_height="wrap_content"  

android:text="click me"/>  

 

</LinearLayout>

 

这个布局文件中可以看到只有最简单的几个常用控件，那么使用普通代码初始化赋值如下：

普通代码：

[java] view plaincopy

1. public class MainActivity extends Activity {  

2.    

3.     EditText et;  

4.     TextView tv;  

5.     Button btn;  

6.    

7.     @Override  

8.     protected void onCreate(Bundle savedInstanceState) {  

9.        super.onCreate(savedInstanceState);  

10.        setContentView(R.layout.activity_main);  

11.    

12.        et = (EditText) findViewById(R.id.et);  

13.        tv = (TextView) findViewById(R.id.tv);  

14.        btn = (Button) findViewById(R.id.btn);  

15.    

16.        btn.setOnClickListener(new OnClickListener() {  

17.    

18.            @Override  

19.            public void onClick(View v) {  

20.               tv.setText("Content:" +et.getText());  

21.            }  

22.        });  

23.    

24.     }  

25. }  

而使用AndroidAnnotations的代码，则结果如下：

Annotations代码：

[java] view plaincopy

1. @EActivity(R.layout.activity_main)  

2. public class MainActivity extends Activity {  

3.    

4.     @ViewById  

5.     EditText et;  

6.     @ViewById  

7.     TextView tv;  

8.    

9.     @Click  

10.     void btn() {  

11.        tv.setText("Content:" +et.getText());  

12.     }  

13.    

14. }  

可以看到单从行数上来说，代码量几乎是减少了一半，这对开发来讲效率和维护性的提高都是非常明显的。

在上面的代码中，我们可以看到使用了@EActivity、@ViewById、@Click三个annotation（注解）,当然它还提供了其他很多annotation。单单就代码里面这几个来说，首先@EActivity后必须要有一个layout id 来表示这个Activity所使用的布局，原来的onCreate方法就不需要再用了，这样可以让我们少写一些代码，@ViewById就和原来的findViewById()方法一样。

值得注意的是：@ViewById后的id是可以不写的，但是要求控件变量名称要与xml中定义的id一致,也就是说，当我在xml文件中定义的TextView的id必须是：android:id="@+id/textView" . 这样我们在@ViewById后就不用再写括号了，直接写

[html] view plaincopyprint?

1. @ViewById  

2. TextView textView;  


就可以了。但是这样会有一个问题，运行时会报出：NullPointerException空指针异常，我们就不能在myButton()方法中直接使用，而是要加上@AfterView注解。

[java] view plaincopyprint?

1. @AfterView  

2. void init(){  

3.     textView.setText("Hello");  

4. }  


这样就不会有问题了。对于@Click，方法名和xml文件中的id一样就可以这样写，AndroidAnnotations会自动识别，对于

多个Button，可以写多个@Click，比如这样：

[java] view plaincopyprint?

1. @Click({R.id.button1,R.id.button2,R.id.button3})  

2. void buttonClicked(Button bt){  

3.     switch(bt.getId()){  

4.     case R.id.button1:  //  

5.         break;  

6.         ...  

7.     }  

8. }  

至于xml文件，还是和之前一样。

需要注意的一点就是：使用AndroidAnnotations千万要记得，编译的时候会生成一个子类，这个子类的名称就是在原来的类之后加了一个下划线“_”，比如这个例子产生的子类名称为“MyActivity_”，这就需要你在注册这个Activity的时候，在AndroidManifest.xml中将MyActivity改为MyActivity_，使用的时候也是使用MyActivity_来表示此类，如从另一个Activity跳转到此界面就要这样用：

[java] view plaincopyprint?

1. startActivity(new Intent(this,MyActivity_.class));  


注意，是MyActivity_.class不是MyActivity.class;

 

以下是我整理出来的初次使用annotations的方法：

 

AndroidAnnotations部署

 

环境：

系统：windows 8.1（64bit）

开发工具：Eclipse 3.8

JDK版本：jdk1.6

构建工具：Ant（Eclipse默认的build tool）

androidannotations：2.7

 

步骤：

1. 下载并导入jar包

2. 配置Ant

3. 配置Eclipse

 

1.  jar包官网下载地址https://github.com/excilys/androidannotations/wiki/Download;

解压后的两个jar包androidannotations-api-2.7.1.jar和androidannotations-2.7.1.jar分别放在项目的libs文件夹下和compile-libs文件夹下（compile-libs需要自己创建，创建在项目的根目录下就行。如果放在了同一文件夹下必然出错，因为两个包里存在相同的文件路径和文件名）。

 

2. 配置Ant只需要在项目的根目录下创建两个文件即可（build.xml和custom_rules.xml）

创建build.xml使用cmd命令

[plain] view plaincopy

1. android update project --path "$PROJECT_ROOT$"  

如果没有配置android环境变量要进入到..\sdk\tools\目录下去执行，"$PROJECT_ROOT$"为项目的根路径，例如：

D:\Program Files\adt-bundle-windows-x86_64\sdk\tools>android update project --path F:\work_in_geekon\workspace\TestAA

至于custom_rules.xml手动创建即可，首先添加如下内容

[html] view plaincopy

1. <propertynamepropertyname="generated.dir"value=".apt_generated"/>  

2. <propertynamepropertyname="generated.absolute.dir"location="${generated.dir}"/>  

3. <propertynamepropertyname="java.compilerargs"value="-s'${generated.absolute.dir}'"/>  

4. <targetnametargetname="-pre-compile">  

5.       <mkdirdirmkdirdir="${generated.absolute.dir}"/>  

6. </target>  

打开$ANDROID_SDK_ROOT$/tools/ant/build.xml（例如我的D:\ProgramFiles\adt-bundle-windows-x86_64\sdk\tools\ant\build.xml），找到节点<target name="-compile"…

[html] view plaincopy

1. <targetnametargetname="-compile"depends="-build-setup, -pre-build, -code-gen, -pre-compile">  

2.  ...  

3. </target>  

将上述内容全部copy到custom_rules.xml中。找到以下节点（在custom_rules.xml文件中），并添加

[html] view plaincopy

1. <fileset dir="compile-libs"includes="*.jar"/>  

<target name="-compile" ...>
...
            <path id="project.javac.classpath">
                ...
               <fileset dir="compile-libs" includes="*.jar"/>
            </path>
...
</target>

绿色部分为新增内容。保存文件，Ant的配置也就OK了。

 

3. 配置Eclipse。

选择项目右键，Properties à Java Compiler ,确保编译器版本为1.6及以上。

Properties >> Java Compiler >> Annotation Processing >> Enable annotation processing(开启)。

Properties >> Java Compiler >> Annotation Processing >> Factory Path >>添加jar包，就是之前放在compile-libs目录下的androidannotations-2.7.1.jar。

重新编译（Clean）下项目既可以了。

 

注意：AndroidManifest.xml文件里的Activity和Application的名字都要在原来的基础上加一个下划线（”_”）。例如

<activityandroid:name="com.example.testaa.MainActivity">

</activity>

改成

<activityandroid:name="com.example.testaa.MainActivity_"></activity>

在Activity跳转的时候也要如此new Intent().setClass(this, MainActivity_.class);

 

 

此处再附上另外一种配置方法：

项目中重要的两个jar包分别是：androidannotations-api-3.0.1.jar和androidannotations-3.0.1.jar

    2.新建一个android项目，然后将androidannotations-api-3.0.1.jar复制到libs目录下，在项目的根目录新建一个文件夹，命名为compile-libs，然后将androidannotations-3.0.1.jar复制到该目录下

    3.然后设置项目属性：右键->Properties->Java Compiler->Annotation Processing 在该页面选中Enable project specific settings。

 

    然后点击Annotation Processing的子项Factory Path页面，选中Enable project specific settings，然后添加编译所需的jar包。点击“Add JARs”将之前complie-libs目录下的androidannotations-3.0.1.jar导入，保存后退出。

    

 

一些常用Annotations注释的使用方法：
@AfterInject  定义的方法在类的构造方法执行后执行
@AfterTextChange  定义的方法在TextView及其子类的Text属性改变后执行
@AfterViews  定义的方法在setContentView后执行
@Background  定义的方法在后台线程执行，开启的线程在线程池中管理
@BeforeTextChange  定义的方法在TextView及其子类的Text属性改变前执行
@Click  定义点击监听器
@EActivity  在Activity中启用Annotations
@EProvider  在ContentProvider中启用Annotations
@EReceive  在BroadcastReceiver中启用Annotations
@Eservice  在Service中启用Annotations
@EView  在自定义的View的子类中启用Annotations
@Fullscreen  全屏

@NoTitle   无标题栏

@Extra  含义和getIntent().getExtra()相同，目的是获取上一个Activity通过Intent传递过来的值。

 

附上Github上对可用的annotations列表总结地址（点击每一个均有详细的注解）：

https://github.com/excilys/androidannotations/wiki/AvailableAnnotations

 

补充说明：

    1，onSaveInstanceState的使用
        保存activity暂时的状态（保存类成员变量关联着UI的值，例如:某个处于选中状态下RadioButton的ID）,
        便于恢复
    2,使用@EBean的JavaBean，能直接取到调用他的Context，并且支持@ViewById标签找到控件，因此，
       构造方法传过来的参数可以少很多。

 

 

再附上一段使用annotations注解类型较多的代码供参考：

1. package com.googlecode.androidannotations.helloworldeclipse;

2. 

3. import java.util.Date;

4. import java.util.concurrent.TimeUnit;

5. 

6. import android.app.Activity;

7. import android.app.Notification;

8. import android.app.NotificationManager;

9. import android.app.PendingIntent;

10. import android.content.Intent;

11. import android.database.sqlite.SQLiteDatabase;

12. import android.os.Bundle;

13. import android.util.Log;

14. import android.view.MotionEvent;

15. import android.view.View;

16. import android.view.Window;

17. import android.view.WindowManager;

18. import android.widget.EditText;

19. import android.widget.TextView;

20. import android.widget.Toast;

21. 

22. import com.googlecode.androidannotations.annotations.Background;

23. import com.googlecode.androidannotations.annotations.Click;

24. import com.googlecode.androidannotations.annotations.EActivity;

25. import com.googlecode.androidannotations.annotations.LongClick;

26. import com.googlecode.androidannotations.annotations.SystemService;

27. import com.googlecode.androidannotations.annotations.Touch;

28. import com.googlecode.androidannotations.annotations.Transactional;

29. import com.googlecode.androidannotations.annotations.UiThread;

30. import com.googlecode.androidannotations.annotations.ViewById;

31. import com.googlecode.androidannotations.annotations.res.BooleanRes;

32. import com.googlecode.androidannotations.annotations.res.ColorRes;

33. import com.googlecode.androidannotations.annotations.res.StringRes;

34. 

35. @EActivity(R.layout.my_activity) //布局文件在这里声明，不用在setContentView

36. public class MyActivity extends Activity {

37. 

38.     @ViewById //控件这样标注，由于是IOC模式，因此不需要自己实例化

39.     EditText myEditText;

40. 

41.     @ViewById(R.id.myTextView) //提供id来生成控件，如果不指定ID，默认以控件名进行查找，如上面的myEditText

42.     TextView textView;

43. 

44.     @StringRes(R.string.hello) //资源

45.     String helloFormat;

46. 

47.     @ColorRes

48.     int androidColor;

49. 

50.     @BooleanRes

51.     boolean someBoolean;

52. 

53.     @SystemService

54.     NotificationManager notificationManager;

55. 

56.     @SystemService

57.     WindowManager windowManager;

58. 

59.     /**

60.      * AndroidAnnotations gracefully handles support for onBackPressed, whether

61.      * you use ECLAIR (2.0), or pre ECLAIR android version.

62.      */

63.     public void onBackPressed() {

64.         Toast.makeText(this, "Back key pressed!", Toast.LENGTH_SHORT).show();

65.     }

66.     

67.     @Override

68.     protected void onCreate(Bundle savedInstanceState) {

69.         super.onCreate(savedInstanceState);

70.         // windowManager should not be null

71.         windowManager.getDefaultDisplay();

72.         requestWindowFeature(Window.FEATURE_INDETERMINATE_PROGRESS);

73.     }

74. 

75. 

76.     @Click //事件控制，可以以按钮的id作为方法名,同时支持的事件还有onLongClick，onTextChange等

77.     void myButtonClicked() {

78.         String name = myEditText.getText().toString();

79.         setProgressBarIndeterminateVisibility(true);

80.         someBackgroundWork(name, 5);

81.     }

82. 

83.     @Background //开启新线程后台运行，注意不要引用UI控件,而且返回值类型一定是void

84.     void someBackgroundWork(String name, long timeToDoSomeLongComputation) {

85.         try {

86.             TimeUnit.SECONDS.sleep(timeToDoSomeLongComputation);

87.         } catch (InterruptedException e) {

88.         }

89. 

90.         String message = String.format(helloFormat, name);

91. 

92.         updateUi(message, androidColor);

93. 

94.         showNotificationsDelayed();

95.     }

96. 

97.     @UiThread //UI线程

98.     void updateUi(String message, int color) {

99.         setProgressBarIndeterminateVisibility(false);

100.         textView.setText(message);

101.         textView.setTextColor(color);

102.     }

103. 

104.     @UiThread(delay=2000) //可以设置延时时间，以毫秒为单位

105.     void showNotificationsDelayed() {

106.         Notification notification = new Notification(R.drawable.icon, "Hello !", 0);

107.         PendingIntent contentIntent = PendingIntent.getActivity(this, 0, new Intent(), 0);

108.         notification.setLatestEventInfo(getApplicationContext(), "My notification", "Hello World!", contentIntent);

109.         notificationManager.notify(1, notification);

110.     }

111. 

112.     @LongClick

113.     void startExtraActivity() {

114.         Intent intent = new Intent(this, ActivityWithExtra_.class);

115. 

116.         intent.putExtra(ActivityWithExtra.MY_DATE_EXTRA, new Date());

117.         intent.putExtra(ActivityWithExtra.MY_STRING_EXTRA, "hello !");

118.         intent.putExtra(ActivityWithExtra.MY_INT_EXTRA, 42);

119. 

120.         startActivity(intent);

121.     }

122. 

123.     @Click

124.     void startListActivity(View v) {

125.         startActivity(new Intent(this, MyListActivity_.class));

126.     }

127. 

128.     @Touch

129.     void myTextView(MotionEvent event) {

130.         Log.d("MyActivity", "myTextView was touched!");

131.     }

132. 

133.     @Transactional

134.     int transactionalMethod(SQLiteDatabase db, int someParam) {

135.         return 42;

136.     }

137. 

138. }

 

丷爱因卉卉灬
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
QValueAxis详解
04-06
QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解QValueAxis详解...
Android 最火快速开发框架AndroidAnnotations简介
ltx06的专栏
08-28 801
转自：http://blog.csdn.net/rain_butterfly/article/details/38733607
AndroidAnnotations配置使用
码农飞上天
11-27 1708
AndroidAnnotations配置使用，问题解决。你值得拥有 利用AndroidAnnotations加快项目开发，让你的项目更加的简洁，更加有利于代码的可阅读性，加强团队合作使你的项目更加容易维护。
AndroidAnnotations框架详解
SmallCheric
06-03 8359
在之前的开发中,你肯定用到了xUtils及ButterKnife等依赖注入框架,你可以使用这些框架来简化你的代码,因为很多代码都是重复性的,对于老司机来说,你肯定不想浪费大量的时间在写一些重复性的东西,比如findViewById之类的代码,所以好的框架的使用对于快速开发来说是很有必要的,今天要聊得就是开源框架AndroidAnnotations
关于androidannotations（注解）的理解和使用（文档篇）
Yolanda的博客
02-29 1万+
注解
Android Annotation 最全面直白的解析
acesheep_911的博客
12-18 413
初级程序员使用别人的框架，中级程序员不仅会使用别人的框架还知道内部的实现原理，高级程序员则按需求编写自己的框架。而在Android 开发中，很多常用的第三方库都会使用到注解来实现，比如 ButterKnife、EventBus 等，通过一个标注来说明当前类/方法/变量的意义或是赋值，从而使得代码的可读性变强。 那么今天我们就来聊聊这些主流框架中不可或缺的基石（休斯敦MVP-哈基石
QListView详解
03-21
QListView详解
QTableView详解
03-21
QTableView详解
iptables 详解iptables 详解
12-02
iptables 详解
VC++深入详解
11-24
VC++深入详解，详细介绍vc++的各种功能，非常适合初学者
androidannotations 注解框架的配置及使用教程
03-21
androidannotations 注解框架的配置及使用教程，注解框架androidannotations从入门到放弃的一个小demo。
AndroidAnnotations-3.2
08-08
AndroidAnnotations包要放到app/compile-libs（要自己建立该目录）下（可以不使用），AndroidAnnotations-api该包要放到app/libs。
androidannotations-3.0.1.jar androidannotations-api-3.0.1.jar
05-27
androidannonations.jar下载
AndroidAnnotations
05-18
Android注释-教程RSS 什么是Android注释？ Android Annotations是一个开放源代码框架，其前提很简单：代码饮食。 他负责为您实施重复性工作，并让您专注于真正重要的所有工作。 另外，通过简化代码，维护变得更加容易。 在项目上可以找到一个小示例。 在本教程中可以找到另一个示例，我们将在该示例中创建一个小应用程序，该应用程序将接收Android注释辅助的RSS feed。 本教程需要什么？ 在本教程中，我们将结合使用和 。 （天哪） 在本教程中，还将假定您对Android API以及如何使用Android Studio进行编程有一定的了解。 因此，如果您还不了解这些内容，最好先进行一些研究，然后再学习本教程他必须在此期间待在这里。 （： 获取Android注释 首先，我们必须获取Android批注，为此，我们必须使用Android Studio构建系统，
Android Annotations浅析
热门推荐
快乐de胖虎
07-09 1万+
这阵子遇到了好多事情，挺久没来更新博文了，这两天在学这个开源框架Android Annotations，用起来感觉挺方便的， 相信用过Spring注解的孩子理解起来应该比较容易！就是配置起来比较吃力。 关于AndroidAnnotaions的介绍，网上已经很多了，我这里不再累赘。 1、AndroidAnnotations官网：http://androidannotations...
Android Annotations 介绍
06-13 259
开发过程中看到别人使用了Android Annotations的代码，该代码是一个第三方框架，通过注释来开发应用。使用Android Annotations能够大大减少代码量。 请看下面的Java代码 [java] view plain copy  print? package com.example.androidannotations;   
Android 注解（Annotation）的入门与使用（一）
朱大大的博客
06-03 1012
Android 注解（Annotation）的入门与使用（一）概述什么是注解（Annotation）注解（Annotation）用来做什么元注解@Target有哪些值@Retention有哪些值自定义注解获取类的属性和方法获取注解的属性或者方法实战如何使用自定义注解执行一个方法实战如何使用自定义注解执行setContentView 概述 现在很多流行的框架都用到了注解，比如Butterknife、EventBus3、Retrofit，Okhttp里面也用到了注解，减少了重复代码的编写，极大的方便我们快速开发
android 注解使用,Android进阶之Annotation(注解)的使用
weixin_34990053的博客
05-27 722
注解支持的版本Android support library从19.1版本开始就引入了一个新的注解库。添加支持注解库依赖项要在您的项目中启用注解，请向您的库或应用添加 support-annotations 依赖项。支持注解库是Android 支持库的一部分。要向您的项目添加注解，您必须下载支持存储库并向 build.gradle文件中添加 support-annotations依赖项。添加支持注...
tcpdump 详解
最新发布
02-03
以下是tcpdump的一些详解： 1. 抓包过滤：tcpdump可以根据用户指定的过滤条件来捕获特定的数据包，例如根据源IP地址、目标IP地址、端口号、协议类型等进行过滤。 2. 抓包输出：tcpdump可以将捕获到的数据包输出到...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值