Android DataBinding ——事件处理

DataBinding允许您编写表达式去处理从View分发的事件。例如onClick()方法。事件属性名称由监听器方法的名称确定，但有少数例外。例如，View.OnClickListener有一个方法onClick()，因此此事件绑定的属性为android:onClick。 有一些专门的点击事件处理者（注：它们也接受View.OnClickListener参数）需要使用android:onClick以外的属性来避免冲突。您可以使用以下属性来避免这些类型的冲突：

您可以使用以下机制来处理事件：

• 方法引用：在表达式中，可以引用符合监听器方法签名的方法。当表达式计算为方法引用时，DataBinding将方法引用和所有者对象封装到一个监听听器中，并设置到该View上。如果表达式的计算结果为null，则DataBinding不会创建监听器，该View这个属性的监听器为null。
• 监听器绑定：这些是在事件发生时计算的lambda表达式。DataBinding总是创建一个监听器，并设置到这个View。当事件被分发时，监听器将计算lambda表达式。

1. 方法引用

事件可以直接绑定到处理方法上，类似于android:onClick可以分发到Activity中的方法。与View的onClick属性相比，一个主要优点是表达式在编译时处理，因此，如果该方法不存在或其签名不正确，则会收到编译时错误。 方法引用和监听器绑定之间的主要区别在于，实际的监听器实现是在绑定数据时创建的，而不是在触发事件时创建的。如果希望在事件发生时对表达式求值，则应使用监听器绑定。 若要将事件分配给其处理程序，请使用普通绑定表达式，该值为要调用的方法名。例如，考虑以下布局数据对象示例：

class MyHandlers {
    fun onClickFriend(view: View) { ... }
}

绑定表达式可以将视图的单击监听器分发给onClickFriend（）方法，如下所示：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
   <data>
       <variable name="handlers" type="com.example.MyHandlers"/>
       <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>

注释：这里表达式里是直接引用的函数。这个函数的签名要和onClickListener的onClick的签名一样

2. 监听者绑定

监听者绑定是在事件发生时运行的绑定表达式。它们类似于方法引用，但允许您运行任意的数据绑定表达式。此功能可与Gradle 2.0及更高版本的Android Gradle插件一起使用。 在方法引用中，方法的参数必须与事件监听者的参数匹配。在监听者绑定中，只要返回值必须与监听者的预期返回值匹配（除非它预期为void）即可。例如，考虑以下具有onSaveClick() 方法示例：

class Presenter {
    fun onSaveClick(task: Task){}
}

然后，您可以将click事件绑定到onSaveClick() 方法，如下所示：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <data>
        <variable name="task" type="com.android.example.Task" />
        <variable name="presenter" type="com.android.example.Presenter" />
    </data>
    <LinearLayout android:layout_width="match_parent" android:layout_height="match_parent">
        <Button android:layout_width="wrap_content" android:layout_height="wrap_content"
        android:onClick="@{() -> presenter.onSaveClick(task)}" />
    </LinearLayout>
</layout>

在表达式中使用回调时，DataBinding会自动创建必要的监听者并为事件注册它。当视图激发事件时，DataBinding将计算给定的表达式。与正则绑定表达式一样，在评估这些监听者表达式时，您仍然可以获得DataBinding的空安全和线程安全性。 在上面的例子中，我们还没有定义传递给onClick（view）的视图参数。监听者绑定为监听者参数提供了两种选择：可以忽略方法的所有参数，也可以命名所有参数。如果您喜欢命名参数，可以在表达式中使用它们。例如，上面的表达式可以写如下：

android:onClick="@{(view) -> presenter.onSaveClick(task)}"

或者，如果您想在表达式中使用参数，它可以按如下方式工作：

class Presenter {
    fun onSaveClick(view: View, task: Task){}
}

android:onClick="@{(theView) -> presenter.onSaveClick(theView, task)}"

可以将lambda表达式与多个参数一起使用：

class Presenter {
    fun onCompletedChanged(task: Task, completed: Boolean){}
}

<CheckBox android:layout_width="wrap_content" android:layout_height="wrap_content"
      android:onCheckedChanged="@{(cb, isChecked) -> presenter.completeChanged(task, isChecked)}" />

如果正在监听的事件返回的值的类型不是void，则表达式也必须返回相同类型的值。例如，如果要监听长按事件，则表达式应返回布尔值。

class Presenter {
    fun onLongClick(view: View, task: Task): Boolean { }
}

android:onLongClick="@{(theView) -> presenter.onLongClick(theView, task)}"

如果由于null对象而无法计算表达式，则数据绑定将返回该类型的默认值。例如，引用类型返回null，int返回0，boolean返回false等。 如果需要将表达式与谓词一起使用（例如，三元），可以使用void作为一个符号值。

android:onClick="@{(v) -> v.isVisible() ? doSomething() : void}"

3. 避免复杂的监听者

监听者表达式非常强大，可以使代码非常易于阅读。另一方面，包含复杂表达式的监听者会使布局难以阅读和维护。这些表达式应该像将可用数据从UI传递到回调方法一样简单。您应该在监听者表达式调用的回调方法中实现任何业务逻辑。（注：业务逻辑都写到ViewModel的一个入口函数，databing绑定那个函数即可）