Injecting Views

原文地址：
https://github.com/excilys/androidannotations/wiki/Injecting-Views

@ViewById

在Activity中@ViewById标注的字段，必须的在activity所在的布局layout中可以找到相应的ID，类似于调用findViewById()方法。
注释的视图id可以设置参数,即@ViewById(R.id.myTextView)。如果没有设置视图id,将使用的名称字段。字段不能是私有的。
例如：

@EActivity
public class MyActivity extends Activity {

  // Injects R.id.myEditText
  @ViewById
  EditText myEditText;

  @ViewById(R.id.myTextView)
  TextView textView;
}

@AfterViews

使用@AfterViews注释的一个方法表示应该调用视图绑定了。

在调用onCreate()时,@ViewById标注的字段没有初始化。因此你可以在@AfterViews注释的方法中进行视图相关的操作。

例如：

@EActivity(R.layout.main)
public class MyActivity extends Activity {

    @ViewById
    TextView myTextView;

    @AfterViews
    void updateTextWithDate() {
        myTextView.setText("Date: " + new Date());
    }
[...]

你可以用@AfterViews标注多个方法。别忘了,你不应该在onCreate()方法中使用任何与视图有关的字段:

@EActivity(R.layout.main)
public class MyActivity extends Activity {

    @ViewById
    TextView myTextView;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 不要这样做!! 这将会抛出一个NullPointerException的异常, 因为此时myTextView 还没有被赋值为null.
        // myTextView.setText("Date: " + new Date());
    }
[...]

回顾一下注释总是很快的，因此使用任何已经被注释的字段，比如，在@AfterViews 注释的方法中 用@Extra 或 @InstanceState 这些和视图无关的标记值是安全的（和@AfterView是一样的），因此在@AfterViews注释的方法中，你可以安全的假设这些值已经根据预期设定初始化好了。

@EActivity(R.layout.main)
public class MyActivity extends Activity {

    @ViewById
    TextView myTextView;

    @InstanceState
    Integer textPosition;

    @AfterViews
    void updateTextPosition() {
        myTextView.setSelection(textPosition); //Sets the cursor position of myTextView
    }
[...] // The remaining code must keep textPosition updated.

警告

如果父类和子类有@AfterViews,@AfterInject或@AfterExtras名称相同的带注释的方法,生成的代码将会有BUG。查看更多细节问题# 591。
同时，当我们调用那些@AfterViews、@AfterInject、@AfterExtras注解的方法时会有一个调用顺序，但是如果@AfterView、@AfterInject、@AfterExtras 注解的方法是同名的，那就不能确保这几个方法的调用顺序了 ，请看( issue #810)。
关于这些注解的方法调用顺序，你可以看我的这篇博客译文：@AfterXXX 调用顺序。

@ViewsById

这个注解与@ViewById有点类似，不同的是这个注解可以注入一组视图，他可以用在java.util.List 或 android.view.View 子类型字段，注释值应该是一个一组R.id.*的值。
例如：

@EActivity
public class MyActivity extends Activity {

  @ViewsById({R.id.myTextView1, R.id.myOtherTextView})
  List<TextView> textViews;

  @AfterViews
  void updateTextWithDate() {
    for (TextView textView : textViews) {
      textView.setText("Date: " + new Date());
    }
  }
}