Butter Knife高级用法

英文原文：http://engineering.letsnurture.com/android-get-butter-knife/

欢迎来到LetsNurture的技术博客！

许多开发者都使用Butter Knife的@Bind来绑定view或者@OnClick来定义click listeners，但是本文将分享Butter Knife 提供的更多功能。

Butter Knife

Butter Knife是Jake Wharton创建的一个流行的开源注入库。简单的来说，Butter knife 让你用注解的方式替代findviewbyid和setOnClickListener，这样你就能回到真正有用的代码上去。

compile 'com.jakewharton:butterknife:7.0.1'

Butter Knife 使用的是编译时注解，因此不会在运行时产生任何负担。实际上它是提前生成了需要的代码，而不是使用反射或者在运行时生成代码。所以它不会导致任何性能问题，也不会减慢你的应用。

日常用法

绑定view与实现特定view的onclicklistener

就如我说的，我发现绝大多数开发者都使用Butter Knife library的@Bind 和 @OnClick 注解。

class LetsNurtureDemoActivity extends Activity {
   
  @Bind(R.id.edUserName) EditText edUserName;
  @Bind(R.id.edPassword) EditText edPassword;
  @Bind(R.id.instructions) TextView txtInstructions;
 
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.demo_activity);
    ButterKnife.bind(this);
  }
 
  @OnClick(R.id.btnLogin)
  public void btnLoginClick(View view) { 
    .....
    .....
    .....
   }
}

1. 常用listener的多个view设置方法

@OnClick({ R.id.button1, R.id.button2, R.id.button2 })
public void buttonClicks(View view) {
 
        switch(view.getId()) {
            case R.id.button1:
        Toast.makeText(this, "Button1 clicked!", LENGTH_SHORT).show();
                break;
             
        case R.id.button1:
        Toast.makeText(this, "Button2 Clicked!", LENGTH_SHORT).show();                
        break;
 
            case R.id.button1:
        Toast.makeText(this, "Button3 clicked!", LENGTH_SHORT).show();
                break;
             
        }
}

2. 更多的listener

@OnLongClick(R.id.hello) boolean sayGetOffMe() {
    Toast.makeText(this, "Let go of me!", LENGTH_SHORT).show();
    return true;
  }
 
  @OnItemClick(R.id.list_of_things) void onItemClick(int position) {
    Toast.makeText(this, "You clicked: " + adapter.getItem(position), LENGTH_SHORT).show();
  }
 
    @OnItemSelected({R.id.spinnerCountry}) 
    void onItemSelected(Spinner spinner, int position) { 
        
    } 
  
    @OnItemSelected(value=R.id.spinnerCountry, callback = OnItemSelected.Callback.NOTHING_SELECTED) 
    void onNothingSelected() { 
  
    }

同样的，你还可以为view添加如下listener：

@OnLongClick
@OnPageChange
OnPageChange.Callback
@OnTextChanged
OnTextChanged.Callback
@OnTouch
@OnItemLongClick
@OnCheckedChanged

3.绑定资源

这也是Butter knife提供的优秀功能之一。和使用 @Bind 注解替代findViewById一样，它可以用来绑定colors, dimens, string, drawable等资源。

class ExampleActivity extends Activity {
 @BindColor(R.color.red) int red; 
  @BindString(R.string.activity_title) String activityTitle;
   @BindDimen(R.dimen.btn_horizontal_margin_common) Float btnHorizontalMarginCommon;
  @BindDrawable(R.drawable.ic_instructions) Drawable iconInstructions;
}

4. 把多个view组织到一个List或者Array中

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

apply方法允许你一次性在list中的所有view上act

ButterKnife.apply(nameViews, DISABLE);
ButterKnife.apply(nameViews, ENABLED, false);

Action 和 Setter 接口可以指定简单的behavior。

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

5. 设置View的属性

Android属性也可以和apply方法一起使用。

ButterKnife.apply(nameViews, View.ALPHA, 0.0f);

6. ButterKnife.findById to find views particularly

Butter knife仍然包含了findById方法，用于仍需从一个view ，Activity，或者Dialog上 find view的时候。并且它可以自动转换类型。

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);

可以import 一个 ButterKnife.findById自己玩玩。

7. @Nullable annotation

如果目标view不能找到，它将抛出异常，暗示那个field在布局中可能不存在。

@Nullable  @Bind(R.id.edUserName) 
EditText edUserName;

Until I write next post

本文就到这里，希望你能学习更多的 Butter knife用法。