Android Jetpack - DataBinding 介绍

2018-12-28 本文已影响222人 Linhaojian

Jetpack.jpg

1.前言

2018年谷歌I/O 发布了一系列辅助android开发者的实用工具，合称 Jetpack ，以帮助开发者构建出色的 Android 应用。
Jetpack 包含4个部分的组件：Architecture、Foundation、Behavior 以及 UI 。
今天为大家介绍的是 Architecture 中 Room。
文章中实例 linhaojian的Github

2.简介

介绍：
DataBinding 是以声明的方式，将布局中组件与应用程序源数据绑定在一起的框架库。
作用：
1.将布局组件与源数据绑定，使源数据变化的同时布局组件及时同步更新。
2.减少Activity中View的定义(private View view)与初始化(findViewById)，让Activity代码更专注于界面的逻辑更新。
3.可自定义适配器，实现扩展组件的属性功能。
4.可自定义事件，实现各种组件的事件触发功能。
特点：
1.使用简单，主要以声明的方式实现。
2.功能强大，可自定义适配器 & 事件，兼容各种界面逻辑需求。

3.使用说明

3.1 Lib引入

1）在 build.gradle 中添加以下代码：

    dataBinding {
        enabled = true
    }

注：如果使在module里面使用databinding框架的话，在module与主项目的build.gradle都要添加上述代码
，不然允许会报 compileDebugJavaWithJavac 相关错误
2）需要在项目 gradle.properties 中添加以下代码：

android.databinding.enableV2=true

注：如果不加这句代码，会导致编译时，找不到databind框架自动生成的相关类。

3.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 {
    // 1
    private DatabindingBindingImpl binding;
    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 2
        binding = DataBindingUtil.setContentView(this, R.layout.databinding);
        User user = new User();
        user.setName("linhaojian");
        user.setSex("male");
        // 3
        binding.setUser(user);
    }
}

注释1：DatabindingBindingImpl 由框架编译时生成，负责通知界面同步更新(命名方式：xml文件名 + BindingImpl)；
注释2：DataBindingUtil 将布局文件与Activity关联 & 生成 DatabindingBindingImpl 实例；
注释3：通知界面更新；

3.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);
        // 3-1 
        binding.setAdb(this);
        binding.setBol(true);
    }
    // 2-1
    public void onClickGetData(View view) {
        Log.e("linhaojian","onClickGetData");
    }
    // 3-2
    public void changeUi(View view,Boolean ischange){
        if (ischange) {
            view.setVisibility(View.INVISIBLE);
        } else {
            view.setVisibility(View.VISIBLE);
        }
    }
}

注释1：声明需要使用的类；
注释2：将事件绑定声明类的方法；
注释2-1：实现事件的方法；
注释3：将事件绑定声明类的自定义参数方法；
注释3-1：将声明的类初始化 & DatabindingBindingImpl 进行关联；
注释3-2：实现事件自定义参数的方法；

3.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)；

4.与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);
            }
        });

6.总结

到此，DataBinding就介绍完成了。后续我会进行分享Jetpack更多其他内容。
如果喜欢我的分享，可以点击关注或者赞，你们支持是我分享的最大动力。
linhaojian的Github

欢迎关注linhaojian_CSDN博客或者linhaojian_简书！

不定期分享关于安卓开发的干货。

写技术文章初心

技术知识积累

技术知识巩固

技术知识分享

技术知识交流