事件绑定

Method References

事件可以被直接绑定到handler，类似于Activity中onClick可以被指派给一个方法。相比View#onClick的一个优势是，这个表达式会在编译时被处理，所以如果方法不存在或者签名不对，或编译错误。

Method References和Listener Bindings的一个主要区别是，前者的listener的真正实现是在data被绑定的时候，而不是事件被触发的时候。如果想在事件发生时评估表达式，请用listener binding。

分配event给handler，使用一个正常的binding表达式，它的值就是被调用的方法名。例如,if your data object has two methods:

public class MyHandlers {
    public void onClickFriend(View view) { ... }
}

binding表达式可以分配click listener到一个View：

<?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>
   <LinearLayout
       android: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="@{handlers::onClickFriend}"/>
   </LinearLayout>
</layout>

注意，表达式(expression)中的方法的签名(signature)必须和Listener Object中的方法的签名完全一致。

Listener Bindings

Listener Bindings使用更为灵活，跟Method References类似，但可以让你运行随意的data binding表达式。这里不介绍了。

Layout的细节

1. Imports

在data节点中这样添加引用：

<data>
    <import type="android.view.View"/>
</data>

这样，你可以在binding表达式中使用View了：

<TextView
   android:text="@{user.lastName}"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:visibility="@{user.isAdult ? View.VISIBLE : View.GONE}"/>

类名冲突的时候，可以取别名(alias):

<import type="android.view.View"/>
<import type="com.example.real.estate.View"
        alias="Vista"/>

variables和表达式的type references中都可以用引用的type：

<data>
    <import type="com.example.User"/>
    <import type="java.util.List"/>
    <variable name="user" type="User"/>
    <variable name="userList" type="List<User>"/>
 </data>

在表达式中引用静态field和方法的时候也能使用引用的type：

<data>
    <import type="com.example.MyStringUtils"/>
    <variable name="user" type="com.example.User"/>
</data>
…
<TextView
   android:text="@{MyStringUtils.capitalize(user.lastName)}"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"/>

跟Java中一样，java.lang.*这种类会被自动导入。

2. Variables

这里涉及到实现Observable或observable collection的问题，暂时调过。

3. 自定义Binding类名称

默认情况下会根据layout文件生成一个Binding类，放置在包名根目录下。
也可以通过在data节点加入路径和Binding类名来自定义：

<data class="com.example.ContactItem">
    ...
</data>

4. Includes

Variables may be passed into an included layout's binding from the containing layout by using the application namespace and the variable name in an attribute:
通过使用application namespace和variable name，可以把变量传递给一个被包含的layout里面。

<?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>
   <LinearLayout
       android: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 variable。
Data Binding不支持include merge 元素的直接child，下面这样是不行的：

<?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>

5. 表达式

通用特性：

• Mathematical + - / * %
• String concatenation +
• Logical && ||
• Binary & | ^
• Unary + - ! ~
• Shift >> >>> <<(移位 )
• Comparison == > < >= <=
• instanceof
• Grouping ()
• Literals - character, String, numeric, null
• Cast
• Method calls(方法调用)
• Field access
• Array access []
• Ternary operator(三元运算) ?:

e.g.

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

缺少的：

有些Java中能用的操作，在表达式函数中不能用：

• this
• super
• new
• Explicit generic invocatio

Null Coalescing 操作：

如果是null，选左边；不是，选右边

android:text="@{user.displayName ?? user.lastName}"

等价于：

android:text="@{user.displayName != null ? user.displayName : user.lastName}"

Property Reference：

使用这样的格式引用类的properties、fields、getters和ObservableFields：

android:text="@{user.lastName}"

避免 NullPointerException

Data Binding代码生成时会自动检查null，如果存在null，会为对象赋默认值。

集合

常见的有 arrays, lists, sparse lists, and maps；为了简便，可以使用[]来调用。

<data>
    <import type="android.util.SparseArray"/>
    <import type="java.util.Map"/>
    <import type="java.util.List"/>
    <variable name="list" type="List&lt;String&gt;"/>
    <variable name="sparse" type="SparseArray&lt;String&gt;"/>
    <variable name="map" type="Map&lt;String, String&gt;"/>
    <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"]}'

或者这样：

android:text="@{map[`firstName`}"
android:text="@{map['firstName']}"

资源

简单的例子：

android:padding="@{large? @dimen/largePadding : @dimen/smallPadding}"

6. Data 对象

任何POJO都可用于Data Binding。修改POJO不会导致UI更新。data binding真正的力量在于，让你的data objects对data changes有notify的能力。有三种数据变化通知机制：

• observable objects
• observable fields
• observable collections

更多请看：https://developer.android.com/topic/libraries/data-binding/index.html#listener_bindings