DataBinding 是谷歌官方發(fā)布的一個(gè)框架,顧名思義即為數(shù)據(jù)綁定,是 MVVM 模式在 Android 上的一種實(shí)現(xiàn),用于降低布局和邏輯的耦合性铲球,使代碼邏輯更加清晰全景。MVVM 相對(duì)于 MVP,其實(shí)就是將 Presenter 層替換成了 ViewModel 層。DataBinding 能夠省去我們一直以來(lái)的 findViewById() 步驟,大量減少 Activity 內(nèi)的代碼,數(shù)據(jù)能夠單向或雙向綁定到 layout 文件中萎坷,有助于防止內(nèi)存泄漏,而且能自動(dòng)進(jìn)行空檢測(cè)以避免空指針異常
啟用 DataBinding 的方法是在對(duì)應(yīng) Model 的 build.gradle 文件里加入以下代碼沐兰,同步后就能引入對(duì) DataBinding 的支持
android {
dataBinding {
enabled = true
}
}
一哆档、基礎(chǔ)入門
啟用 DataBinding 后,這里先來(lái)看下如何在布局文件中綁定指定的變量
打開布局文件住闯,選中根布局的 ViewGroup瓜浸,按住 Alt + 回車鍵澳淑,點(diǎn)擊 “Convert to data binding layout”,就可以生成 DataBinding 需要的布局規(guī)則
<?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>
和原始布局的區(qū)別在于多出了一個(gè) layout 標(biāo)簽將原布局包裹了起來(lái)插佛,data 標(biāo)簽用于聲明要用到的變量以及變量類型杠巡,要實(shí)現(xiàn) MVVM 的 ViewModel 就需要把數(shù)據(jù)(Model)與 UI(View)進(jìn)行綁定,data 標(biāo)簽的作用就像一個(gè)橋梁搭建了 View 和 Model 之間的通道
這里先來(lái)聲明一個(gè) Modle
package com.leavesc.databinding_demo.model;
/**
* 作者:葉應(yīng)是葉
* 時(shí)間:2018/5/16 20:20
* 描述:https://github.com/leavesC
*/
public class User {
private String name;
private String password;
···
}
在 data 標(biāo)簽里聲明要使用到的變量名雇寇、類的全路徑
<data>
<variable
name="userInfo"
type="com.leavesc.databinding_demo.model.User" />
</data>
如果 User 類型要多處用到氢拥,也可以直接將之 import 進(jìn)來(lái),這樣就不用每次都指明整個(gè)包名路徑了锨侯,而 java.lang.*
包中的類會(huì)被自動(dòng)導(dǎo)入嫩海,所以可以直接使用
<data>
<import type="com.leavesc.databinding_demo.model.User"/>
<variable
name="userInfo"
type="User"/>
</data>
如果存在 import 的類名相同的情況,可以使用 alias 指定別名
<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>
這里聲明了一個(gè) User 類型的變量 userInfo囚痴,我們要做的就是使這個(gè)變量與兩個(gè) TextView 控件掛鉤叁怪,通過(guò)設(shè)置 userInfo 的變量值同時(shí)使 TextView 顯示相應(yīng)的文本
完整的布局代碼如下所示
<?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>
通過(guò) @{userInfo.name}
使 TextView 引用到相關(guān)的變量,DataBinding 會(huì)將之映射到相應(yīng)的 getter 方法
之后可以在 Activity 中通過(guò) DataBindingUtil
設(shè)置布局文件深滚,省略原先 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}
在布局文件中并沒(méi)有明確的值,所以在預(yù)覽視圖中什么都不會(huì)顯示成箫,不便于觀察文本的大小和字體顏色等屬性展箱,此時(shí)可以為之設(shè)定默認(rèn)值(文本內(nèi)容或者是字體大小等屬性都適用),默認(rèn)值將只在預(yù)覽視圖中顯示蹬昌,且默認(rèn)值不能包含引號(hào)
android:text="@{userInfo.name,default=defaultValue}"
此外,也可以通過(guò) ActivityMain2Binding 直接獲取到指定 ID 的控件
activityMain2Binding.tvUserName.setText("leavesC");
每個(gè)數(shù)據(jù)綁定布局文件都會(huì)生成一個(gè)綁定類攀隔,ViewDataBinding 的實(shí)例名是根據(jù)布局文件名來(lái)生成皂贩,將之改為首字母大寫的駝峰命名法來(lái)命名,并省略布局文件名包含的下劃線昆汹∶魉ⅲ控件的獲取方式類似,但首字母小寫
也可以通過(guò)如下方式自定義 ViewDataBinding 的實(shí)例名
<data class="CustomBinding">
</data>
此外满粗,在綁定表達(dá)式中會(huì)根據(jù)需要生成一個(gè)名為context
的特殊變量辈末,context
的值是根 View 的getContext()
方法返回的Context
對(duì)象, context
變量會(huì)被具有該名稱的顯式變量聲明所覆蓋
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();
}
**以上實(shí)現(xiàn)數(shù)據(jù)綁定的方式,每當(dāng)綁定的變量發(fā)生變化的時(shí)候捅彻,都需要重新向 ViewDataBinding 傳遞新的變量值才能刷新 UI 组去。接下來(lái)看如何實(shí)現(xiàn)自動(dòng)刷新 UI **
二、單向數(shù)據(jù)綁定
實(shí)現(xiàn)數(shù)據(jù)變化自動(dòng)驅(qū)動(dòng) UI 刷新的方式有三種:BaseObservable
步淹、ObservableField
从隆、ObservableCollection
BaseObservable
一個(gè)純凈的 ViewModel 類被更新后诚撵,并不會(huì)讓 UI 自動(dòng)更新。而數(shù)據(jù)綁定后键闺,我們自然會(huì)希望數(shù)據(jù)變更后 UI 會(huì)即時(shí)刷新寿烟,Observable 就是為此而生的概念
BaseObservable 提供了 notifyChange() 和 notifyPropertyChanged() 兩個(gè)方法,前者會(huì)刷新所有的值域辛燥,后者則只更新對(duì)應(yīng) BR 的 flag韧衣,該 BR 的生成通過(guò)注釋 @Bindable 生成,可以通過(guò) BR notify 特定屬性關(guān)聯(lián)的視圖
/**
* 作者:葉應(yīng)是葉
* 時(shí)間: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() 方法中更新的是所有字段
添加兩個(gè)按鈕用于改變 goods 變量的三個(gè)屬性值勃蜘,由此可以看出兩個(gè) notify 方法的區(qū)別硕噩。當(dāng)中涉及的按鈕點(diǎn)擊事件綁定,在下面也會(huì)講到
<?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>
/**
* 作者:葉應(yīng)是葉
* 時(shí)間: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 視圖的刷新沒(méi)有同時(shí)刷新 price 視圖炉擅,而 details 視圖刷新的同時(shí)也刷新了 price 視圖
實(shí)現(xiàn)了 Observable 接口的類允許注冊(cè)一個(gè)監(jiān)聽(tīng)器,當(dāng)可觀察對(duì)象的屬性更改時(shí)就會(huì)通知這個(gè)監(jiān)聽(tīng)器阳惹,此時(shí)就需要用到 OnPropertyChangedCallback
當(dāng)中 propertyId
就用于標(biāo)識(shí)特定的字段
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 類相對(duì)來(lái)說(shuō)限制有點(diǎn)高谍失,且也需要進(jìn)行 notify 操作,因此為了簡(jiǎn)單起見(jiàn)可以選擇使用 ObservableField莹汤。ObservableField 可以理解為官方對(duì) BaseObservable 中字段的注解和刷新等操作的封裝快鱼,官方原生提供了對(duì)基本數(shù)據(jù)類型的封裝,例如 ObservableBoolean纲岭、ObservableByte抹竹、ObservableChar、ObservableShort止潮、ObservableInt窃判、ObservableLong、ObservableFloat喇闸、ObservableDouble 以及 ObservableParcelable 袄琳,也可通過(guò) ObservableField 泛型來(lái)申明其他類型
/**
* 作者:葉應(yīng)是葉
* 時(shí)間: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);
}
```
}
對(duì) ObservableGoods 屬性值的改變都會(huì)立即觸發(fā) UI 刷新,概念上與 Observable 區(qū)別不大燃乍,具體效果可看下面提供的源代碼唆樊,這里不再贅述
ObservableCollection
dataBinding 也提供了包裝類用于替代原生的 List
和 Map
,分別是 ObservableList
和 ObservableMap
,當(dāng)其包含的數(shù)據(jù)發(fā)生變化時(shí)橘沥,綁定的視圖也會(huì)隨之進(jìn)行刷新
<?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<String>"/>
<variable
name="map"
type="ObservableMap<String,String>"/>
<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="改變數(shù)據(jù)"/>
</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));
}
三窗轩、雙向數(shù)據(jù)綁定
雙向綁定的意思即為當(dāng)數(shù)據(jù)改變時(shí)同時(shí)使視圖刷新,而視圖改變時(shí)也可以同時(shí)改變數(shù)據(jù)
看以下例子座咆,當(dāng) EditText 的輸入內(nèi)容改變時(shí)痢艺,會(huì)同時(shí)同步到變量 goods
,綁定變量的方式比單向綁定多了一個(gè)等號(hào):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);
}
}
四仓洼、事件綁定
嚴(yán)格意義上來(lái)說(shuō),事件綁定也是一種變量綁定堤舒,只不過(guò)設(shè)置的變量是回調(diào)接口而已
事件綁定可用于以下多種回調(diào)事件
- android:onClick
- android:onLongClick
- android:afterTextChanged
- android:onTextChanged
- ...
在 Activity 內(nèi)部新建一個(gè) UserPresenter 類來(lái)聲明 onClick() 和 afterTextChanged() 事件相應(yīng)的回調(diào)方法
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>
方法引用的方式與調(diào)用函數(shù)的方式類似色建,既可以選擇保持事件回調(diào)方法的簽名一致:@{userPresenter.afterTextChanged},此時(shí)方法名可以不一樣舌缤,但方法參數(shù)和返回值必須和原始的回調(diào)函數(shù)保持一致箕戳。也可以引用不遵循默認(rèn)簽名的函數(shù):@{()->userPresenter.onUserNameClick(userInfo)},這里用到了 Lambda 表達(dá)式国撵,這樣就可以不遵循默認(rèn)的方法簽名陵吸,將userInfo
對(duì)象直接傳回點(diǎn)擊方法中。此外介牙,也可以使用方法引用 :: 的形式來(lái)進(jìn)行事件綁定
五壮虫、使用類方法
首先定義一個(gè)靜態(tài)方法
public class StringUtils {
public static String toUpperCase(String str) {
return str.toUpperCase();
}
}
在 data 標(biāo)簽中導(dǎo)入該工具類
<import type="com.leavesc.databinding_demo.StringUtils" />
然后就可以像對(duì)待一般的函數(shù)一樣來(lái)調(diào)用了
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:onClick="@{()->userPresenter.onUserNameClick(userInfo)}"
android:text="@{StringUtils.toUpperCase(userInfo.name)}" />
六、運(yùn)算符
基礎(chǔ)運(yùn)算符
DataBinding 支持在布局文件中使用以下運(yùn)算符环础、表達(dá)式和關(guān)鍵字
- 算術(shù) + - / * %
- 字符串合并 +
- 邏輯 && ||
- 二元 & | ^
- 一元 + - ! ~
- 移位 >> >>> <<
- 比較 == > < >= <=
- Instanceof
- Grouping ()
- character, String, numeric, null
- Cast
- 方法調(diào)用
- Field 訪問(wèn)
- Array 訪問(wèn) []
- 三元 ?:
目前不支持以下操作
- this
- super
- new
- 顯示泛型調(diào)用
此外囚似,DataBinding 還支持以下幾種形式的調(diào)用
Null Coalescing
空合并運(yùn)算符 ?? 會(huì)取第一個(gè)不為 null 的值作為返回值
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@{user.name ?? user.password}" />
等價(jià)于
android:text="@{user.name != null ? user.name : user.password}"
屬性控制
可以通過(guò)變量值來(lái)控制 View 的屬性
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="可見(jiàn)性變化"
android:visibility="@{user.male ? View.VISIBLE : View.GONE}" />
避免空指針異常
DataBinding 也會(huì)自動(dòng)幫助我們避免空指針異常
例如,如果 "@{userInfo.password}" 中 userInfo 為 null 的話线得,userInfo.password 會(huì)被賦值為默認(rèn)值 null饶唤,而不會(huì)拋出空指針異常
七、include 和 viewStub
include
對(duì)于 include 的布局文件贯钩,一樣是支持通過(guò) dataBinding 來(lái)進(jìn)行數(shù)據(jù)綁定募狂,此時(shí)一樣需要在待 include 的布局中依然使用 layout 標(biāo)簽,聲明需要使用到的變量
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>
在主布局文件中將相應(yīng)的變量傳遞給 include 布局魏保,從而使兩個(gè)布局文件之間共享同一個(gè)變量
<?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 對(duì)象熬尺,由此就可以來(lái)控制 ViewStub 的可見(jiàn)性
ActivityMain6Binding activityMain6Binding = DataBindingUtil.setContentView(this, R.layout.activity_main6);
View view = activityMain6Binding.viewStub.getViewStub().inflate();
如果需要為 ViewStub 綁定變量值,則 ViewStub 文件一樣要使用 layout 標(biāo)簽進(jìn)行布局谓罗,主布局文件使用自定義的 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 中沒(méi)有使用 bind:userInfo="@{userInf}"
對(duì) ViewStub 進(jìn)行數(shù)據(jù)綁定,則可以等到當(dāng) ViewStub Inflate 時(shí)再綁定變量季二,此時(shí)需要為 ViewStub 設(shè)置 setOnInflateListener
回調(diào)函數(shù)檩咱,在回調(diào)函數(shù)中進(jìn)行數(shù)據(jù)綁定
activityMain6Binding.viewStub.setOnInflateListener(new ViewStub.OnInflateListener() {
@Override
public void onInflate(ViewStub stub, View inflated) {
//如果在 xml 中沒(méi)有使用 bind:userInfo="@{userInf}" 對(duì) viewStub 進(jìn)行數(shù)據(jù)綁定
//那么可以在此處進(jìn)行手動(dòng)綁定
ViewStubBinding viewStubBinding = DataBindingUtil.bind(inflated);
viewStubBinding.setUserInfo(user);
Log.e(TAG, "onInflate");
}
});
八、BindingAdapter
dataBinding 提供了 BindingAdapter 這個(gè)注解用于支持自定義屬性胯舷,或者是修改原有屬性刻蚯。注解值可以是已有的 xml 屬性,例如 android:src
桑嘶、android:text
等炊汹,也可以自定義屬性然后在 xml 中使用
例如,對(duì)于一個(gè) ImageView 逃顶,我們希望在某個(gè)變量值發(fā)生變化時(shí)讨便,可以動(dòng)態(tài)改變顯示的圖片充甚,此時(shí)就可以通過(guò) BindingAdapter 來(lái)實(shí)現(xiàn)
需要先定義一個(gè)靜態(tài)方法,為之添加 BindingAdapter 注解霸褒,注解值是為 ImageView 控件自定義的屬性名伴找,而該靜態(tài)方法的兩個(gè)參數(shù)可以這樣來(lái)理解:當(dāng) ImageView 控件的 url 屬性值發(fā)生變化時(shí),dataBinding 就會(huì)將 ImageView 實(shí)例以及新的 url 值傳遞給 loadImage() 方法废菱,從而可以在此動(dòng)態(tài)改變 ImageView 的相關(guān)屬性
@BindingAdapter({"url"})
public static void loadImage(ImageView view, String url) {
Log.e(TAG, "loadImage url : " + url);
}
在 xml 文件中關(guān)聯(lián)變量值技矮,當(dāng)中,bind 這個(gè)名稱可以自定義
<?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 更為強(qiáng)大的一點(diǎn)是可以覆蓋 Android 原先的控件屬性殊轴。例如衰倦,可以設(shè)定每一個(gè) 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"}'/>
這樣,整個(gè)工程中使用到了 "android:text" 這個(gè)屬性的控件旁理,其顯示的文本就會(huì)多出一個(gè)后綴
九樊零、BindingConversion
dataBinding 還支持對(duì)數(shù)據(jù)進(jìn)行轉(zhuǎn)換,或者進(jìn)行類型轉(zhuǎn)換
與 BindingAdapter 類似韧拒,以下方法會(huì)將布局文件中所有以@{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"/>
可以看到淹接,對(duì)于 Button 來(lái)說(shuō),BindingAdapter 和 BindingConversion 同時(shí)生效了叛溢,而 BindingConversion 的優(yōu)先級(jí)要高些
此外塑悼,BindingConversion 也可以用于轉(zhuǎn)換屬性值的類型
看以下布局,此處在向 background
和 textColor
兩個(gè)屬性賦值時(shí)楷掉,直接就使用了字符串厢蒜,按正常情況來(lái)說(shuō)這自然是會(huì)報(bào)錯(cuò)的,但有了 BindingConversion 后就可以自動(dòng)將字符串類型的值轉(zhuǎn)為需要的 Drawable
和 Color
了
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background='@{"紅色"}'
android:padding="20dp"
android:text="紅色背景藍(lán)色字"
android:textColor='@{"藍(lán)色"}'/>
<TextView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginTop="20dp"
android:background='@{"藍(lán)色"}'
android:padding="20dp"
android:text="藍(lán)色背景紅色字"
android:textColor='@{"紅色"}'/>
@BindingConversion
public static Drawable convertStringToDrawable(String str) {
if (str.equals("紅色")) {
return new ColorDrawable(Color.parseColor("#FF4081"));
}
if (str.equals("藍(lán)色")) {
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("藍(lán)色")) {
return Color.parseColor("#3F51B5");
}
return Color.parseColor("#344567");
}
十烹植、Array斑鸦、List、Set草雕、Map ...
dataBinding 也支持在布局文件中使用 數(shù)組巷屿、Lsit、Set 和 Map墩虹,且在布局文件中都可以通過(guò) list[index]
的形式來(lái)獲取元素
而為了和 variable 標(biāo)簽的尖括號(hào)區(qū)分開嘱巾,在聲明 Lsit< String > 之類的數(shù)據(jù)類型時(shí),需要使用尖括號(hào)的轉(zhuǎn)義字符
<?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<String>" />
<variable
name="map"
type="Map<String, String>" />
<variable
name="set"
type="Set<String>" />
<variable
name="sparse"
type="SparseArray<String>" />
<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>
十一诫钓、資源引用
dataBinding 支持對(duì)尺寸和字符串這類資源的訪問(wèn)
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" />
對(duì) DataBinding 的介紹到這里也就結(jié)束旬昭,當(dāng)然,肯定還有些遺落的知識(shí)點(diǎn)菌湃,不過(guò)大體上我自認(rèn)也已經(jīng)講得很清楚了问拘,剩下的就留待日后補(bǔ)充了
這里提供上述示例代碼的下載,或者你能在 GitHub 上給個(gè) Star?
項(xiàng)目主頁(yè) -> DataBinding_Demo
公眾號(hào):字節(jié)數(shù)組骤坐,熱衷于分享 Android 系統(tǒng)源碼解析绪杏,Jetpack 源碼解析、熱門開源庫(kù)源碼解析等面試必備的知識(shí)點(diǎn)