Android开源框架：AndroidAnnotations

AndroidAnnotations首页

github上的项目地址AndroidAnnotations Github。

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

1、使用依赖注入（Dependency Injection）不熟悉的可以了解一下Inversion of Control（IoC）

2、简化的线程模型（Simplified  threading model)

3、事件绑定（Event binding）

4、REST Client

5、No Magic  [它的意思是：AndroidAnnotations在编译的时候会产生一个子类(接下来你会明白)，你查看这个子类，可以看到它是如何工作的]

项目中重要的两个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。

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

运用方式之布局文件xml:

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="vertical"
     android:layout_width="fill_parent"
     android:layout_height="fill_parent"
     >
     <EditText
         android:id="@+id/myInput"
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
         />
     <Button
         android:id="@+id/myButton"
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
         android:text="Click me!"
         />
     <TextView
         android:id="@+id/myTextView"
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
         />
 </LinearLayout>

对应Activity的java文件：

 package com.example.testaa;

 import org.androidannotations.annotations.AfterViews;
 import org.androidannotations.annotations.Click;
 import org.androidannotations.annotations.EActivity;
 import org.androidannotations.annotations.UiThread;
 import org.androidannotations.annotations.ViewById;

 import android.app.Activity;
 import android.content.Intent;
 import android.widget.Button;
 import android.widget.EditText;
 import android.widget.TextView;
 import android.widget.Toast;
 @EActivity(R.layout.activity_main)
 public class MainActivity extends Activity {
     @ViewById(R.id.myInput)
     EditText myEditText;

     @ViewById
     Button myButton;

     @ViewById
     TextView myTextView;
     /**
      * 加载完View之后进行的处理
      */
     @AfterViews
     void afterViewProcess(){
         myButton.setText("Next");
         myTextView.setText("第一个Activity页面");
     }

     /**
      * 绑定点击事件
      */
     @Click(R.id.myButton)
     void processClick(){
         Intent intent=new Intent(this,SubActivity_.class);
         intent.putExtra("input_value", myEditText.getEditableText().toString());
         startActivity(intent);
     }

     /**
      * 利用UI线程显示一个Toast
      * @param content
      */
     @UiThread
     void showToast(String content){
         Toast.makeText(getApplicationContext(), content, Toast.LENGTH_SHORT).show();
     }
     /**
      * 延时显示
      * @param content
      */
     @UiThread(delay=1000)
     void showToastDelay(String content){
         Toast.makeText(getApplicationContext(), content, Toast.LENGTH_SHORT).show();
     }
 }

可以看出，我们通过注解的方式，大大简化了原有的代码。

注解1：@ViewById 与findViewById功能相似，如果ViewById后没有设置资源ID的话，就是自动查找与变量名称相同的id资源（条件是控件变量名称要与xml中定义的id必须一致）。

但是这样会有一个问题，如果在Click()方法中调用，运行时就会报出：NullPointerException的错误，我们就不能在Click()方法中直接使用，而是要在@AfterView注释的方法中使用

注解2：@Click 点击事件处理的注解。

对于@Click，方法名和xml文件中的id一样就可以这样写，AndroidAnnotations会自动识别，对于多个Button，可以写多个@Click，也可以在这样：

@Click({R.id.button1,R.id.button2,R.id.button3})
void buttonClicked(Button bt){
    //TODO ...
}

注解3：@UiThread 后台Ui线程的注解，省去了Handler等等。

注解4：@EActivity 提示Activity的注解，注意，该注解将Activity编译成Activity_，注意，多一个下划线“_”，因此在AndroidManifest.xml文件中需要将其添加下滑线

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

注解5：@AfterViews 是指View类注入完毕之后执行的代码。

我们第二个页面的布局文件与第一个相同，我们主要看一下它的java文件：

package com.example.testaa;

import org.androidannotations.annotations.AfterViews;
import org.androidannotations.annotations.Click;
import org.androidannotations.annotations.EActivity;
import org.androidannotations.annotations.Extra;
import org.androidannotations.annotations.UiThread;
import org.androidannotations.annotations.ViewById;

import android.app.Activity;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;

@EActivity(R.layout.activity_sub)
public class SubActivity extends Activity{
    @ViewById(R.id.myInput)
    EditText myEditText;

    @ViewById
    Button myButton;

    @ViewById
    TextView myTextView;

    @Extra(value="input_value")
    String inputString;

    @AfterViews
    void afterViewProcess(){
        myTextView.setText(inputString);
    }

    @Click(R.id.myButton)
    void processClick(){
        showToast("Clicked me !");
    }

    @UiThread
    void showToast(String content){
        Toast.makeText(getApplicationContext(), content, Toast.LENGTH_SHORT).show();
    }
}

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

AndroidManifest.xml文件：

 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     package="com.example.testaa"
     android:versionCode="1"
     android:versionName="1.0" >

     <uses-sdk
         android:minSdkVersion="8"
         android:targetSdkVersion="17" />

     <application
         android:allowBackup="true"
         android:icon="@drawable/ic_launcher"
         android:label="@string/app_name"
         android:theme="@style/AppTheme" >
         <activity
             android:name="com.example.testaa.MainActivity_"
             android:label="@string/app_name" >
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />

                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
         <activity
             android:name="com.example.testaa.SubActivity_"></activity>
     </application>

 </manifest>

注意:Activity的声明，多添加了下划线“_”