Data Binding Library (数据绑定库)简介和使用

本来想把DataBindingLibrary理解完滴，但是由于初学这个，有的也不是很清楚，没有理解的地方，也就是将官网给翻译了一下，高手勿喷。

Data Binding Library是一个系统支持库，使用声明式布局，并尽量减少绑定应用程序逻辑和布局的中间代码，可以在Android 2.1 （API级别7+）之后的所有android平台使用它；要使用数据绑定功能，Gradle版本插件必须是1.5.0-alpha1或更高的版本；

使用配置环境：
在module的build.gradle中配置下列代码：

android {
    .....
    .....
    dataBinding{
      enabled = true 
    }
}
如果应用依赖的使用DataBindingLibrary的库，则程序模块也必须进行上面的配置

简单使用

1、定义布局：

根元素使用layout标签，data为数据元素，后面再跟布局元素，data中的变量variable描述了一个可能在布局中使用的属性，布局表达式中使用 @{} 语法写入属性参数中，如android:text="@{user.firstName}"
2、定义User对象：

一种情况的User：
package com.sl.databindingdemo.bean;
public class User {
   public final String firstName;
   public final String lastName;
   public User(String firstName, String lastName) {
       this.firstName = firstName;
       this.lastName = lastName;
   }
}

第二种情况的User
package com.sl.databindingdemo.bean;
public class User {
    private String firstName ;
    private String lastName ;

    public User(String firstName, String lastName) {
        this.firstName = firstName;
        this.lastName = lastName;
    }

    public String getFirstName() {
        return firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    public String getLastName() {
        return lastName;
    }

    public void setLastName(String lastName) {
        this.lastName = lastName;
    }
}

从数据绑定的角度看，这两个类是等价的。用于TextView的android：text属性的“@{user.firstName}”表达式将访问前一个类中的firstName字段和后一个类中的getFirstName（）方法，或者，如果firstName（）方法存在，也将被解析；
3、数据绑定

   @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ActivityMainBinding binding = DataBindingUtil.setContentView(this,R.layout.activity_main);
        User user = new User("Test","User");
        binding.setUser(user);
    }

---

表达式语言

共同特征
表达式语言看起来像Java中的表达式，可以在表达式语言中使用一下的操作符合关键字：

• 数学上的：+ - * / % (加减乘除余)
• 字符串连接 ： +
• 逻辑 && ||
• 二进制 & | ^
• 一元 + - ！~
• 位运算 >> >>> <<
• 比较 == > < >= <=
• instanceof
• 分组 ()
• 文字：字符、字符串、数字、null
• 强转
• 方法调用
• 字段访问
• 数组访问 []
• 三元操作符 ？：
  例：

缺少的操作

有些你在Java中能使用的表达式语法子这里会缺少下面的一些操作符:

• this
• super
• new
• 明确的泛型调用

空合并运算符

空合并操作符 （？？）:如果左操作数不为空，则选择左操作数;如果右操作数为空，则选择右操作数

android:text="@{user.displayName ?? user.lastName}"

在功能上等同于：

android:text= "@{user.displayName != null ? user.displayName : user.lastName}"

属性引用

表达式可以使用以下格式引用类中的属性，这对于字段、getter和ObservableField对象是一样的

android：text= "@{user.lastName}"

避免空指针异常

生成的数据绑定代码自动检查空值，并避免空指针异常。例如，在表达式@{user.name}中，如果user为空，则为user.name分配其默认值null。如果你引用用户。age，其中age类型为int，然后数据绑定使用默认值0。

集合

常见的集合：数组，列表，稀疏列表（sparse lists），和映射集合（map），为了方便访问可以使用[]操作符编译，在编译时variable中不支持“<>”时，需要使用转义的符号：< >,转义字符对照表可查看：http://tool.oschina.net/commons?type=2

    
    
    
    
    
    
    
    

…
android:text="@{list[index]}"
…
android:text="@{sparse[index]}"
…
android:text="@{map[key]}"

注意：您还可以使用 Object.key ,例上面的@{map[key]}可以替换为@{map.key}

字符串文字

你可以使用单引号包围属性值，这样可以在表达式之内使用双引号，例：

android:text= '@{map["firstName"]}'

也可以使用双引号包围属性值，但是里面的表达式的需使用单引号，例：

android:text = "@{map['firstName']"

资源（Resources）

可以使用一下语法访问表达式中的资源：

android：padding="@{large? @dimen/largePadding : @dimen/smallPadding}"

可以通过提供参数来计算格式化字符串和复数

%s, %s

android:text="@{@string/nameFormat(firstName, lastName)}"

当一个复数有多个参数时，应该传递所有的参数：

 Have an orange
 Have %d oranges

android:text="@{@plurals/orange(orangeCount, orangeCount)}"

有些类型需要显示的类型计算，例如下表：

类型	正常引用	表达式引用
String[]	@array	@stringArray
int[]	@array	@intArray
TypedArray	@array	@typedArray
Animator	@animator	@animator
StateListAnimator	@animator	@stateListAnimator
color int	@color	@color
ColorStateList	@color	@colorStateList

---

方法引用

事件可以直接绑定到处理方法，类似在xml布局中是调用的android：onClick可以分配给Activity中的方法一样。与View#onClick属性相比，一个主要的优点是表达式在编译时被处理，所以如果方法不存在或者他的签名不正确，会收到错误的编译信息；
方法引用和监听绑定器的主要区别在于实际的监听器实现是在绑定数据时创建的，而不是在事件触发时创建的 ；
要将事件分配给其处理程序，使用常规的绑定表达式，其值是要调用的方法名称。例如：数据的对象有两个方法：

package com.sl.databindingdemo.method;
import android.util.Log;
import android.view.View;
public class MyHandles {
    public void onClickFriend(View view){
        Log.e("MyHandles","我被点了");
    }
}

    
        
        
    
    
          //---> 注意为 handles：：onClickFriend绑定方法
    

在程序中也需要将对象绑定给布局

ActivityMainBinding binding = DataBindingUtil.setContentView(this,R.layout.activity_main);
        final User user = new User("Test","User");
        binding.setUser(user);
        binding.setHandlers(new MyHandles());

注意：表达式中的方法的签名必须与监听器中的对象的方法的签名完全匹配

---

监听器绑定

监听器绑定是事件发生时运行的绑定表达式。他类似于方法引用，但是他们允许您运行任意数据的绑定表达式；在方法引用中，方法的参数必须与事件监听器的参数匹配。在监听器绑定中，只有你的返回值比需与监听器的期望返回值相匹配（除非预期为Void）；例：

package com.sl.databindingdemo.method;
import android.util.Log;
import com.sl.databindingdemo.bean.User;
public class Presenter {
    public void onSaveClick(User user){
        Log.e("监听器绑定", "onSaveClick:" );
    }
}

ActivityMainBinding binding = DataBindingUtil.setContentView(this,R.layout.activity_main);
        final User user = new User("Test","User");
        binding.setUser(user);
        binding.setPresenter(new Presenter());

监听器由仅允许作为表达式的根元素的lambda表达式表示。在表达式中使用回调函数时，数据绑定会自动为事件创建必要的监听器和注册表。当视图触发事件时，数据绑定将计算给定的表达式，就像常规的绑定表达式一样，当这些监听器表达式被计算时，你仍然可以获得null和数据绑定的线程安全性；
上面的表达式可以写成：

android:onClick="@{ (view)->presenter.onSaveClick(user)}"

如果想使用表达式中的参数，他也可以按如下方式工作：

android:onClick="@{ (theView) -> presenter.onSaveClick(theView,user)}"

public class Presenter {
    public void onSaveClick(View view,User user){
        Log.e("监听器绑定",((TextView)view).getText().toString());
        Log.e("监听器绑定", "onSaveClick:" );
    }
}

也可以使用多个参数的lambda表达式:

public class Presenter {
    private static final String TAG = "Presenter";
    public void onCompletedChanged(User user,boolean isChecked){
        Log.e(TAG, "onCompletedChanged: "+ user.getFirstName() + "  " + user.getLastName() );
        Log.e(TAG, "onCompletedChanged: " + isChecked);
    }
}

//布局


    
        
        
    
    
        
        
    


 ActivityMainBinding binding = DataBindingUtil.setContentView(this,R.layout.activity_main);
        final User user = new User("Test","User");
        binding.setUser(user);
        binding.setPresenter(new Presenter());

如果正在监听的事件返回一个其类型不是void，则表达式必须返回相同类型的值。如长按事件,返回值为boolean：

public class Presenter {
    private static final String TAG = "Presenter";
    public boolean onLongClick(View view,User user){
        Log.e(TAG, "onLongClick" );
        return false ;
    }
}

android:onLongClick="@{(theView)->presenter.onLongClick(theView,user)}"

如果由于null对象导致无法计算表达式，数据绑定将返回该类型的默认Java值，如null用于引用类型，0用于int类型；
如果需要使用谓词（例如三元表达式），则可以将void用作符号：

android:onClick="@{(v) -> v.isVisible() ? doSomething() : void}"

---

布局细节

导入

• import元素中可以使用零个或多个data元素，这些就想是在Java中一样可以轻松的引用布局中的类。

使用View

当类名有冲突时，应该为其中一个重命名一个别名：alias：例

• 导入的类型可以用作变量和表达式的类型引用，下面示例显示了用作变量类型的User和List：

注意：Android studio 还不能处理导入，所以导入变量的自动补全可能无法子啊IDE中工作。您的应用程序仍然在编译，您可以通过在变量定义中使用完全限定名来解决IDE的问题；

• 当在表达式中应用静态字段和方法时，也可以使用导入的类型：

public class MyStringUtils {
    public static  String capitalize(String str){
        return "想咋咋滴" ;
    }
}


    
    

Variables(变量)

你可以在data元素中使用多个的Variable(变量）元素，每个variable元素描述一个属性，该属性可以设置在布局上，用于布局文件中的绑定表达式；下面的实例声明user、image、和note变量：

变量类型会在编译时进行检查，因此，如果以个变量实现了 Observable 或者是一个 Observable集合，那么应该在类型中反映出来，如果变量没有实现可观察接口的基类或接口，则不会观察到变量；
当多样化的配置（如横向、纵向）有不同的布局文件时，变量就会组合在一起，这些布局文件之间不应该有冲突的变量定义；
生成的绑定类为每个描述的变量都有一个setter和getter，变量接受最初的默认值直到setter被调用，引用被称为null类型，0为int，false为boolean值等；
一个特殊的变量名 context 生成用于绑定表达式，context的值是根据根视图getContext（）方法获取的Context对象，context变量被具有该名称的此案是变量声明覆盖。

Includes

通过使用应用程序名称控件和属性中的变量名，可以将变量从包含的布局的布局中传递到includ布局的绑定中；

这里在name.xml和contact.xml布局中都必须有一个user变量
数据绑定不支持将include作为merge元素的直接子元素。例如，不支持以下布局:

---

---

---

---

使用 Observable 数据对象

任何的普通的Java对象都可以用于数据绑定，但是修改对象不会自动导致UI更行。数据绑定可用于让数据对象能够在数据更改时通知其他对象（称为侦听器）。有三中不同类型的数据更改通知机制：Observable 对象，Observable 字段，Observable 集合；
当这些Observable数据对象绑定到UI且数据对象属性进行更改时，UI也将被自动更新；

Observable Field

创建实现Observable接口的类，如果这个类只有一些属性，那么这个实现就有点多余了，可以是使用泛型 Observable类和以下特定原始的类来使字段可被观察：

• ObservableBoolean
• ObservableByte
• ObservableChar
• ObservableShort
• ObservableInt
• ObservableLong
• ObservableFloat
• ObservableDouble
• ObservableParcelable
  Observable Field是独立的Observable对象，只有一个字段。原始版本子在访问操作期间避免装箱和拆箱。要使用这种机制，请在Java编程语言中创建一个final属性：

    private static class UserInfo {
        public final ObservableField firstName = new ObservableField<>() ;
        public final ObservableField lastName = new ObservableField<>() ;
        public final ObservableInt age = new ObservableInt() ;
    }

要访问字段的值，需要使用set（）和get（）方法，例：

mUserInfo.firstName.set("Google");
int age = mUserInfo.age.get();

注：Android Studio 3.1和更高版本允许您用LiveData对象替换可观察字段，这为您的应用程序提供了额外的好处，更多信息 Use LiveData to notify the UI about data changes；

Observable collections (Observable 集合)

一些应用程序使用动态结构来保存数据，Observable collections 允许使用对这些对象使用键存取。

• 当键是String等引用类型时ObserableArrayMap类非常有用:

        ObservableArrayMap user = new ObservableArrayMap<>();
        user.put("firstName","Google");
        user.put("lastName","Inc.");
        user.put("age",18);

在布局中可以直接使用String key来访问：

    
    

…

• 当键是Integer类型时，ObserbableArrayList非常有用：

        ObservableArrayList