Android DataBinding 从入门到进阶,android 路由实现
此外,在绑定表达式中会根据需要生成一个名为context
的特殊变量,context
的值是根 View 的getContext()
方法返回的Context
对象, context
变量会被具有该名称的显式变量声明所覆盖
Databinding 同样是支持在 Fragment 和 RecyclerView 中使用 。例如,可以看 Databinding 在 Fragment 中的使用
@Overridepublic 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();}
**以上实现数据绑定的方式,每当绑定的变量发生变化的时候,都需要重新向 ViewDataBinding 传递新的变量值才能刷新 UI 。接下来看如何实现自动刷新 UI **
二、单向数据绑定
实现数据变化自动驱动 UI 刷新的方式有三种:BaseObservable
、ObservableField
、ObservableCollection
BaseObservable
一个纯净的 ViewModel 类被更新后,并不会让 UI 自动更新。而数据绑定后,我们自然会希望数据变更后 UI 会即时刷新,Observable 就是为此而生的概念
BaseObservable 提供了 notifyChange() 和 notifyPropertyChanged() 两个方法,前者会刷新所有的值域,后者则只更新对应 BR 的 flag,该 BR 的生成通过注释 @Bindable 生成,可以通过 BR notify 特定属性关联的视图
/**
作者:叶应是叶
时间:2018/5/16 20:54
描述:*/public class Goods extends BaseObservable {
//如果是 public 修饰符,则可以直接在成员变量上方加上 @Bindable 注解 @Bindablepublic 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);}
@Bindablepublic 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() 方法中更新的是所有字段
添加两个按钮用于改变 goods 变量的三个属性值,由此可以看出两个 notify 方法的区别。当中涉及的按钮点击事件绑定,在下面也会讲到
<?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" /><variablename="goods"type="Goods" /><variablename="goodsHandler"type="GoodsHandler" /></data>
<LinearLayoutandroid: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>
/**
作者:叶应是叶
时间:2018/5/16 21:07
描述:*/public class Main3Activity extends AppCompatActivity {
private Goods goods;
private ActivityMain3Binding activityMain3Binding;
@Overrideprotected 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 视图的刷新没有同时刷新 price 视图,而 details 视图刷新的同时也刷新了 price 视图
实现了 Observable 接口的类允许注册一个监听器,当可观察对象的属性更改时就会通知这个监听器,此时就需要用到 OnPropertyChangedCallback
当中 propertyId
就用于标识特定的字段
goods.addOnPropertyChangedCallback(new Observable.OnPropertyChangedCallback() {@Overridepublic 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 类相对来说限制有点高,且也需要进行 notify 操作,因此为了简单起见可以选择使用 ObservableField。ObservableField 可以理解为官方对 BaseObservable 中字段的注解和刷新等操作的封装,官方原生提供了对基本数据类型的封装,例如 ObservableBoolean、ObservableByte、ObservableChar、ObservableShort、ObservableInt、ObservableLong、ObservableFloat、ObservableDouble 以及 ObservableParcelable ,也可通过 ObservableField 泛型来申明其他类型
/**
作者:叶应是叶
时间: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);}
}
对 ObservableGoods 属性值的改变都会立即触发 UI 刷新,概念上与 Observable 区别不大,具体效果可看下面提供的源代码,这里不再赘述
ObservableCollection
dataBinding 也提供了包装类用于替代原生的 List
和 Map
,分别是 ObservableList
和 ObservableMap
,当其包含的数据发生变化时,绑定的视图也会随之进行刷新
<?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"/><variablename="list"type="ObservableList<String>"/><variablename="map"type="ObservableMap<String,String>"/><variablename="index"type="int"/><variablename="key"type="String"/></data>
<LinearLayoutandroid: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···a
ndroid:onClick="onClick"android:text="改变数据"/>
</LinearLayout></layout>
private ObservableMap<String, String> map;
@Overrideprotected 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));}
三、双向数据绑定
双向绑定的意思即为当数据改变时同时使视图刷新,而视图改变时也可以同时改变数据
看以下例子,当 EditText 的输入内容改变时,会同时同步到变量 goods
,绑定变量的方式比单向绑定多了一个等号: 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"/><variablename="goods"type="ObservableGoods" /></data>
<LinearLayoutandroid: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 {
@Overrideprotected 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);}
}
四、事件绑定
严格意义上来说,事件绑定也是一种变量绑定,只不过设置的变量是回调接口而已 事件绑定可用于以下多种回调事件
android:onClick
android:onLongClick
android:afterTextChanged
android:onTextChanged
...
在 Activity 内部新建一个 UserPresenter 类来声明 onClick() 和 afterTextChanged() 事件相应的回调方法
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" /><variablename="userInfo"type="User" /><variablename="userPresenter"type="UserPresenter" /></data>
<LinearLayoutandroid: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>
方法引用的方式与调用函数的方式类似,既可以选择保持事件回调方法的签名一致:@{userPresenter.afterTextChanged},此时方法名可以不一样,但方法参数和返回值必须和原始的回调函数保持一致。也可以引用不遵循默认签名的函数:@{()->userPresenter.onUserNameClick(userInfo)},这里用到了 Lambda 表达式,这样就可以不遵循默认的方法签名,将userInfo
对象直接传回点击方法中。此外,也可以使用方法引用 :: 的形式来进行事件绑定
五、使用类方法
首先定义一个静态方法
public class StringUtils {
public static String toUpperCase(String str) {return str.toUpperCase();}
}
在 data 标签中导入该工具类
<import type="com.leavesc.databinding_demo.StringUtils" />
然后就可以像对待一般的函数一样来调用了
<TextViewandroid:layout_width="match_parent"android:layout_height="wrap_content"android:onClick="@{()->userPresenter.onUserNameClick(userInfo)}"android:text="@{StringUtils.toUpperCase(userInfo.name)}" />
六、运算符
基础运算符
DataBinding 支持在布局文件中使用以下运算符、表达式和关键字
算术 + - / * %
字符串合并 +
逻辑 && ||
二元 & | ^
一元 + - ! ~
移位 >> >>> <<
比较 == > < >= <=
Instanceof
Grouping ()
character, String, numeric, null
Cast
方法调用
Field 访问
Array 访问 []
三元 ?:
目前不支持以下操作
this
super
new
显示泛型调用
此外,DataBinding 还支持以下几种形式的调用
Null Coalescing
空合并运算符 ?? 会取第一个不为 null 的值作为返回值
<TextViewandroid:layout_width="match_parent"android:layout_height="wrap_content"android:text="@{user.name ?? user.password}" />
等价于
android:text="@{user.name != null ? user.name : user.password}"
属性控制
可以通过变量值来控制 View 的属性
<TextViewandroid:layout_width="match_parent"android:layout_height="wrap_content"android:text="可见性变化"android:visibility="@{user.male ? View.VISIBLE : View.GONE}" />
避免空指针异常
DataBinding 也会自动帮助我们避免空指针异常 例如,如果 "@{userInfo.password}" 中 userInfo 为 null 的话,userInfo.password 会被赋值为默认值 null,而不会抛出空指针异常
七、include 和 viewStub
include
对于 include 的布局文件,一样是支持通过 dataBinding 来进行数据绑定,此时一样需要在待 include 的布局中依然使用 layout 标签,声明需要使用到的变量
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" /><variablename="userInfo"type="User" /></data>
<android.support.constraint.ConstraintLayoutandroid:layout_width="match_parent"android:layout_height="wrap_content"android:background="#acc">
<TextViewandroid:layout_width="match_parent"android:layout_height="wrap_content"android:gravity="center"android:padding="20dp"android:text="@{userInfo.name}" />
</android.support.constraint.ConstraintLayout></layout>
在主布局文件中将相应的变量传递给 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"xmlns:tools="http://schemas.android.com/tools">
<data><import type="com.leavesc.databinding_demo.model.User" /><variablename="userInfo"type="User" /></data>
<LinearLayoutandroid:layout_width="match_parent"android:layout_height="match_parent"android:orientation="vertical"tools:context=".Main6Activity">
<includelayout="@layout/view_include"bind:userInfo="@{userInfo}" />
</LinearLayout></layout>
viewStub
dataBinding 一样支持 ViewStub 布局
在布局文件中引用 viewStub 布局
<ViewStubandroid:id="@+id/view_stub"android:layout_width="match_parent"android:layout_height="wrap_content"android:layout="@layout/view_stub"/>
获取到 ViewStub 对象,由此就可以来控制 ViewStub 的可见性
ActivityMain6Binding activityMain6Binding = DataBindingUtil.setContentView(this, R.layout.activity_main6);View view = activityMain6Binding.viewStub.getViewStub().inflate();
如果需要为 ViewStub 绑定变量值,则 ViewStub 文件一样要使用 layout 标签进行布局,主布局文件使用自定义的 bind 命名空间将变量传递给 ViewStub
<ViewStubandroid:id="@+id/view_stub"android:layout_width="match_parent"android:layout_height="wrap_content"android:layout="@layout/view_stub"bind:userInfo="@{userInfo}" />
如果在 xml 中没有使用 bind:userInfo="@{userInf}"
对 ViewStub 进行数据绑定,则可以等到当 ViewStub Inflate 时再绑定变量,此时需要为 ViewStub 设置 setOnInflateListener
回调函数,在回调函数中进行数据绑定
activityMain6Binding.viewStub.setOnInflateListener(new ViewStub.OnInflateListener() {@Overridepublic void onInflate(ViewStub stub, View inflated) {
评论