Butter Knife高级用法

Butter Knife

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

1	compile  'com.jakewharton:butterknife:7.0.1'

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

下面是我很少看到被开发者使用的Butter Knife特性，这些都是非常好的特性，因此我希望你也开始能用到它们！

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

7. @Nullable annotation

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

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