Android视图注入库:butterknife

介绍
ButterKnife通过@InjectView和视图的ID注解的变量去找到并自己主动转换为你布局上对应的布局视图。

class ExampleActivity extends Activity {
  @InjectView(R.id.title) TextView title;
  @InjectView(R.id.subtitle) TextView subtitle;
  @InjectView(R.id.footer) TextView footer;

  @Override public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.simple_activity);
    ButterKnife.inject(this);
    // TODO Use "injected" views...
  }
}


与缓慢的反射机制不同的是，产生的代码是用来运行视图的查表（查找视图）操作。调用Inject方法生成的代码能够查看且调试。上面样例中的代码能够粗略等同于以下：

public void inject(ExampleActivity activity) {
  activity.subtitle = (android.widget.TextView) activity.findViewById(2130968578);
  activity.footer = (android.widget.TextView) activity.findViewById(2130968579);
  activity.title = (android.widget.TextView) activity.findViewById(2130968577);
}


非activity注入
你也能够提供自己的根视图对随意对象运行注入：

public class FancyFragment extends Fragment {
  @InjectView(R.id.button1) Button button1;
  @InjectView(R.id.button2) Button button2;

  @Override View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fancy_fragment, container, false);
    ButterKnife.inject(this, view);
    // TODO Use "injected" views...
    return view;
  }
}


另外一个使用方法是。在列表适配器中简化ViewHolder模式：

public class MyAdapter extends BaseAdapter {
  @Override public View getView(int position, View view, ViewGroup parent) {
    ViewHolder holder;
    if (view != null) {
      holder = (ViewHolder) view.getTag();
    } else {
      view = inflater.inflate(R.layout.whatever, parent, false);
      holder = new ViewHolder(view);
      view.setTag(holder);
    }

    holder.name.setText("John Doe");
    // etc...

    return view;
  }

  static class ViewHolder {
    @InjectView(R.id.title) TextView name;
    @InjectView(R.id.job_title) TextView jobTitle;

    public ViewHolder(View view) {
      ButterKnife.inject(this, view);
    }
  }
}


你能够在上面样例中查看其行为的实现。你能够在随意能够使用findViewById的地方使用ButterKnife.inject。

其它提供的注入API：
    能够使用activity作为根视图对随意对象进行注入。假设你使用了类似MVC的架构，你能够通过在控制器（C）的activity使用ButterKnife.inject(this, activity)对其进行注入。
    能够使用ButterKnife.inject(this)对子视图进行注入。

假设你在布局中使用<merge>标签并且加载了自己定义控件，能够在后面马上调用它。或者通过xml加载的自己定义视图，能够在onFinishInflate()回调中使用它。

视图列
你能够把多个视图集中到列表或者数组中。

@InjectViews({ R.id.first_name, R.id.middle_name, R.id.last_name })
List<EditText> nameViews;


apply方法能够一次性运行列表中全部视图的行为：

ButterKnife.apply(nameViews, DISABLE);
ButterKnife.apply(nameViews, ENABLED, false);
Action和Setter接口同意定义简单的行为：

static final Action<View> DISABLE = new Action<>() {
  @Override public void apply(View view, int index) {
    view.setEnabled(false);
  }
}
static final Setter<View, Boolean> ENABLED = new Setter<>() {
  @Override public void set(View view, Boolean value, int index) {
    view.setEnabled(value);
  }
}

Android的自带属性也能够用apply方法。

ButterKnife.apply(nameViews, View.ALPHA, 0);

点击监听注入
点击监听也能够自己主动设置到方法。

@OnClick(R.id.submit)
public void submit() {
  // TODO submit data to server...
}


你能够把视图当做參数传入方法。

声明一个指定类型

@OnClick(R.id.submit)
public void sayHi(Button button) {
  button.setText("Hello!");
}


在一个绑定中为同样的事件操作声明多个ID。

@OnClick({ R.id.door1, R.id.door2, R.id.door3 })
public void pickDoor(DoorView door) {
  if (door.hasPrizeBehind()) {
    Toast.makeText(this, "You win!", LENGTH_SHORT).show();
  } else {
    Toast.makeText(this, "Try again", LENGTH_SHORT).show();
  }
}


注入重置
fragment比起activity有更加不同的声明周期。当在fragment的onCreateView里注入时，应该在onDestroyView里设置视图为空。ButterKnife有一个重置方法能够自己主动做这个操作。

public class FancyFragment extends Fragment {
  @InjectView(R.id.button1) Button button1;
  @InjectView(R.id.button2) Button button2;

  @Override View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fancy_fragment, container, false);
    ButterKnife.inject(this, view);
    // TODO Use "injected" views...
    return view;
  }

  @Override void onDestroyView() {
    super.onDestroyView();
    ButterKnife.reset(this);
  }
}


可选注入
默认情况下，@InjectView和@OnClick是必须的（此处的必须应该是相应后面一句话而言的）。

假设目标视图未找到会抛异常。为了禁止这样的行为的出现并创建一个可选的注入，加入@Optional注解到值或方法上。

@Optional @InjectView(R.id.might_not_be_there) TextView mightNotBeThere;

@Optional @OnClick(R.id.maybe_missing) void onMaybeMissingClicked() {
  // TODO ...
}


多回调监听
有多个回调的相应监听的注解能够被用来绑定它们中的随意一个。每一个注解都有其相应的默认回调。指定随意一个使用callback參数。


@OnItemSelected(R.id.list_view)
void onItemSelected(int position) {
  // TODO ...
}

@OnItemSelected(value = R.id.maybe_missing, callback = NOTHING_SELECTED)
void onNothingSelected() {
  // TODO ...
}


额外奖励
包括的两个简化代码的findById方法仍须要在view或activity查找视图。它使用generics判断返回类型并自己主动运行转换。

View view = LayoutInflater.from(context).inflate(R.layout.thing, null);
TextView firstName = ButterKnife.findById(view, R.id.first_name);
TextView lastName = ButterKnife.findById(view, R.id.last_name);
ImageView photo = ButterKnife.findById(view, R.id.photo);


给ButterKnife.findById加入静态引入会更加有趣。介绍
ButterKnife通过@InjectView和视图的ID注解的变量去找到并自己主动转换为你布局上对应的布局视图。

class ExampleActivity extends Activity {
  @InjectView(R.id.title) TextView title;
  @InjectView(R.id.subtitle) TextView subtitle;
  @InjectView(R.id.footer) TextView footer;

  @Override public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.simple_activity);
    ButterKnife.inject(this);
    // TODO Use "injected" views...
  }
}


与缓慢的反射机制不同的是。产生的代码是用来运行视图的查表（查找视图）操作。调用Inject方法生成的代码能够查看且调试。

上面样例中的代码能够粗略等同于以下：

public void inject(ExampleActivity activity) {
  activity.subtitle = (android.widget.TextView) activity.findViewById(2130968578);
  activity.footer = (android.widget.TextView) activity.findViewById(2130968579);
  activity.title = (android.widget.TextView) activity.findViewById(2130968577);
}


非activity注入
你也能够提供自己的根视图对随意对象运行注入：

public class FancyFragment extends Fragment {
  @InjectView(R.id.button1) Button button1;
  @InjectView(R.id.button2) Button button2;

  @Override View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fancy_fragment, container, false);
    ButterKnife.inject(this, view);
    // TODO Use "injected" views...
    return view;
  }
}


另外一个使用方法是，在列表适配器中简化ViewHolder模式：

public class MyAdapter extends BaseAdapter {
  @Override public View getView(int position, View view, ViewGroup parent) {
    ViewHolder holder;
    if (view != null) {
      holder = (ViewHolder) view.getTag();
    } else {
      view = inflater.inflate(R.layout.whatever, parent, false);
      holder = new ViewHolder(view);
      view.setTag(holder);
    }

    holder.name.setText("John Doe");
    // etc...

    return view;
  }

  static class ViewHolder {
    @InjectView(R.id.title) TextView name;
    @InjectView(R.id.job_title) TextView jobTitle;

    public ViewHolder(View view) {
      ButterKnife.inject(this, view);
    }
  }
}


你能够在上面样例中查看其行为的实现。你能够在随意能够使用findViewById的地方使用ButterKnife.inject。
其它提供的注入API：
    能够使用activity作为根视图对随意对象进行注入。假设你使用了类似MVC的架构。你能够通过在控制器（C）的activity使用ButterKnife.inject(this, activity)对其进行注入。

    能够使用ButterKnife.inject(this)对子视图进行注入。

假设你在布局中使用<merge>标签并且加载了自己定义控件，能够在后面马上调用它。

或者通过xml加载的自己定义视图。能够在onFinishInflate()回调中使用它。

视图列
你能够把多个视图集中到列表或者数组中。

@InjectViews({ R.id.first_name, R.id.middle_name, R.id.last_name })
List<EditText> nameViews;


apply方法能够一次性运行列表中全部视图的行为：

ButterKnife.apply(nameViews, DISABLE);
ButterKnife.apply(nameViews, ENABLED, false);
Action和Setter接口同意定义简单的行为：

static final Action<View> DISABLE = new Action<>() {
  @Override public void apply(View view, int index) {
    view.setEnabled(false);
  }
}
static final Setter<View, Boolean> ENABLED = new Setter<>() {
  @Override public void set(View view, Boolean value, int index) {
    view.setEnabled(value);
  }
}

Android的自带属性也能够用apply方法。

ButterKnife.apply(nameViews, View.ALPHA, 0);

点击监听注入
点击监听也能够自己主动设置到方法。

@OnClick(R.id.submit)
public void submit() {
  // TODO submit data to server...
}


你能够把视图当做參数传入方法。声明一个指定类型

@OnClick(R.id.submit)
public void sayHi(Button button) {
  button.setText("Hello!");
}


在一个绑定中为同样的事件操作声明多个ID。

@OnClick({ R.id.door1, R.id.door2, R.id.door3 })
public void pickDoor(DoorView door) {
  if (door.hasPrizeBehind()) {
    Toast.makeText(this, "You win!", LENGTH_SHORT).show();
  } else {
    Toast.makeText(this, "Try again", LENGTH_SHORT).show();
  }
}


注入重置
fragment比起activity有更加不同的声明周期。当在fragment的onCreateView里注入时。应该在onDestroyView里设置视图为空。

ButterKnife有一个重置方法能够自己主动做这个操作。

public class FancyFragment extends Fragment {
  @InjectView(R.id.button1) Button button1;
  @InjectView(R.id.button2) Button button2;

  @Override View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fancy_fragment, container, false);
    ButterKnife.inject(this, view);
    // TODO Use "injected" views...
    return view;
  }

  @Override void onDestroyView() {
    super.onDestroyView();
    ButterKnife.reset(this);
  }
}


可选注入
默认情况下，@InjectView和@OnClick是必须的（此处的必须应该是相应后面一句话而言的）。假设目标视图未找到会抛异常。为了禁止这样的行为的出现并创建一个可选的注入，加入@Optional注解到值或方法上。

@Optional @InjectView(R.id.might_not_be_there) TextView mightNotBeThere;

@Optional @OnClick(R.id.maybe_missing) void onMaybeMissingClicked() {
  // TODO ...
}


多回调监听
有多个回调的相应监听的注解能够被用来绑定它们中的随意一个。

每一个注解都有其相应的默认回调。指定随意一个使用callback參数。

@OnItemSelected(R.id.list_view)
void onItemSelected(int position) {
  // TODO ...
}

@OnItemSelected(value = R.id.maybe_missing, callback = NOTHING_SELECTED)
void onNothingSelected() {
  // TODO ...
}


额外奖励
包括的两个简化代码的findById方法仍须要在view或activity查找视图。

它使用generics判断返回类型并自己主动运行转换。

View view = LayoutInflater.from(context).inflate(R.layout.thing, null);
TextView firstName = ButterKnife.findById(view, R.id.first_name);
TextView lastName = ButterKnife.findById(view, R.id.last_name);
ImageView photo = ButterKnife.findById(view, R.id.photo);


给ButterKnife.findById加入静态引入会更加有趣。