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);
}
});
