Android DataBinding 從入門到進階

時間  2019-11-06
標籤 android databinding 入門 進階 欄目 Android 简体版
原文   原文鏈接

DataBinding 是谷歌官方發佈的一個框架，顧名思義即爲數據綁定，是 MVVM 模式在 Android 上的一種實現，用於下降佈局和邏輯的耦合性，使代碼邏輯更加清晰。MVVM 相對於 MVP，其實就是將 Presenter 層替換成了 ViewModel 層。DataBinding 可以省去咱們一直以來的 findViewById() 步驟，大量減小 Activity 內的代碼，數據可以單向或雙向綁定到 layout 文件中，有助於防止內存泄漏，並且能自動進行空檢測以免空指針異常php

啓用 DataBinding 的方法是在對應 Model 的 build.gradle 文件里加入如下代碼，同步後就能引入對 DataBinding 的支持java

android {
    dataBinding {
        enabled = true
    }
}
複製代碼

1、基礎入門

啓用 DataBinding 後，這裏先來看下如何在佈局文件中綁定指定的變量android

打開佈局文件，選中根佈局的 ViewGroup，按住 Alt + 回車鍵，點擊 「Convert to data binding layout」，就能夠生成 DataBinding 須要的佈局規則git

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools">

    <data>

    </data>

    <android.support.constraint.ConstraintLayout android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".MainActivity">
    </android.support.constraint.ConstraintLayout>
</layout>
複製代碼

和原始佈局的區別在於多出了一個 layout 標籤將原佈局包裹了起來，data 標籤用於聲明要用到的變量以及變量類型，要實現 MVVM 的 ViewModel 就須要把數據（Model）與 UI（View）進行綁定，data 標籤的做用就像一個橋樑搭建了 View 和 Model 之間的通道github

這裏先來聲明一個 Modle數組

package com.leavesc.databinding_demo.model;

/** * 做者：葉應是葉 * 時間：2018/5/16 20:20 * 描述：https://github.com/leavesC */
public class User {

    private String name;

    private String password;
	
    ···
}
複製代碼

在 data 標籤裏聲明要使用到的變量名、類的全路徑app

<data>
        <variable
            name="userInfo"
            type="com.leavesc.databinding_demo.model.User" />
    </data>
複製代碼

若是 User 類型要多處用到，也能夠直接將之 import 進來，這樣就不用每次都指明整個包名路徑了，而 java.lang.* 包中的類會被自動導入，因此能夠直接使用框架

<data>
        <import type="com.leavesc.databinding_demo.model.User"/>
        <variable
            name="userInfo"
            type="User"/>
    </data>
複製代碼

若是存在 import 的類名相同的狀況，可使用 alias 指定別名dom

<data>
        <import type="com.leavesc.databinding_demo.model.User" />
        <import alias="TempUser" type="com.leavesc.databinding_demo.model2.User" />
        <variable name="userInfo" type="User" />
        <variable name="tempUserInfo" type="TempUser" />
    </data>
複製代碼

這裏聲明瞭一個 User 類型的變量 userInfo，咱們要作的就是使這個變量與兩個 TextView 控件掛鉤，經過設置 userInfo 的變量值同時使 TextView 顯示相應的文本 完整的佈局代碼以下所示ide

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">

    <data>
        <import type="com.leavesc.databinding_demo.model.User" />
        <variable name="userInfo" type="User" />
    </data>

    <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:layout_margin="20dp" android:orientation="vertical" tools:context="com.leavesc.databinding_demo.Main2Activity">

        <TextView android:id="@+id/tv_userName" ··· android:text="@{userInfo.name}" />

        <TextView ··· android:text="@{userInfo.password}" />

    </LinearLayout>

</layout>
複製代碼

經過 @{userInfo.name} 使 TextView 引用到相關的變量，DataBinding 會將之映射到相應的 getter 方法 以後能夠在 Activity 中經過 DataBindingUtil 設置佈局文件，省略原先 Activity 的 setContentView() 方法，併爲變量 userInfo 賦值

private User user;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ActivityMain2Binding activityMain2Binding = DataBindingUtil.setContentView(this, R.layout.activity_main2);
        user = new User("leavesC", "123456");
        activityMain2Binding.setUserInfo(user);
    }
複製代碼

因爲 @{userInfo.name}在佈局文件中並無明確的值，因此在預覽視圖中什麼都不會顯示，不便於觀察文本的大小和字體顏色等屬性，此時能夠爲之設定默認值（文本內容或者是字體大小等屬性都適用），默認值將只在預覽視圖中顯示，且默認值不能包含引號

android:text="@{userInfo.name,default=defaultValue}"
複製代碼

此外，也能夠經過 ActivityMain2Binding 直接獲取到指定 ID 的控件

activityMain2Binding.tvUserName.setText("leavesC");
複製代碼

每一個數據綁定佈局文件都會生成一個綁定類，ViewDataBinding 的實例名是根據佈局文件名來生成，將之改成首字母大寫的駝峯命名法來命名，並省略佈局文件名包含的下劃線。控件的獲取方式相似，但首字母小寫

也能夠經過以下方式自定義 ViewDataBinding 的實例名

<data class="CustomBinding">

    </data>
複製代碼

此外，在綁定表達式中會根據須要生成一個名爲context的特殊變量，context的值是根 View 的getContext()方法返回的Context對象， context變量會被具備該名稱的顯式變量聲明所覆蓋

Databinding 一樣是支持在 Fragment 和 RecyclerView 中使用 。例如，能夠看 Databinding 在 Fragment 中的使用

@Override
    public View onCreateView(@NonNull LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        FragmentBlankBinding fragmentBlankBinding = DataBindingUtil.inflate(inflater, R.layout.fragment_blank, container, false);
        fragmentBlankBinding.setHint("Hello");
        return fragmentBlankBinding.getRoot();
    }
複製代碼

**以上實現數據綁定的方式，每當綁定的變量發生變化的時候，都須要從新向 ViewDataBinding 傳遞新的變量值才能刷新 UI 。接下來看如何實現自動刷新 UI **

2、單向數據綁定

實現數據變化自動驅動 UI 刷新的方式有三種：BaseObservable、ObservableField、ObservableCollection

BaseObservable

一個純淨的 ViewModel 類被更新後，並不會讓 UI 自動更新。而數據綁定後，咱們天然會但願數據變動後 UI 會即時刷新，Observable 就是爲此而生的概念

BaseObservable 提供了 notifyChange() 和 notifyPropertyChanged() 兩個方法，前者會刷新全部的值域，後者則只更新對應 BR 的 flag，該 BR 的生成經過註釋 @Bindable 生成，能夠經過 BR notify 特定屬性關聯的視圖

/** * 做者：葉應是葉 * 時間：2018/5/16 20:54 * 描述： */
public class Goods extends BaseObservable {

    //若是是 public 修飾符，則能夠直接在成員變量上方加上 @Bindable 註解
    @Bindable
    public String name;

    //若是是 private 修飾符，則在成員變量的 get 方法上添加 @Bindable 註解
    private String details;

    private float price;

    public Goods(String name, String details, float price) {
        this.name = name;
        this.details = details;
        this.price = price;
    }

    public void setName(String name) {
        this.name = name;
        //只更新本字段
        notifyPropertyChanged(com.leavesc.databinding_demo.BR.name);
    }

    @Bindable
    public String getDetails() {
        return details;
    }

    public void setDetails(String details) {
        this.details = details;
        //更新全部字段
        notifyChange();
    }

    public float getPrice() {
        return price;
    }

    public void setPrice(float price) {
        this.price = price;
    }

}
複製代碼

在 setName() 方法中更新的只是本字段，而 setDetails() 方法中更新的是全部字段

添加兩個按鈕用於改變 goods 變量的三個屬性值，由此能夠看出兩個 notify 方法的區別。當中涉及的按鈕點擊事件綁定，在下面也會講到

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">

    <data>
        <import type="com.leavesc.databinding_demo.model.Goods" />
        <import type="com.leavesc.databinding_demo.Main3Activity.GoodsHandler" />
        <variable name="goods" type="Goods" />
        <variable name="goodsHandler" type="GoodsHandler" />
    </data>

    <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" android:padding="20dp" tools:context=".Main3Activity">

        <TextView ··· android:text="@{goods.name}" />

        <TextView ··· android:text="@{goods.details}" />

        <TextView ··· android:text="@{String.valueOf(goods.price)}" />

        <Button ··· android:onClick="@{()->goodsHandler.changeGoodsName()}" android:text="改變屬性 name 和 price" android:textAllCaps="false" />

        <Button ··· android:onClick="@{()->goodsHandler.changeGoodsDetails()}" android:text="改變屬性 details 和 price" android:textAllCaps="false" />

    </LinearLayout>
</layout>
複製代碼
/** * 做者：葉應是葉 * 時間：2018/5/16 21:07 * 描述： */
public class Main3Activity extends AppCompatActivity {

    private Goods goods;

    private ActivityMain3Binding activityMain3Binding;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main3);
        activityMain3Binding = DataBindingUtil.setContentView(this, R.layout.activity_main3);
        goods = new Goods("code", "hi", 24);
        activityMain3Binding.setGoods(goods);
        activityMain3Binding.setGoodsHandler(new GoodsHandler());
    }

    public class GoodsHandler {

        public void changeGoodsName() {
            goods.setName("code" + new Random().nextInt(100));
            goods.setPrice(new Random().nextInt(100));
        }

        public void changeGoodsDetails() {
            goods.setDetails("hi" + new Random().nextInt(100));
            goods.setPrice(new Random().nextInt(100));
        }

    }

}
複製代碼

能夠看到，name 視圖的刷新沒有同時刷新 price 視圖，而 details 視圖刷新的同時也刷新了 price 視圖

實現了 Observable 接口的類容許註冊一個監聽器，當可觀察對象的屬性更改時就會通知這個監聽器，此時就須要用到 OnPropertyChangedCallback

當中 propertyId 就用於標識特定的字段

goods.addOnPropertyChangedCallback(new Observable.OnPropertyChangedCallback() {
            @Override
            public void onPropertyChanged(Observable sender, int propertyId) {
                if (propertyId == com.leavesc.databinding_demo.BR.name) {
                    Log.e(TAG, "BR.name");
                } else if (propertyId == com.leavesc.databinding_demo.BR.details) {
                    Log.e(TAG, "BR.details");
                } else if (propertyId == com.leavesc.databinding_demo.BR._all) {
                    Log.e(TAG, "BR._all");
                } else {
                    Log.e(TAG, "未知");
                }
            }
        });
複製代碼

ObservableField

繼承於 Observable 類相對來講限制有點高，且也須要進行 notify 操做，所以爲了簡單起見能夠選擇使用 ObservableField。ObservableField 能夠理解爲官方對 BaseObservable 中字段的註解和刷新等操做的封裝，官方原生提供了對基本數據類型的封裝，例如 ObservableBoolean、ObservableByte、ObservableChar、ObservableShort、ObservableInt、ObservableLong、ObservableFloat、ObservableDouble 以及 ObservableParcelable ，也可經過 ObservableField 泛型來申明其餘類型

/** * 做者：葉應是葉 * 時間：2018/5/13 21:33 * 描述： */
public class ObservableGoods {

    private ObservableField<String> name;

    private ObservableFloat price;

    private ObservableField<String> details;

    public ObservableGoods(String name, float price, String details) {
        this.name = new ObservableField<>(name);
        this.price = new ObservableFloat(price);
        this.details = new ObservableField<>(details);
    }

    ```
}
複製代碼

對 ObservableGoods 屬性值的改變都會當即觸發 UI 刷新，概念上與 Observable 區別不大，具體效果可看下面提供的源代碼，這裏再也不贅述

ObservableCollection

dataBinding 也提供了包裝類用於替代原生的 List 和 Map，分別是 ObservableList 和 ObservableMap,當其包含的數據發生變化時，綁定的視圖也會隨之進行刷新

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">

    <data>
        <import type="android.databinding.ObservableList"/>
        <import type="android.databinding.ObservableMap"/>
        <variable name="list" type="ObservableList&lt;String&gt;"/>
        <variable name="map" type="ObservableMap&lt;String,String&gt;"/>
        <variable name="index" type="int"/>
        <variable name="key" type="String"/>
    </data>

    <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" tools:context="com.leavesc.databinding_demo.Main12Activity">

        <TextView ··· android:padding="20dp" android:text="@{list[index],default=xx}"/>

        <TextView ··· android:layout_marginTop="20dp" android:padding="20dp" android:text="@{map[key],default=yy}"/>

        <Button ··· android:onClick="onClick" android:text="改變數據"/>

    </LinearLayout>
</layout>
複製代碼
private ObservableMap<String, String> map;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ActivityMain12Binding activityMain12Binding = DataBindingUtil.setContentView(this, R.layout.activity_main12);
        map = new ObservableArrayMap<>();
        map.put("name", "leavesC");
        map.put("age", "24");
        activityMain12Binding.setMap(map);
        ObservableList<String> list = new ObservableArrayList<>();
        list.add("Ye");
        list.add("leavesC");
        activityMain12Binding.setList(list);
        activityMain12Binding.setIndex(0);
        activityMain12Binding.setKey("name");
    }

    public void onClick(View view) {
        map.put("name", "leavesC,hi" + new Random().nextInt(100));
    }
複製代碼

3、雙向數據綁定

雙向綁定的意思即爲當數據改變時同時使視圖刷新，而視圖改變時也能夠同時改變數據

看如下例子，當 EditText 的輸入內容改變時，會同時同步到變量 goods,綁定變量的方式比單向綁定多了一個等號：android:text="@={goods.name}"

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">

    <data>
        <import type="com.leavesc.databinding_demo.model.ObservableGoods"/>
        <variable name="goods" type="ObservableGoods" />
    </data>

    <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" tools:context=".Main10Activity">

        <TextView ··· android:text="@{goods.name}" />

        <EditText ··· android:text="@={goods.name}" />

    </LinearLayout>
</layout>
複製代碼
public class Main10Activity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ActivityMain10Binding activityMain10Binding = DataBindingUtil.setContentView(this, R.layout.activity_main10);
        ObservableGoods goods = new ObservableGoods("code", "hi", 23);
        activityMain10Binding.setGoods(goods);
    }

}
複製代碼

4、事件綁定

嚴格意義上來講，事件綁定也是一種變量綁定，只不過設置的變量是回調接口而已 事件綁定可用於如下多種回調事件

  • android:onClick
  • android:onLongClick
  • android:afterTextChanged
  • android:onTextChanged
  • ...

在 Activity 內部新建一個 UserPresenter 類來聲明 onClick() 和 afterTextChanged() 事件相應的回調方法

public class UserPresenter {

        public void onUserNameClick(User user) {
            Toast.makeText(Main5Activity.this, "用戶名：" + user.getName(), Toast.LENGTH_SHORT).show();
        }

        public void afterTextChanged(Editable s) {
            user.setName(s.toString());
            activityMain5Binding.setUserInfo(user);
        }

        public void afterUserPasswordChanged(Editable s) {
            user.setPassword(s.toString());
            activityMain5Binding.setUserInfo(user);
        }

}
複製代碼
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">

    <data>
        <import type="com.leavesc.databinding_demo.model.User" />
        <import type="com.leavesc.databinding_demo.MainActivity.UserPresenter" />
        <variable name="userInfo" type="User" />
        <variable name="userPresenter" type="UserPresenter" />
    </data>

    <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:layout_margin="20dp" android:orientation="vertical" tools:context="com.leavesc.databinding_demo.MainActivity">

        <TextView ··· android:onClick="@{()->userPresenter.onUserNameClick(userInfo)}" android:text="@{userInfo.name}" />

        <TextView ··· android:text="@{userInfo.password}" />

        <EditText ··· android:afterTextChanged="@{userPresenter.afterTextChanged}" android:hint="用戶名" />

        <EditText ··· android:afterTextChanged="@{userPresenter.afterUserPasswordChanged}" android:hint="密碼" />

    </LinearLayout>

</layout>
複製代碼

方法引用的方式與調用函數的方式相似，既能夠選擇保持事件回調方法的簽名一致：@{userPresenter.afterTextChanged}，此時方法名能夠不同，但方法參數和返回值必須和原始的回調函數保持一致。也能夠引用不遵循默認簽名的函數：@{()->userPresenter.onUserNameClick(userInfo)}，這裏用到了 Lambda 表達式，這樣就能夠不遵循默認的方法簽名，將userInfo對象直接傳回點擊方法中。此外，也可使用方法引用 :: 的形式來進行事件綁定

5、使用類方法

首先定義一個靜態方法

public class StringUtils {

    public static String toUpperCase(String str) {
        return str.toUpperCase();
    }

}
複製代碼

在 data 標籤中導入該工具類

<import type="com.leavesc.databinding_demo.StringUtils" />
複製代碼

而後就能夠像對待通常的函數同樣來調用了

<TextView android:layout_width="match_parent" android:layout_height="wrap_content" android:onClick="@{()->userPresenter.onUserNameClick(userInfo)}" android:text="@{StringUtils.toUpperCase(userInfo.name)}" />
複製代碼

6、運算符

基礎運算符

DataBinding 支持在佈局文件中使用如下運算符、表達式和關鍵字

  • 算術 + - / * %
  • 字符串合併 +
  • 邏輯 && ||
  • 二元 & | ^
  • 一元 + - ! ~
  • 移位 >> >>> <<
  • 比較 == > < >= <=
  • Instanceof
  • Grouping ()
  • character, String, numeric, null
  • Cast
  • 方法調用
  • Field 訪問
  • Array 訪問 []
  • 三元 ?:

目前不支持如下操做

  • this
  • super
  • new
  • 顯示泛型調用

此外，DataBinding 還支持如下幾種形式的調用

Null Coalescing

空合併運算符 ?? 會取第一個不爲 null 的值做爲返回值

<TextView android:layout_width="match_parent" android:layout_height="wrap_content" android:text="@{user.name ?? user.password}" />
複製代碼

等價於

android:text="@{user.name != null ? user.name : user.password}"
複製代碼

屬性控制

能夠經過變量值來控制 View 的屬性

<TextView android:layout_width="match_parent" android:layout_height="wrap_content" android:text="可見性變化" android:visibility="@{user.male ? View.VISIBLE : View.GONE}" />
複製代碼

避免空指針異常

DataBinding 也會自動幫助咱們避免空指針異常 例如，若是 "@{userInfo.password}" 中 userInfo 爲 null 的話，userInfo.password 會被賦值爲默認值 null，而不會拋出空指針異常

7、include 和 viewStub

include

對於 include 的佈局文件，同樣是支持經過 dataBinding 來進行數據綁定，此時同樣須要在待 include 的佈局中依然使用 layout 標籤，聲明須要使用到的變量

view_include.xml

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

    <data>
        <import type="com.leavesc.databinding_demo.model.User" />
        <variable name="userInfo" type="User" />
    </data>

    <android.support.constraint.ConstraintLayout android:layout_width="match_parent" android:layout_height="wrap_content" android:background="#acc">

        <TextView android:layout_width="match_parent" android:layout_height="wrap_content" android:gravity="center" android:padding="20dp" android:text="@{userInfo.name}" />

    </android.support.constraint.ConstraintLayout>
</layout>
複製代碼

在主佈局文件中將相應的變量傳遞給 include 佈局，從而使兩個佈局文件之間共享同一個變量

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:bind="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools">

    <data>
        <import type="com.leavesc.databinding_demo.model.User" />
        <variable name="userInfo" type="User" />
    </data>

    <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" tools:context=".Main6Activity">
        
        <include layout="@layout/view_include" bind:userInfo="@{userInfo}" />
        
    </LinearLayout>
</layout>
複製代碼

viewStub

dataBinding 同樣支持 ViewStub 佈局

在佈局文件中引用 viewStub 佈局

<ViewStub android:id="@+id/view_stub" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout="@layout/view_stub"/>
複製代碼

獲取到 ViewStub 對象，由此就能夠來控制 ViewStub 的可見性

ActivityMain6Binding activityMain6Binding = DataBindingUtil.setContentView(this, R.layout.activity_main6);
	View view = activityMain6Binding.viewStub.getViewStub().inflate();
複製代碼

若是須要爲 ViewStub 綁定變量值，則 ViewStub 文件同樣要使用 layout 標籤進行佈局，主佈局文件使用自定義的 bind 命名空間將變量傳遞給 ViewStub

<ViewStub android:id="@+id/view_stub" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout="@layout/view_stub" bind:userInfo="@{userInfo}" />
複製代碼

若是在 xml 中沒有使用 bind:userInfo="@{userInf}"對 ViewStub 進行數據綁定，則能夠等到當 ViewStub Inflate 時再綁定變量，此時須要爲 ViewStub 設置 setOnInflateListener回調函數，在回調函數中進行數據綁定

activityMain6Binding.viewStub.setOnInflateListener(new ViewStub.OnInflateListener() {
            @Override
            public void onInflate(ViewStub stub, View inflated) {
                //若是在 xml 中沒有使用 bind:userInfo="@{userInf}" 對 viewStub 進行數據綁定
                //那麼能夠在此處進行手動綁定
                ViewStubBinding viewStubBinding = DataBindingUtil.bind(inflated);
                viewStubBinding.setUserInfo(user);
                Log.e(TAG, "onInflate");
            }
        });
複製代碼

8、BindingAdapter

dataBinding 提供了 BindingAdapter 這個註解用於支持自定義屬性，或者是修改原有屬性。註解值能夠是已有的 xml 屬性，例如 android:src、android:text等，也能夠自定義屬性而後在 xml 中使用

例如，對於一個 ImageView ，咱們但願在某個變量值發生變化時，能夠動態改變顯示的圖片，此時就能夠經過 BindingAdapter 來實現

須要先定義一個靜態方法，爲之添加 BindingAdapter 註解，註解值是爲 ImageView 控件自定義的屬性名，而該靜態方法的兩個參數能夠這樣來理解：當 ImageView 控件的 url 屬性值發生變化時，dataBinding 就會將 ImageView 實例以及新的 url 值傳遞給 loadImage() 方法，從而能夠在此動態改變 ImageView 的相關屬性

@BindingAdapter({"url"})
    public static void loadImage(ImageView view, String url) {
        Log.e(TAG, "loadImage url : " + url);
    }
複製代碼

在 xml 文件中關聯變量值，當中，bind 這個名稱能夠自定義

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:bind="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools">

    <data>
        <import type="com.leavesc.databinding_demo.model.Image" />
        <variable name="image" type="Image" />
    </data>

    <android.support.constraint.ConstraintLayout android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".Main8Activity">

        <ImageView android:id="@+id/image" android:layout_width="wrap_content" android:layout_height="wrap_content" android:src="@drawable/ic_launcher_background" bind:url="@{image.url}" />
        
    </android.support.constraint.ConstraintLayout>
</layout>
複製代碼

BindingAdapter 更爲強大的一點是能夠覆蓋 Android 原先的控件屬性。例如，能夠設定每個 Button 的文本都要加上後綴：「-Button」

@BindingAdapter("android:text")
    public static void setText(Button view, String text) {
        view.setText(text + "-Button");
    }
複製代碼
<Button android:layout_width="match_parent" android:layout_height="wrap_content" android:onClick="@{()->handler.onClick(image)}" android:text='@{"改變圖片Url"}'/>
複製代碼

這樣，整個工程中使用到了 "android:text" 這個屬性的控件，其顯示的文本就會多出一個後綴

9、BindingConversion

dataBinding 還支持對數據進行轉換，或者進行類型轉換

與 BindingAdapter 相似，如下方法會將佈局文件中全部以@{String}方式引用到的String類型變量加上後綴-conversionString

@BindingConversion
    public static String conversionString(String text) {
        return text + "-conversionString";
    }
複製代碼

xml 文件

<TextView android:layout_width="match_parent" android:layout_height="wrap_content" android:text='@{"xxx"}' android:textAllCaps="false"/>
複製代碼

能夠看到，對於 Button 來講，BindingAdapter 和 BindingConversion 同時生效了，而 BindingConversion 的優先級要高些

此外，BindingConversion 也能夠用於轉換屬性值的類型

看如下佈局，此處在向 background 和 textColor 兩個屬性賦值時，直接就使用了字符串，按正常狀況來講這天然是會報錯的，但有了 BindingConversion 後就能夠自動將字符串類型的值轉爲須要的 Drawable 和 Color 了

<TextView android:layout_width="match_parent" android:layout_height="wrap_content" android:background='@{"紅色"}' android:padding="20dp" android:text="紅色背景藍色字" android:textColor='@{"藍色"}'/>

        <TextView android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_marginTop="20dp" android:background='@{"藍色"}' android:padding="20dp" android:text="藍色背景紅色字" android:textColor='@{"紅色"}'/>
複製代碼
@BindingConversion
    public static Drawable convertStringToDrawable(String str) {
        if (str.equals("紅色")) {
            return new ColorDrawable(Color.parseColor("#FF4081"));
        }
        if (str.equals("藍色")) {
            return new ColorDrawable(Color.parseColor("#3F51B5"));
        }
        return new ColorDrawable(Color.parseColor("#344567"));
    }

    @BindingConversion
    public static int convertStringToColor(String str) {
        if (str.equals("紅色")) {
            return Color.parseColor("#FF4081");
        }
        if (str.equals("藍色")) {
            return Color.parseColor("#3F51B5");
        }
        return Color.parseColor("#344567");
    }
複製代碼

10、Array、List、Set、Map ...

dataBinding 也支持在佈局文件中使用 數組、Lsit、Set 和 Map，且在佈局文件中均可以經過 list[index] 的形式來獲取元素

而爲了和 variable 標籤的尖括號區分開，在聲明 Lsit< String > 之類的數據類型時，須要使用尖括號的轉義字符

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">

    <data>
        <import type="java.util.List" />
        <import type="java.util.Map" />
        <import type="java.util.Set" />
        <import type="android.util.SparseArray" />
        <variable name="array" type="String[]" />
        <variable name="list" type="List&lt;String&gt;" />
        <variable name="map" type="Map&lt;String, String&gt;" />
        <variable name="set" type="Set&lt;String&gt;" />
        <variable name="sparse" type="SparseArray&lt;String&gt;" />
        <variable name="index" type="int" />
        <variable name="key" type="String" />
    </data>

    <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" tools:context=".Main7Activity">

        <TextView ··· android:text="@{array[1]}" />
        <TextView ··· android:text="@{sparse[index]}" />
        <TextView ··· android:text="@{list[index]}" />
        <TextView ··· android:text="@{map[key]}" />
        <TextView ··· android:text='@{map["leavesC"]}' />
        <TextView ··· android:text='@{set.contains("xxx")?"xxx":key}' />
    </LinearLayout>
</layout>
複製代碼

11、資源引用

dataBinding 支持對尺寸和字符串這類資源的訪問

dimens.xml

<dimen name="paddingBig">190dp</dimen>
    <dimen name="paddingSmall">150dp</dimen>
複製代碼

strings.xml

<string name="format">%s is %s</string>
複製代碼
<data>
        <variable name="flag" type="boolean" />
    </data>       
	<Button android:layout_width="match_parent" android:layout_height="wrap_content" android:paddingLeft="@{flag ? @dimen/paddingBig:@dimen/paddingSmall}" android:text='@{@string/format("leavesC", "Ye")}' android:textAllCaps="false" />
複製代碼

對 DataBinding 的介紹到這裏也就結束，固然，確定還有些遺落的知識點，不過大致上我自認也已經講得很清楚了，剩下的就留待往後補充了

這裏提供上述示例代碼的下載，或者你能在 GitHub 上給個 Star？

個人 GitHub 主頁 -> leavesC

項目主頁 -> DataBinding_Demo

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程