Android注入框架——ButterKine

OverView

ButterKine是一款開源的Android視圖的字段和方法綁定快速注解框架茴恰,應(yīng)用十分廣泛任柜。可以避免重復(fù)使用findViewById徒河,很大程度上簡化代碼,提高開發(fā)效率送漠。

Android Studio配置

在build.gradle中添加配置顽照,文章是基于8.8.1版本進(jìn)行配置與說明的,不同版本之間使用方法稍有差異闽寡,具體情況可查看GitHub_ButterKine項(xiàng)目提交記錄與說明棒厘。

annotationProcessor 'com.jakewharton:butterknife-compiler:8.8.1'
implementation 'com.jakewharton:butterknife:8.8.1'

在Library projects中的使用方法:

To use Butter Knife in a library, add the plugin to your buildscript:

buildscript {
  repositories {
    mavenCentral()
    google()
   }
  dependencies {
    classpath 'com.jakewharton:butterknife-gradle-plugin:10.1.0'
  }
}

and then apply it in your module:

apply plugin: 'com.android.library'
apply plugin: 'com.jakewharton.butterknife'

Now make sure you use R2 instead of R inside all Butter Knife annotations.

class ExampleActivity extends Activity {
  @BindView(R2.id.user) EditText username;
  @BindView(R2.id.pass) EditText password;
...
}

注冊與綁定

在Activity中綁定

需要在onCreate中進(jìn)行綁定,每個(gè)Activity都需要進(jìn)行此操作下隧,所以建議在同一基類中實(shí)現(xiàn)奢人,其他Activity繼承此基類。

public abstract class BaseActivity extends AppCompatActivity {
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(initLayout());
        
        //在基類中綁定ButterKnife
        ButterKnife.bind(this);
        create();
    }
    /**
     * 返回Activity layout用于綁定View
     * @return Activity layout
     */
    protected abstract int initLayout();
    /**
     * Activity onCreate完成后的回調(diào)
     */
    protected abstract void create();
}

其他Activity繼承此基類:

public class MainActivity extends BaseActivity {
    
    @Override
    protected int initLayout() {
        return R.layout.activity_main;
    }

    @Override
    protected void create() {
        //TODO onCreate完成
    }
}

在Fragment中綁定

與在Activity中綁定類似淆院,不同的是需要在Fragment的onCreateView中進(jìn)行綁定而不是onCreate何乎,而且需要中onDestoryView中進(jìn)行解綁句惯,來避免內(nèi)存泄漏風(fēng)險(xiǎn)。同樣的我們一般也定義一個(gè)Fragment基類來實(shí)現(xiàn)支救,其他Fragment繼承此基類抢野。

public abstract class BaseFragment extends Fragment {
    Unbinder unbinder;

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        View view = inflater.inflate(initLayout(),null);
        //綁定ButterKnife
        unbinder = ButterKnife.bind(this, view);
        return view;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();

        //解綁
        if(unbinder != null){
            unbinder.unbind();
        }
    }
    protected abstract int initLayout();
}

在Adapter中綁定

在Adapter的ViewHolder中進(jìn)行綁定:

public class RecyclerAdapter extends RecyclerView.Adapter<RecyclerAdapter.ViewHolder> {
    private Context context;
    private List<String> data;

    ...

    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull ViewGroup viewGroup, int i) {
        View view = LayoutInflater.from(context).inflate(R.layout.item_recycler_view, viewGroup, false);
        ViewHolder viewHolder = new ViewHolder(view);
        return viewHolder;
    }

    @Override
    public void onBindViewHolder(@NonNull ViewHolder viewHolder, int i) {
        viewHolder.itemNameTv.setText(data.get(i));
    }

    @Override
    public int getItemCount() {
        return data.size();
    }

    class ViewHolder extends RecyclerView.ViewHolder{
        @BindView(R.id.item_name_tv)
        TextView itemNameTv;

        public ViewHolder(@NonNull View itemView) {
            super(itemView);

            //綁定ButterKnife
            ButterKnife.bind(this,itemView);
        }
    }
}

基本使用

綁定View

綁定單個(gè)View:

//綁定View
@BindView(R.id.bind_btn)
Button BindBtn;

綁定多個(gè)View:

//綁定多個(gè)View成List
@BindViews({R.id.array_btn_1, R.id.array_btn_2, R.id.array_btn_3})
List<Button> btnList;

需要注意的是被綁定的View聲明時(shí)一般不加類型修飾符而且不能是static類型的。

綁定事件

被注解的事件方法不能用private修飾符

@OnClick(R.id.onclick_btn)
protected void onClick() {
    //TODO to do something
}

對多個(gè)View進(jìn)行事件注解:

//給多個(gè)View綁定事件
@OnClick({R.id.array_btn_1, R.id.array_btn_2, R.id.array_btn_3})
protected void OnArrayClick(View view) {
    switch (view.getId()) {
        case R.id.array_btn_1:
            Toast.makeText(MainActivity.this, "array_btn_1 Button Clicked.", Toast.LENGTH_SHORT).show();
            break;
       case R.id.array_btn_2:
            Toast.makeText(MainActivity.this, "array_btn_2 Button Clicked.", Toast.LENGTH_SHORT).show();
            break;
       case R.id.array_btn_3:
            Toast.makeText(MainActivity.this, "array_btn_3 Button Clicked.", Toast.LENGTH_SHORT).show();
            break;
    }
}

其他注解事件
[站外圖片上傳中...(image-216bd9-1554205481300)]

綁定資源

//綁定字符串
@BindString(R.string.app_name)
String appName;
//綁定數(shù)組
@BindArray(R.array.test_array)
String[] testArray;
//綁定顏色
@BindColor(R.color.colorAccent)
int colorAccent;

其他資源注解方法:

[站外圖片上傳中...(image-fa991e-1554205481300)]

Action各墨、Setter與apply()

ButterKnife提供了Action和Setter接口指孤,來對View的行為和屬性進(jìn)行設(shè)置,具體使用方法如下:

//設(shè)置行為
ButterKnife.Action<View> action = new ButterKnife.Action<View>() {
    @Override
    public void apply(@NonNull View view, int index) {
        //為view設(shè)置行為可點(diǎn)擊
        view.setClickable(true);
    }
};
//設(shè)置屬性
ButterKnife.Setter<Button, String> setter = new ButterKnife.Setter<Button, String>() {
    @Override
    public void set(@NonNull Button view, String value, int index) {
        //為view設(shè)置統(tǒng)一屬性value
        view.setText(value);
    }
};
ButterKnife.apply(btnList, action);
ButterKnife.apply(btnList, setter, "aaaa");

ButterKnife的介紹到這就結(jié)束了贬堵,當(dāng)然了還有很多內(nèi)容文中是沒有介紹的如:Butterknife Zelezny插件等恃轩,在這就不詳細(xì)講解了,有需要的朋友自行搜索吧黎做。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末叉跛,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子蒸殿,更是在濱河造成了極大的恐慌筷厘,老刑警劉巖,帶你破解...
    沈念sama閱讀 219,270評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件宏所,死亡現(xiàn)場離奇詭異酥艳,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)爬骤,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,489評論 3 395
  • 文/潘曉璐 我一進(jìn)店門充石,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人盖腕,你說我怎么就攤上這事赫冬。” “怎么了溃列?”我有些...
    開封第一講書人閱讀 165,630評論 0 356
  • 文/不壞的土叔 我叫張陵劲厌,是天一觀的道長。 經(jīng)常有香客問我听隐,道長补鼻,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,906評論 1 295
  • 正文 為了忘掉前任雅任,我火速辦了婚禮风范,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘沪么。我一直安慰自己硼婿,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,928評論 6 392
  • 文/花漫 我一把揭開白布禽车。 她就那樣靜靜地躺著寇漫,像睡著了一般刊殉。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上州胳,一...
    開封第一講書人閱讀 51,718評論 1 305
  • 那天记焊,我揣著相機(jī)與錄音,去河邊找鬼栓撞。 笑死遍膜,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的瓤湘。 我是一名探鬼主播瓢颅,決...
    沈念sama閱讀 40,442評論 3 420
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼岭粤!你這毒婦竟也來了惜索?” 一聲冷哼從身側(cè)響起特笋,我...
    開封第一講書人閱讀 39,345評論 0 276
  • 序言:老撾萬榮一對情侶失蹤剃浇,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后猎物,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體虎囚,經(jīng)...
    沈念sama閱讀 45,802評論 1 317
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,984評論 3 337
  • 正文 我和宋清朗相戀三年蔫磨,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了淘讥。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,117評論 1 351
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡堤如,死狀恐怖蒲列,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情搀罢,我是刑警寧澤蝗岖,帶...
    沈念sama閱讀 35,810評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站榔至,受9級特大地震影響抵赢,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜唧取,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,462評論 3 331
  • 文/蒙蒙 一铅鲤、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧枫弟,春花似錦邢享、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,011評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽掸犬。三九已至,卻和暖如春绪爸,著一層夾襖步出監(jiān)牢的瞬間湾碎,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,139評論 1 272
  • 我被黑心中介騙來泰國打工奠货, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留介褥,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,377評論 3 373
  • 正文 我出身青樓递惋,卻偏偏與公主長得像柔滔,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個(gè)殘疾皇子萍虽,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,060評論 2 355

推薦閱讀更多精彩內(nèi)容