Android DataBinding ——事件处理

DataBinding允许您编写表达式去处理从View分发的事件。例如onClick()方法。事件属性名称由监听器方法的名称确定,但有少数例外。例如,View.OnClickListener有一个方法onClick(),因此此事件绑定的属性为android:onClick。

有一些专门的点击事件处理者(注:它们也接受View.OnClickListener参数)需要使用android:onClick以外的属性来避免冲突。您可以使用以下属性来避免这些类型的冲突:

Class Listener setter Attribute
SearchView setOnSearchClickListener(View.OnClickListener) android:onSearchClick
ZoomControls setOnZoomInClickListener(View.OnClickListener) android:onZoomIn
ZoomControls setOnZoomOutClickListener(View.OnClickListener) android:onZoomOut

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

  • 方法引用:在表达式中,可以引用符合监听器方法签名的方法。当表达式计算为方法引用时,DataBinding将方法引用和所有者对象封装到一个监听听器中,并设置到该View上。如果表达式的计算结果为null,则DataBinding不会创建监听器,该View这个属性的监听器为null。

  • 监听器绑定:这些是在事件发生时计算的lambda表达式。DataBinding总是创建一个监听器,并设置到这个View。当事件被分发时,监听器将计算lambda表达式。

1. 方法引用

事件可以直接绑定到处理方法上,类似于android:onClick可以分发到Activity中的方法。与View的onClick属性相比,一个主要优点是表达式在编译时处理,因此,如果该方法不存在或其签名不正确,则会收到编译时错误。

方法引用和监听器绑定之间的主要区别在于,实际的监听器实现是在绑定数据时创建的,而不是在触发事件时创建的。如果希望在事件发生时对表达式求值,则应使用监听器绑定。

若要将事件分配给其处理程序,请使用普通绑定表达式,该值为要调用的方法名。例如,考虑以下布局数据对象示例:

java 复制代码
class MyHandlers {
    fun onClickFriend(view: View) { ... }
}

绑定表达式可以将视图的单击监听器分发给onClickFriend()方法,如下所示:

xml 复制代码
<?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() 方法示例:

java 复制代码
class Presenter {
    fun onSaveClick(task: Task){}
}

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

xml 复制代码
<?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)的视图参数。监听者绑定为监听者参数提供了两种选择:可以忽略方法的所有参数,也可以命名所有参数。如果您喜欢命名参数,可以在表达式中使用它们。例如,上面的表达式可以写如下:

java 复制代码
android:onClick="@{(view) -> presenter.onSaveClick(task)}"

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

java 复制代码
class Presenter {
    fun onSaveClick(view: View, task: Task){}
}
java 复制代码
android:onClick="@{(theView) -> presenter.onSaveClick(theView, task)}"

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

java 复制代码
class Presenter {
    fun onCompletedChanged(task: Task, completed: Boolean){}
}
java 复制代码
<CheckBox android:layout_width="wrap_content" android:layout_height="wrap_content"
      android:onCheckedChanged="@{(cb, isChecked) -> presenter.completeChanged(task, isChecked)}" />

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

java 复制代码
class Presenter {
    fun onLongClick(view: View, task: Task): Boolean { }
}
java 复制代码
android:onLongClick="@{(theView) -> presenter.onLongClick(theView, task)}"

如果由于null对象而无法计算表达式,则数据绑定将返回该类型的默认值。例如,引用类型返回null,int返回0,boolean返回false等。

如果需要将表达式与谓词一起使用(例如,三元),可以使用void作为一个符号值。

java 复制代码
android:onClick="@{(v) -> v.isVisible() ? doSomething() : void}"

3. 避免复杂的监听者

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

👀关注公众号:Android老皮!!!欢迎大家来找我探讨交流👀

相关推荐
有位神秘人10 分钟前
Android获取设备中本地音频
android·音视频
JMchen12313 分钟前
Android网络安全实战:从HTTPS到双向认证
android·经验分享·网络协议·安全·web安全·https·kotlin
CS创新实验室15 分钟前
Pandas 3 的新功能
android·ide·pandas
ujainu26 分钟前
护眼又美观:Flutter + OpenHarmony 鸿蒙记事本一键切换夜间模式(四)
android·flutter·harmonyos
三少爷的鞋38 分钟前
为什么我不在 Android ViewModel 中直接处理异常?
android
草莓熊Lotso2 小时前
Linux 文件描述符与重定向实战:从原理到 minishell 实现
android·linux·运维·服务器·数据库·c++·人工智能
恋猫de小郭2 小时前
Flutter Zero 是什么?它的出现有什么意义?为什么你需要了解下?
android·前端·flutter
工程师老罗8 小时前
如何在Android工程中配置NDK版本
android
Libraeking12 小时前
破壁行动:在旧项目中丝滑嵌入 Compose(混合开发实战)
android·经验分享·android jetpack
市场部需要一个软件开发岗位12 小时前
JAVA开发常见安全问题:Cookie 中明文存储用户名、密码
android·java·安全