翻譯自：Data Binding

本文檔說明了如何使用Data Binding Library來編寫聲明式布局,并將必要的代碼最小化的綁定到應用的邏輯和布局中。

Data Binding Library非常的靈活并且兼容性很廣 -- 它是一個兼容包,因此可以將它用到從Android 2.1(API level 7+)開始的所有的android平臺版本中。

要使用Data Binding,android 的構(gòu)建插件gradle要求1.5.0-alpha1或者更高的版本。

構(gòu)建環(huán)境

要開始使用Data Binding ,先從Android SDK manager的兼容庫中下載。

下載完成后需要進行配置，添加 dataBinding 節(jié)點到app module的build.gradle 中。 android {....dataBinding {enabled = true} }如果你的app module依賴于另外一個使用了data binding的庫，你的app module 的 build.gradle中也需要進行配置。
另外，確保使用的是兼容版本的Android Studio開發(fā)工具。Android Studio 1.3及之后的版本為data binding提供支持描述，Android Studio Support For Data Binding。

Data Binding 布局文件

寫數(shù)據(jù)綁定式

Data-binding的布局文件和普通的布局文件相比，有一些略微的不同；Data-binding的布局文件的根節(jié)點是 layout ，隨后跟隨的是一個 data 元素，再下面才是普通布局元素。此視圖元素將是一個非綁定布局文件的根目錄。一個簡單的示例： <?xml version="1.0" encoding="utf-8"?> <layout xmlns:android="http://schemas.android.com/apk/res/android"><data><variable name="user" type="com.example.User"/></data><LinearLayoutandroid:orientation="vertical"android:layout_width="match_parent"android:layout_height="match_parent"><TextView android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@{user.firstName}"/><TextView android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@{user.lastName}"/></LinearLayout> </layout>
在這個布局中使用 variable 描述數(shù)據(jù)屬性。 <variable name="user" type="com.example.User"/>在布局文件中的數(shù)據(jù)綁定表達式是寫入到節(jié)點的屬性中的，語法為："@{}"；這里TextView的text設(shè)置為用戶的firstName。<TextView android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@{user.firstName}"/>

數(shù)據(jù)對象

假設(shè)現(xiàn)在有一個普通的java對象（POJO） User：

public class User {public final String firstName;public final String lastName;public User(String firstName, String lastName) {this.firstName = firstName;this.lastName = lastName;} }這種類型的對象的數(shù)據(jù)不會發(fā)生更改。在應用程序中，有一次讀取的數(shù)據(jù)是很常見的，此后數(shù)據(jù)不能更改。也可以使用JavaBeans對象： public class User {private final String firstName;private final String lastName;public User(String firstName, String lastName) {this.firstName = firstName;this.lastName = lastName;}public String getFirstName() {return this.firstName;}public String getLastName() {return this.lastName;} }從數(shù)據(jù)綁定的角度看，這兩個文件是一樣的。表達式 @{user.firstName} 作用于 TextView的 android:text="" 屬性上, 對于前一個文件將使用 firstName 字段，對于后一個文件將使用 getFirstName 方法獲取需要綁定的數(shù)據(jù)。或者，將會解析 firstName() 方法。 通俗的講：我們的數(shù)據(jù)實體對象的屬性可以是public類型的，如果是其它類型的則需要配置getter方法，或者直接使用字段名作為方法名的函數(shù)。

綁定數(shù)據(jù)

默認的綁定類的名稱將根據(jù)布局文件名稱來生成，使用PascalCase(帕斯卡寫法)拼接上Binding后綴。上述布局文件是main_activity.xml所以生成類是MainActivityBinding。 這個類包含所有綁定的布局屬性（例如:user 變量）和知道如何分配值到綁定表達式。創(chuàng)建綁定的最簡單方法是inflating：
@Override protected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);MainActivityBinding binding = DataBindingUtil.setContentView(this, R.layout.main_activity);User user = new User("Test", "User");binding.setUser(user); }做好了后，運行程序，會發(fā)現(xiàn)測試的用戶數(shù)據(jù)顯示到了界面上?；蛘咭部梢酝ㄟ^get view的方式創(chuàng)建綁定類。 MainActivityBinding binding = MainActivityBinding.inflate(getLayoutInflater());如果是在ListView或者RecyclerView的item中使用數(shù)據(jù)綁定，則使用下面的方式： ListItemBinding binding = ListItemBinding.inflate(layoutInflater, viewGroup, false); //or ListItemBinding binding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false);

綁定事件

事件可以直接綁定到方法上，類似于通過布局文件直接綁定方法( android:onClick )，事件屬性名是由偵聽器方法的名稱來管理的，有一些例外。例如：View.onLongClickListener?有一個方法?onLongClick，因此事件的屬性是?android:onLongClick。 要將事件分配給它的處理程序，使用一個標準的綁定表達式，以方法名稱作為值調(diào)用。例如，如果你的數(shù)據(jù)對象有2個方法： public class MyHandlers {public void onClickFriend(View view) { ... }public void onClickEnemy(View view) { ... } }綁定表達式可以指定一個View的OnClickListener：
<?xml version="1.0" encoding="utf-8"?> <layout xmlns:android="http://schemas.android.com/apk/res/android"><data><variable name="handlers" type="com.example.Handlers"/><variable name="user" type="com.example.User"/></data><LinearLayoutandroid:orientation="vertical"android:layout_width="match_parent"android:layout_height="match_parent"><TextView android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@{user.firstName}"android:onClick="@{user.isFriend ? handlers.onClickFriend : handlers.onClickEnemy}"/><TextView android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@{user.lastName}"android:onClick="@{user.isFriend ? handlers.onClickFriend : handlers.onClickEnemy}"/></LinearLayout> </layout>有一些單獨的事件，為了避免和 onclick?沖突，有專門的屬性，以下表格做了列舉：
Class(類)Listener Setter(類中設(shè)置監(jiān)聽器的方法)Attribute(屬性)

SearchView	setOnSearchClickListener(View.OnClickListener)? ? ? ? ??	android:onSearchClick ? ??
ZoomControls? ? ? ? ? ?	setOnZoomInClickListener(View.OnClickListener)? ? ?	android:onZoomIn
ZoomControls	setOnZoomInClickListener(View.OnClickListener)	android:onZoomOut

布局明細

導包

在 data 節(jié)點可以有0個或者多個導入節(jié)點，這樣你就能像在java中，使用另外一個類一樣的方便。 <data><import type="android.view.View"/> </data>如上面，通過 import 導入指向的View后，就可以直接在綁定表達式中使用 View 了。 <TextViewandroid:text="@{user.lastName}"android:layout_width="wrap_content"android:layout_height="wrap_content"android:visibility="@{user.isAdult ? View.VISIBLE : View.GONE}"/>就如果上面，如果在 data 節(jié)點下使用了 import 導入了指向的View，就可以在android:visibility中使用View了。就跟在java代碼中的使用一樣。
如果導入了多個類，并且出現(xiàn)了命名沖突的情況，可以通過指定別名【alias】的方式來解決。
<import type="android.view.View"/> <import type="com.example.real.estate.View"alias="Vista"/>如上，導入了兩個類，結(jié)果兩個類的名稱都是View，這個時候，就為下面的類指定別名為 'Vista'，Vista 就指向了 com.example.real.estate.View，而View就指向了 android.view.View類。導入類型可作為變量和表達式的類型引用：
<data><import type="com.example.User"/><import type="java.util.List"/><variable name="user" type="User"/><variable name="userList" type="List<User>"/> </data>注：Android Studio針對 import 還沒有自動補全功能。您的應用程序仍然可以編譯通過，你可以在IDE的問題在你的變量定義使用完全限定的名稱。
<TextViewandroid:text="@{((User)(user.connection)).lastName}"android:layout_width="wrap_content"android:layout_height="wrap_content"/>導入的類，也可以在表達式中，使用靜態(tài)的字段和方法(static)：<data><import type="com.example.MyStringUtils"/><variable name="user" type="com.example.User"/> </data> … <TextViewandroid:text="@{MyStringUtils.capitalize(user.lastName)}"android:layout_width="wrap_content"android:layout_height="wrap_content"/>就像在java中，java.lang.*是自動導入的。

變量

在 data 節(jié)點下可以有任意數(shù)量的變量(variable)，每一個 variable描述了一個可以在布局文件中使用的屬性。 <data><import type="android.graphics.drawable.Drawable"/><variable name="user" type="com.example.User"/><variable name="image" type="Drawable"/><variable name="note" type="String"/> </data>

變量類型在編譯時檢查，所以如果一個變量實現(xiàn)?Observable?或是?observable collection，則應該在該類型中反映。如果變量是一個基類或接口，沒有實現(xiàn)Observable*?接口，將不被觀察到的變量！

當有不同的配置文件（例如，橫向或縱向），變量將被合并。在這些布局文件之間不存在沖突的變量定義。

生成綁定類將有一個為每個描述變量的setter和getter。這些變量在調(diào)用setter之前，將采用默認值 - 引用類型為null，int為0，boolean為false等。

一個特殊的變量命名為的context。context的值是從根目錄的getcontext()語境。context變量將具有該名稱的顯式變量聲明重寫。

自定義綁定類名

默認的，綁定的類名是根據(jù)布局文件的名稱來生成的，大寫字母開頭，去除 '_'，然后拼接上 '_' 后的單詞，然后跟上 ‘Binding’ 。這個類將被放置在一個 module 包的 databinding 包下。例如：如果一個布局文件的名稱是，contact_item.xml生成的綁定文件名稱是 ContactItemBinding。如果模塊包為：com.example.my.app然后生成的綁定類將被放到?com.example.my.app.databinding 。
綁定類的名稱，也能通過 data 節(jié)點的 class 屬性重命名或者放到不同的包下面。 <data class="ContactItem">... </data>這個例子生成的綁定類名是ContactItem，并且放到module包的databinding下面。如果想要放到不同的包下面，可以通過使用 '.' 前綴： <data class=".ContactItem">... </data>在這個例子中，生成的綁定類 ContactItem將被放到module的包目錄下，如果指定了全類名，可以放到任意包下： <data class="com.example.ContactItem">... </data>

Includes

變量可以通過應用程序的命名空間和屬性變量的方式，將變量傳遞給通過 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"><data><variable name="user" type="com.example.User"/></data><LinearLayoutandroid:orientation="vertical"android:layout_width="match_parent"android:layout_height="match_parent"><include layout="@layout/name"bind:user="@{user}"/><include layout="@layout/contact"bind:user="@{user}"/></LinearLayout> </layout>在這個例子中，在 name.xml 和 contact.xml 布局文件中都能使用 user 變量。
Data Binding 不支持 include 作為 merge 節(jié)點的直接子類的方式，例如，以下示例是不支持的：
<?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"><data><variable name="user" type="com.example.User"/></data><merge><include layout="@layout/name"bind:user="@{user}"/><include layout="@layout/contact"bind:user="@{user}"/></merge> </layout>

Expression Language(表達式·)

Common Features(通用的特點)

綁定表達式跟java表達式一樣，有一些通用的符合：

• 數(shù)學符合(Mathematical) ： + ?- ? * ? / ? %
• 字符串拼接符合(String Concatenation)：+
• 邏輯運算符(Logical)：&&【并且】 ? ||【或者】
• 位操作符(Binary)：&【與】 ?|【或】 ?^【異或】
• 單目運算符(Unary)：+【取正,正號】 ?-【取負,負號】 ?!【非】 ?~【取反】
• 位運算符(Shift)：>>【帶符合右移】 ?>>>【無符號右移】 ?<<【帶符號左移】
• 比較運算符(Comparison)：==【等于】 ?>【大于】 <【小于】 >=【大于等于】 <=【小于等于】
• instanceof運算符
• 分租(Grouping)：()【小括弧】
• 常量(Literals)：character(字母)、String(字符串)、numeric(數(shù)字)、null
• 數(shù)據(jù)類型轉(zhuǎn)換(Cast)
• 方法調(diào)用(Method Calls)
• 字段調(diào)用(Field Access)
• 數(shù)組調(diào)用(Array access)：[]
• 三目運算符：? :【類似于if-else】

例如： android:text="@{String.valueOf(index + 1)}" android:visibility="@{age < 13 ? View.GONE : View.VISIBLE}" android:transitionName='@{"image_" + id}'

缺少的操作

有一些操作在表達式語法中是沒有的，你可以在java代碼中使用。

• this
• super
• new
• 顯示泛型調(diào)用

Null合并運算符

Null合并運算符(??)類似于三目運算符(? : )【if-else】 android:text="@{user.displayName ?? user.lastName}"上面的代碼等價于： android:text="@{user.displayName != null ? user.displayName : user.lastName}"

屬性引用(Property Reference)

在上面一開始講的時候，就講過通過表達式對于實體對象數(shù)據(jù)的引用，對于字段(fields)、getters、ObservableFields的引用和普通對象數(shù)據(jù)的引用是一樣的。 android:text="@{user.lastName}"

避免空指針異常

Data Binding會自動檢查null，避免出現(xiàn)空指針異常；例如：如果表達式為?@{user.name},如果user為空，則user.name則會賦予默認值(null)，如果 @{user.age}，age字段是int型的，則默認值是0。

集合

常用的集合：arrays, lists, sparse lists, 和 maps都可以通過 [] 訪問。 <data><import type="android.util.SparseArray"/><import type="java.util.Map"/><import type="java.util.List"/><variable name="list" type="List<String>"/><variable name="sparse" type="SparseArray<String>"/><variable name="map" type="Map<String, String>"/><variable name="index" type="int"/><variable name="key" type="String"/> </data> … android:text="@{list[index]}" … android:text="@{sparse[index]}" … android:text="@{map[key]}"

字符串

當使用單引號作為屬性引用的時候，其中的字符串可以使用雙引號： android:text='@{map["firstName"]}'屬性引用使用雙引號，也是可以的，這個時候，字符串的引用則通過?&quot;或者?`【鍵盤上1前面的那個符合(不按shift)】來引用。 android:text="@{map[`firstName`}" android:text="@{map[&quot;firstName&quot;]}"

Resources(資源)

使用正規(guī)的表達式來訪問資源文件也是可以的：
android:padding="@{large? @dimen/largePadding : @dimen/smallPadding}"格式字符串和復數(shù)可提供參數(shù)： android:text="@{@string/nameFormat(firstName, lastName)}" android:text="@{@plurals/banana(bananaCount)}"當一個復數(shù)需要多個參數(shù)時，所有參數(shù)都應該通過：
Have an orangeHave %d orangesandroid:text="@{@plurals/orange(orangeCount, orangeCount)}"一些資源需要明確類型調(diào)用。
Type【類型】 Normal Reference【正常引用】 Expression Reference【表達式引用】

String[]	@array	@stringArray
int[]	@array	@intArray
TypedArray	@array	@typedArray
Animator	@animator	@animator
StateListAnimator	@animator	@stateListAnimator
color?int	@color	@color
ColorStateList	@color	@colorStateList

數(shù)據(jù)對象(Data Objects)

任何普通的java對象（POJO）都可用于數(shù)據(jù)綁定，但修改一個POJO不會造成UI更新。數(shù)據(jù)綁定的真正核心，可以用在給你的數(shù)據(jù)發(fā)生變化時，通知數(shù)據(jù)對象。有三種不同的數(shù)據(jù)改變通知機制，可觀察的對象，可觀察的領(lǐng)域，和可觀察的集合。Observable objects,?observable fields, 和?observable collections.
當這些observable數(shù)據(jù)對象被綁定到UI界面時，數(shù)據(jù)對象的屬性發(fā)生更改時，UI也將自動更新。

Observable 對象(Observable Objects)

一個類實現(xiàn)?Observable?接口時，允許添加一個監(jiān)聽器到綁定的對象上，監(jiān)聽數(shù)據(jù)的變化。 Observable?接口提供了一個添加和刪除監(jiān)聽器的機制，但通知是由開發(fā)人員決定的。為了使開發(fā)更容易，Data Binding提供了一個基類 --?BaseObservable?是為了實現(xiàn)偵聽器注冊機制而創(chuàng)建的。當數(shù)據(jù)屬性發(fā)生變化時數(shù)據(jù)實現(xiàn)類依然負責進行通知，這是通過給getter方法指定一個?Bindable?注解，然后在setter中進行通知來完成的。
private static class User extends BaseObservable {private String firstName;private String lastName;@Bindablepublic String getFirstName() {return this.firstName;}@Bindablepublic String getLastName() {return this.lastName;}public void setFirstName(String firstName) {this.firstName = firstName;notifyPropertyChanged(BR.firstName);}public void setLastName(String lastName) {this.lastName = lastName;notifyPropertyChanged(BR.lastName);} }在編譯期間，Bindable?將在BR文件中生成一條記錄。BR文件將在模塊包中(module package)生成。如果數(shù)據(jù)類不能被更改，?Observable?接口通過方便的PropertyChangeRegistry來實現(xiàn)用于儲存和有效地通知監(jiān)聽者。

Observable字段

一些小工作會涉及到創(chuàng)建Observable類，因此一些開發(fā)者想節(jié)省時間或者有少量的字段的可以使用?ObservableField?和??ObservableBoolean,?ObservableByte,?ObservableChar,?ObservableShort,?ObservableInt,?ObservableLong,?ObservableFloat,ObservableDouble, and?ObservableParcelable.ObservableFields是自包含具有單個字段的 ObservableField 對象。原始版本避免裝箱和拆箱過程中訪問操作。要使用ObservableField，需要在類中創(chuàng)建public final 的字段：
private static class User {public final ObservableField<String> firstName =new ObservableField<>();public final ObservableField<String> lastName =new ObservableField<>();public final ObservableInt age = new ObservableInt(); }就是這樣，要使用值，需要使用set和get方法： user.firstName.set("Google"); int age = user.age.get();

Observable 集合

一些應用程序使用更多的動態(tài)結(jié)構(gòu)來保存數(shù)據(jù)。Observable允許鍵訪問這些數(shù)據(jù)對象，也就是說Observable是通過key-value的方式存儲數(shù)據(jù)的。類似于java中的Map和List。ObservableArrayMap?使用key是引用類型的，例如：String，類似于java中的Map。

ObservableArrayMap<String, Object> user = new ObservableArrayMap<>(); user.put("firstName", "Google"); user.put("lastName", "Inc."); user.put("age", 17);在layout布局文件中，可以通過String鍵訪問map：

<data><import type="android.databinding.ObservableMap"/><variable name="user" type="ObservableMap<String, Object>"/> </data> … <TextViewandroid:text='@{user["lastName"]}'android:layout_width="wrap_content"android:layout_height="wrap_content"/> <TextViewandroid:text='@{String.valueOf(1 + (Integer)user["age"])}'android:layout_width="wrap_content"android:layout_height="wrap_content"/>ObservableArrayList?用于key是整數(shù)的情況，類似于java中的List：

ObservableArrayList<Object> user = new ObservableArrayList<>(); user.add("Google"); user.add("Inc."); user.add(17);在layout布局文件中，通過索引訪問list：
<data><import type="android.databinding.ObservableList"/><import type="com.example.my.app.Fields"/><variable name="user" type="ObservableList&lt;Object>"/> </data> … <TextViewandroid:text='@{user[Fields.LAST_NAME]}'android:layout_width="wrap_content"android:layout_height="wrap_content"/> <TextViewandroid:text='@{String.valueOf(1 + (Integer)user[Fields.AGE])}'android:layout_width="wrap_content"android:layout_height="wrap_content"/>

生成Binding類

生成的綁定文件指向了布局中的變量與視圖。就如前面所講的一樣，生成的綁定類可以自定義名稱和包名。所有生成的綁定類都擴展自ViewDataBinding。

創(chuàng)建(Creating)

應該在inflation之后創(chuàng)建，以確保在布局中與表達式的視圖結(jié)合之前不干擾視圖層次結(jié)構(gòu)。有幾個方法可以綁定到布局。最常用的是使用綁定類的靜態(tài)方法。從加載View層次結(jié)構(gòu)到綁定只需要一步?？梢酝ㄟ^只需要一個LayoutInflater的方式綁定，也可以再傳遞ViewGroup的方式：

MyLayoutBinding binding = MyLayoutBinding.inflate(layoutInflater); MyLayoutBinding binding = MyLayoutBinding.inflate(layoutInflater, viewGroup, false);如果布局是使用不同的結(jié)構(gòu)，它可能是單獨的：
MyLayoutBinding binding = MyLayoutBinding.bind(viewRoot);有時候不能提前知道綁定類，這種情況下，可以通過?DataBindingUtil?類來進行獲取綁定：
ViewDataBinding binding = DataBindingUtil.inflate(LayoutInflater, layoutId,parent, attachToParent); ViewDataBinding binding = DataBindingUtil.bindTo(viewRoot, layoutId);

帶id的View

Data Binding對于每一個布局文件中帶id的View都會生成一個public final 的 View字段。Binding只是在頁面層次結(jié)構(gòu)上做簡單的傳遞，提取帶id的View。這種機制在某些情況下比傳統(tǒng)的findViewById要快，例如：

<layout xmlns:android="http://schemas.android.com/apk/res/android"><data><variable name="user" type="com.example.User"/></data><LinearLayoutandroid:orientation="vertical"android:layout_width="match_parent"android:layout_height="match_parent"><TextView android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@{user.firstName}"<span style="white-space:pre"> </span> android:id="@+id/firstName"/><TextView android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@{user.lastName}"<span style="white-space:pre"> </span> android:id="@+id/lastName"/></LinearLayout> </layout>生成的綁定類如下：

public final TextView firstName; public final TextView lastName;對于Data Binding并不是完全沒有必要再去獲取一個View實例，再某些時候也需要去訪問View。

Variables

對于每一個Variable(變量)都有一個訪問方法：

<data><import type="android.graphics.drawable.Drawable"/><variable name="user" type="com.example.User"/><variable name="image" type="Drawable"/><variable name="note" type="String"/> </data>在綁定類中都將生成getter和setter方法：

public abstract com.example.User getUser(); public abstract void setUser(com.example.User user); public abstract Drawable getImage(); public abstract void setImage(Drawable image); public abstract String getNote(); public abstract void setNote(String note);

ViewStubs

ViewStub?跟普通的視圖有一些不同。他們開始時并不是可見的，當明確要顯示或被載入時，通過加載另一個布局文件來替換自己。

因為ViewStub基本是隱藏的，所以在Data Binding中，ViewStub也是隱藏的。在Data Binding中，當ViewStub被加載完成后，一個ViewStub將被轉(zhuǎn)換為一個ViewStubProxy，供開發(fā)者訪問ViewStub。

當加載另一個文件的時候，必須建立新的布局。因此，ViewStubProxy 必須監(jiān)聽 ViewStub的?ViewStub.OnInflateListener?事件。由于只有一個視圖存在，這ViewStubProxy允許開發(fā)人員建立一個onInflateListener監(jiān)聽它。

<layout xmlns:android="http://schemas.android.com/apk/res/android"><LinearLayout...><ViewStubandroid:id="@+id/view_stub"android:layout="@layout/view_stub"... /></LinearLayout> </layout>布局文件中添加一個i ViewStub 并且添加id屬性。

binding = DataBindingUtil.setContentView(this, R.layout.activity_view_stub); binding.viewStub.setOnInflateListener(new ViewStub.OnInflateListener() {@Overridepublic void onInflate(ViewStub stub, View inflated) {ViewStubBinding binding = DataBindingUtil.bind(inflated);User user = new User("fee", "lang");binding.setUser(user);} });在 Java 代碼中獲取?binding?實例，為?ViewStubProy?注冊?ViewStub.OnInflateListener?事件。

高級Binding(Binding進階)(Advanced Binding)

動態(tài)變量(Dynamic Variables)

有時候，并不知道明確的綁定類。例如：RecyclerView.Adapter對于layout布局的操作并不知道具體的綁定類，它仍然需要在onBindViewHolder(VH, int)中綁定值。

在下面這個例子中，RecyclerView綁定的所有的布局文件中，都有一個 'item' 的變量。BindingHolder有一個getBinding方法返回ViewDataBinding實例.

public void onBindViewHolder(BindingHolder holder, int position) {final T item = mItems.get(position);holder.getBinding().setVariable(BR.item, item);holder.getBinding().executePendingBindings(); }

立即綁定(Immediate Binding)

當一個變量或Observable變化時，該綁定將在下一幀之前更改。然而有時候，當想要立即綁定更改的時候，可以調(diào)用?executePendingBindings()強制執(zhí)行。

后臺線程(Background Thread)

你可以在后臺線程中改變你的數(shù)據(jù)模型，只要它不是集合。數(shù)據(jù)綁定將本地化每個變量(Variable)/字段(Field)，同時進行評估，以避免任何并發(fā)問題。

屬性設(shè)置(Attribute Setters)

每當一個綁定值的變化，Data Binding生成的綁定類一定會調(diào)用配置了綁定表達式的View相關(guān)屬性的setter方法。Data Binding框架有自定義設(shè)置值的方法。

Automatic Setters

對于一個屬性，Data Binding框架會嘗試去尋找相應的setter方法。與該屬性的namespace(命名空間)并不什么關(guān)系，僅僅與屬性本身名稱有關(guān)。例如：在TextView的?android:text配置了綁定表達式過后，框架會去尋找setText(String)方法。如果綁定表達式返回的值是int類型的，框架會尋找 setText(int) 方法。確保表達式返回正確的數(shù)據(jù)類型，如果需要的話可以使用數(shù)據(jù)類型轉(zhuǎn)換。注意：即使沒有屬性存在于給定的名稱，Data Binding也會正常運行。您可以很輕松的使用Data Binding框架為一些 setter 方法創(chuàng)建屬性。例如：對于 support v4包中的?DrawerLayout 并沒有任何的屬性，但是有很多的setter方法。您可以自動的去使用這些setter方法： <android.support.v4.widget.DrawerLayoutandroid:layout_width="wrap_content"android:layout_height="wrap_content"app:scrimColor="@{@color/scrim}"app:drawerListener="@{fragment.drawerListener}"/>

重命名Setter(Renamed Setters)

有一些屬性的setter方法并不能通過名稱來匹配。對于這些方法，屬性可以通過?BindingMethods注解來進行關(guān)聯(lián)。每一個用于重命名的方法都必須與一個包含 BindingMethods 注解的類相關(guān)聯(lián)。例如：對于android:tint屬性，與之相關(guān)聯(lián)的setter方法是setImageTintList(ColorStateList)并不是setTint。

@BindingMethods({@BindingMethod(type = "android.widget.ImageView",attribute = "android:tint",method = "setImageTintList"), })實際開發(fā)過程中，開發(fā)人員想要重命名這些屬性是不可能的，因為android底層的屬性都已經(jīng)被實現(xiàn)了。

自定義Setter方法(Custome Setters)

有一些屬性需要自定義綁定邏輯。例如：對于?android:paddingLeft?屬性,Data Binding并沒有配置setter方法。相反，setPadding(left, top, right, bottom)方法是存在的。一個靜態(tài)的綁定了BindingAdapter注解的方法允許開發(fā)者為一個屬性自定義一個調(diào)用的setter方法。

android的屬性已經(jīng)創(chuàng)建了BindingAdapter，例如：對于paddingLeft屬性：

@BindingAdapter("android:paddingLeft") public static void setPaddingLeft(View view, int padding) {view.setPadding(padding,view.getPaddingTop(),view.getPaddingRight(),view.getPaddingBottom()); }Data Binding適配器可以用于定制其它類型。例如，可以自定義loader方法用來在線程中加載圖片：

當有沖突時，開發(fā)人員創(chuàng)建的綁定適配器將重寫Data Binding的默認適配器。

您還可以創(chuàng)建接收多個參數(shù)的適配器。

@BindingAdapter({"bind:imageUrl", "bind:error"}) public static void loadImage(ImageView view, String url, Drawable error) {Picasso.with(view.getContext()).load(url).error(error).into(view); }<ImageView app:imageUrl=“@{venue.imageUrl}” <span style="white-space:pre"> </span>app:error=“@{@drawable/venueError}”/>對于一個ImageView，如果同時存在imageUrl和error并且imageUrl為String類型，error是drawable類型適配器將被調(diào)用：

• 自定義的命名空間(namespace)將忽略匹配
• 同時也可以為命名空間(namespace)編寫適配器

綁定適配器方法可以選擇在其處理程序中選擇舊值。一個操作舊值和新值的方法，首先應該有屬性的所有舊值，其次要有新值：

@BindingAdapter("android:paddingLeft") public static void setPaddingLeft(View view, int oldPadding, int newPadding) {if (oldPadding != newPadding) {view.setPadding(newPadding,view.getPaddingTop(),view.getPaddingRight(),view.getPaddingBottom());} }事件處理程序可以只使用一個接口(interface)或抽象類的抽象方法，例如：

@BindingAdapter("android:onLayoutChange") public static void setOnLayoutChangeListener(View view, View.OnLayoutChangeListener oldValue,View.OnLayoutChangeListener newValue) {if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {if (oldValue != null) {view.removeOnLayoutChangeListener(oldValue);}if (newValue != null) {view.addOnLayoutChangeListener(newValue);}} }當一個偵聽器有多種方法時，它必須被分割成多個偵聽器。例如：?View.OnAttachStateChangeListener?有兩個方法：onViewAttachedToWindow()?和?onViewDetachedFromWindow().然后，我們必須創(chuàng)建一個接口來區(qū)分它們的屬性和處理程序。@TargetApi(VERSION_CODES.HONEYCOMB_MR1) public interface OnViewDetachedFromWindow {void onViewDetachedFromWindow(View v); }@TargetApi(VERSION_CODES.HONEYCOMB_MR1) public interface OnViewAttachedToWindow {void onViewAttachedToWindow(View v); }因為改變一個偵聽器也會影響另一個，所以我們必須有三個不同的綁定適配器，一個用于每個屬性，一個是兩個，它們都應該被設(shè)置。
@BindingAdapter("android:onViewAttachedToWindow") public static void setListener(View view, OnViewAttachedToWindow attached) {setListener(view, null, attached); }@BindingAdapter("android:onViewDetachedFromWindow") public static void setListener(View view, OnViewDetachedFromWindow detached) {setListener(view, detached, null); }@BindingAdapter({"android:onViewDetachedFromWindow", "android:onViewAttachedToWindow"}) public static void setListener(View view, final OnViewDetachedFromWindow detach,final OnViewAttachedToWindow attach) {if (VERSION.SDK_INT >= VERSION_CODES.HONEYCOMB_MR1) {final OnAttachStateChangeListener newListener;if (detach == null && attach == null) {newListener = null;} else {newListener = new OnAttachStateChangeListener() {@Overridepublic void onViewAttachedToWindow(View v) {if (attach != null) {attach.onViewAttachedToWindow(v);}}@Overridepublic void onViewDetachedFromWindow(View v) {if (detach != null) {detach.onViewDetachedFromWindow(v);}}};}final OnAttachStateChangeListener oldListener = ListenerUtil.trackListener(view,newListener, R.id.onAttachStateChangeListener);if (oldListener != null) {view.removeOnAttachStateChangeListener(oldListener);}if (newListener != null) {view.addOnAttachStateChangeListener(newListener);}} }上面的例子是比正常的稍微復雜，視圖使用的是添加和刪除監(jiān)聽器的方式來替換View.OnAttachStateChangeListener的設(shè)置方法。android.databinding.adapters.ListenerUtil類幫助追蹤以前的監(jiān)聽器，因此，他們可能會在綁定適配器中刪除。
通過在OnViewDetachedFromWindow和OnViewAttachedToWindow接口上使用@TargetApi(VERSION_CODES.HONEYCOMB_MR1)，Data Binding生成的代碼知道監(jiān)聽器只有運行在Honeycomb MR1和更新的設(shè)備上才生成。相同的版本支持addOnAttachStateChangeListener(View.OnAttachStateChangeListener).

轉(zhuǎn)換(Converts)

對象轉(zhuǎn)換(Object Conversions)

當從數(shù)據(jù)表達式返回數(shù)據(jù)對象時，將從自動，重命名以及自定義的setter方法中進行選擇。數(shù)據(jù)對象將轉(zhuǎn)換為setter方法的參數(shù)類型。

這是為了方便使用 ObservableMap 來保存數(shù)據(jù)，例如：

<TextViewandroid:text='@{userMap["lastName"]}'android:layout_width="wrap_content"android:layout_height="wrap_content"/>userMap?返回的對象將被自動轉(zhuǎn)換為找到的text的setter方法setText(CharSequence)的參數(shù)的數(shù)據(jù)類型。當有關(guān)的參數(shù)可能產(chǎn)生類型混亂時，就需要開發(fā)人員在表達式中進行轉(zhuǎn)換。

自定義轉(zhuǎn)換(Custom Conversions)

有時候轉(zhuǎn)換為自動的在特定的類型之間。例如：當設(shè)置背景顏色時： <Viewandroid:background="@{isError ? @color/red : @color/white}"android:layout_width="wrap_content"android:layout_height="wrap_content"/>在這里設(shè)置背景需要的是Drawable，但是顏色color是一個integer(整型)的。每當一個Drawable返回的是整形(int)的時候，int應該被轉(zhuǎn)換為ColorDrawable類型。這個轉(zhuǎn)換是通過使用帶有BindingConversion注解的靜態(tài)方法完成的：
@BindingConversion public static ColorDrawable convertColorToDrawable(int color) {return new ColorDrawable(color); }注意，轉(zhuǎn)換只發(fā)生在setter級，所以它是不允許這樣的組合類型：
<Viewandroid:background="@{isError ? @drawable/error : @color/white}"android:layout_width="wrap_content"android:layout_height="wrap_content"/>

Android Studio 支持 Data Binding

Android Studio支持Data Binding的多種代碼編輯。例如，它支持以下功能的數(shù)據(jù)綁定表達式：

• 語法高亮

• 標記表達式語言的語法錯誤

• XML代碼實現(xiàn)

• 引用，包括導航（如導航到聲明）和快速文檔
  

• 注意：數(shù)組(集合)、泛型以及 Observable 類，在沒有錯誤的時候，也可能顯示錯誤。

預覽窗格顯示提供的數(shù)據(jù)綁定表達式的默認值。從以下布局的XML文件的元素實例摘錄，預覽窗格中顯示的默認文本值的占位符文本。

<TextView android:layout_width="wrap_content"android:layout_height="wrap_content"android:text="@{user.firstName, default=PLACEHOLDER}"/>

如果你需要你的項目的設(shè)計階段中顯示一個默認值，你也可以使用工具屬性來替換默認的表達式的值，詳細描述請看：?Designtime Layout Attributes。

總結(jié)

以上是生活随笔為你收集整理的Data Binding 指南的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。