1.简介
- 介绍 :
DataBinding 是以声明的方式,将布局中组件与应用程序源数据绑定在一起的框架库。 - 作用:
1.将布局组件与源数据绑定,使源数据变化的同时布局组件及时同步更新。
2.减少Activity中View的定义(private View view)与初始化(findViewById),让Activity代码更专注于界面的逻辑更新。
3.可自定义适配器,实现扩展组件的属性功能。
4.可自定义事件,实现各种组件的事件触发功能。 - 特点:
1.使用简单,主要以声明的方式实现。
2.功能强大,可自定义适配器 & 事件 ,兼容各种界面逻辑需求。
2.使用说明
2.1 Lib引入
1)在 build.gradle 中添加以下代码:
dataBinding {
enabled = true
}
注:如果使在module里面使用databinding框架的话,在module与主项目的build.gradle都要添加上述代码
,不然允许会报 compileDebugJavaWithJavac
相关错误
2)需要在项目 gradle.properties 中添加以下代码:
android.databinding.enableV2=true
注:如果不加这句代码,会导致编译时,找不到databind框架自动生成的相关类。
2.2 布局绑定源数据
- 布局代码(R.layout.databinding):
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
// 声明界面需要绑定的源数据
<data>
<variable name="user" type="com.lhj.mvvm.test_mvvm20181.bean.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.name}"/>//关联源数据的属性
<TextView android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{user.sex}"/>//关联源数据的属性
</LinearLayout>
</layout>
- Bean 代码
public class User extends BaseObservable{
@Bindable
public String getName() {
return name;
}
@Bindable
public String getSex() {
return sex;
}
//...
}
源数据需要 继承BaseObservable & 对组件中应用属性的get()添加 @Bindable 注解。
- 界面代码:
public class ActivityDataBind extends AppCompatActivity {
private DatabindingBindingImpl binding;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//注释1
binding = DataBindingUtil.setContentView(this, R.layout.databinding);
//注释2
User user = new User();
user.setName("nihao");
user.setSex("male");
//注释3
binding.setUser(user);
}
}
注释1:DatabindingBindingImpl 由框架编译时生成,负责通知界面同步更新(命名方式:xml文件名 + BindingImpl);
注释2:DataBindingUtil 将布局文件与Activity关联 & 生成 DatabindingBindingImpl 实例;
注释3:通知界面更新;
2.3 组件事件绑定
- 组件事件绑定有 2 种方式:(一)事件直接绑定 (二)事件自定义参数绑定
- 布局代码:
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<data>
// 注释1
<variable name="adb" type="com.lhj.mvvm.test_mvvm20181.ActivityDataBind"/>
<variable name="bol" type="java.lang.Boolean"/>
</data>
<LinearLayout
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<Button
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:onClick="@{adb::onClickGetData}" // 注释2
// android:onClick="@{(view) -> adb.changeUi(view,bol)}" // 注释3
android:text="Button"/>
</LinearLayout>
</layout>
- 界面代码
public class ActivityDataBind extends AppCompatActivity {
private DatabindingBindingImpl binding;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
binding = DataBindingUtil.setContentView(this, R.layout.databinding);
// 注释4
binding.setAdb(this);
binding.setBol(true);
}
// 注释5
public void onClickGetData(View view) {
Log.e("linhaojian","onClickGetData");
}
// 注释6
public void changeUi(View view,Boolean ischange){
if (ischange) {
view.setVisibility(View.INVISIBLE);
} else {
view.setVisibility(View.VISIBLE);
}
}
}
注释1:声明需要使用的类;
注释2:将事件绑定声明类的方法;
注释3:将事件绑定声明类的自定义参数方法;
注释4:将声明的类初始化 & DatabindingBindingImpl 进行关联;
注释5:实现事件的方法;
注释6:实现事件自定义参数的方法;
2.4 绑定适配器(BindingAdapter)
绑定适配器:可以自定义扩展组件的属性 & 绑定数据,实现同步更新(例如:自定义View数据加载显示)。
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<data>
<variable name="user" type="com.lhj.mvvm.test_mvvm20181.bean.User"/>
</data>
<LinearLayout
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<MyTextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
// 注释1
app:test="@{user.name}"/>
</LinearLayout>
</layout>
public class ActivityDataBind extends AppCompatActivity {
private DatabindingBindingImpl binding;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
binding = DataBindingUtil.setContentView(this, R.layout.databinding);
//注释2
new Thread(){
@Override
public void run() {
try {
Thread.sleep(5000);
User user = new User();
user.setName("123");
binding.setUser(user);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
}.start();
}
// 注释3
@BindingAdapter(value = {"test"})
public static void testBindApdater(TextView textView,String name){
Log.e("linhaojian","name : "+name);
// ...do something
}
}
注释1:自定义组件属性test & 与User中name属性绑定;
注释2:开启一个延迟5秒的线程 & 执行数据更新的操作;
注释3:通过BindingAdapter注解配置自定义组件的属性 和 静态方法,该方法在该程序中会被执行 2 次,
第一次是界面加载时(name = null),因为user.name未被初始化和赋值;第二次是调用binding.setUser()时(name = 123);
3.与ViewModel配合使用
Databinding 配合ViewModel 使用,更能让JetPack框架体现极致,让开发者更方、便快捷的开发自己应用,减少过多的界面更新的逻辑代码。
ViewModelProviders.of(activity).get(AViewModel.class).getUserMutableLiveData().observeForever(new Observer<User>() {
@Override
public void onChanged(@Nullable final User user) {
// 根据数据库或者网络请求获取的数据,通过databinding界面更新
binding.setUser(user);
}
});
网友评论