当第一次看到Data Binding的时候,我就深深的被它吸引了。
因为它可以让数据直接与xml布局绑定,不用再去写繁琐的初始化查找控件再去给其赋值,省去了重复代码的体力活,提高了我们开发的效率。
经过一番学习,现在把一些基本的使用方法分享出来,希望能帮助想要学习的小伙伴。
学习的前提是你的 android studio 版本要高于等于1.3.0 。在它以下AS是不支持的。不过1.3.0现在应该不会有什么人使用了吧。
先来说说配置,在你的模块的 build.gradle 文件中的 android 节点里添加 dataBinding 配置:
dataBinding {
enabled = true
}
data binding 主要就是在xml布局里面的语法使用,在使用它的布局里面,起始根标签是layout,然后下来一个data元素以及一个view根元素,这个view元素就是原来没有使用 data binding 的布局里的根元素。
1. activity_main布局。
<?xml version="1.0" encoding="utf-8"?>
<layout
xmlns:android="http://schemas.android.com/apk/res/android">
<data>
<variable
name="bean"
type="com.example.weioule.databindingdemo.Bean"/>
</data>
<RelativeLayout
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="25dp"
android:layout_marginTop="25dp"
android:text="@{bean.name}"
android:textSize="15sp"/>
<TextView
android:id="@+id/btn"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:layout_alignParentRight="true"
android:layout_marginBottom="25dp"
android:layout_marginRight="25dp"
android:padding="10dp"
android:text="do next"/>
</RelativeLayout>
</layout>
像上面的activity_main布局中,xmlns:android的命名空间你可以写在layout跟布局里也可以写在下面的View元素的跟布局里。
data元素里的variable标签就是我们所要绑定的数据,name可以自己定义,type就得指向你的Bean类了,用包名点类名的形式。
在data中可以有多个variable数据 ,其数据类型也可以是任意类型。
当我们在MainActivity里获取到data dinding对象把Bean的实例给设置进来时,这里的bean就有值了。设置的方法为你set拼接上你的name的名字首字母大写,类似我们所写的set方法,我们这里是setBean()。
定义好数据后,在下面就可以使用了,看我们的第一个TextView的文本设置,引用的就是我们的Bean数据里的name属性,它的写法为 @{bean.name} 。
来看看我们的MainActivity里是怎么与xml进行绑定的:
ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);
binding.setBean(new Bean("垚鑫"));
原来的 setContentView() 替换成了 DataBindingUtil.setContentView(),填充布局后返回一个 ViewDataBinding 的子类对象 binding,它的类名是可以由你自己命名的,这里我们没有定义就使用默认的名字。
命名规则是,xml文件的名字去掉下划线,后面加上Binding,采用驼峰法命名。这里呢我们的就是 ActivityMainBinding 了。
这样绑定后布局里所有的控件的id都可以直接获取,不必再使用 findViewById ,就像MainActivity里的btn一样直接使用。
binding.btn.setOnClickListener(new View.OnClickListener() {
....
});
绑定后通过 binding 给xml里设置数据 binding.setBean(new Bean("垚鑫"));
一定要记得用 ActivityMainBinding 类型接收返回的对象,因为你自动补全的时候生成的类型是 ViewDataBinding 。你不用ActivityMainBinding 接收的话,它是找不到你的bean对应的设置数据方法的。
另外获取binding还有两种方法:
第二种方法
ActivityMainBinding binding = ActivityMainBinding.inflate(getLayoutInflater());
View view = binding.getRoot();
setContentView(view);
第二种方法
View view = getLayoutInflater().inflate(R.layout.activity_main, null);
ActivityMainBinding binding = ActivityMainBinding.bind(view);
setContentView(view);
2. 我们来看看布局 activity_second。
<?xml version="1.0" encoding="utf-8"?>
<layout
xmlns:android="http://schemas.android.com/apk/res/android">
<data class="SecondAvtivityBinding">
<import type="android.view.View"/>
<import
alias="MyView"
type="com.example.weioule.databindingdemo.View"/>
<variable
name="bean"
type="com.example.weioule.databindingdemo.Bean"/>
</data>
<RelativeLayout
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="25dp"
android:layout_marginTop="25dp"
android:text="@{bean.name}"
android:textSize="15sp"
android:visibility="@{bean.visible?View.VISIBLE:View.GONE}"/>
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="25dp"
android:layout_marginTop="65dp"
android:text="@{bean.title ?? `title为空`}"
android:textSize="15sp"/>
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="25dp"
android:layout_marginTop="105dp"
android:text="@{MyView.txt+`\n\n`+MyView.fun}"
android:textSize="15sp"/>
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:layout_alignParentRight="true"
android:layout_marginBottom="25dp"
android:layout_marginRight="25dp"
android:onClick="doNext"
android:padding="10dp"
android:text="do next"/>
</RelativeLayout>
</layout>
我们在上面说过,binding 对象的类名是可以自己定义的,布局 activity_second 中 data 标签里 class = "SecondActivityBinding" 就是我们自己定义的类名 SecondActivityBinding 。
这个类在编译时被自动生成并放置在module包里的databinding包下。
另外还有两种写法:
<data class=".SecondActivityBinding">
<data class="com.example.weioule.databindingdemo.SecondActivityBinding>
这两种写法会让这个类在编译时被自动生成直接放置在module包下。
import 标签是导入的意思,可以导入多个,类似我们在类中import,我们上面写的是导入Android的View组件。导入View组件之后我们在xml里就可以使用了,第一个TextView的visibility属性我们就用到了三元运算符,显示和隐藏直接调用View.VISIBLE和 View.GONE 。
当 import 的类名一样(有冲突)时,可以把其中一个类重命名,写法为: (alias= "xx")
<import type="android.view.View"/>
<import type="com.example.weioule.databindingdemo.View" alias="MyView"/>
这样重命名区分之后就可以把 MyView 当 com.example.weioule.databindingdemo里的View当去使用了:text="@{MyView.txt}"
导入类后就可以在表达式中直接使用static属性和方法,类名点即可:android:text="@{ MyView.txt +`\n\n`+ MyView.fun }"。
第二个TextView的文本设置我们使用了null合并运算符: "@{bean.title ?? `title为空`}"
null合并运算符 与三元运算符有些相似,如果第一个操作数不是null 时,整个表达式就等于第一个操作数的值,反之整个表达式就等于第二个操作数的值。
`title为空` 的反引号是因为:字符串文本 在属性值两边使用单引号时,则表达式中使用双引号;也可以使用双引号来包围属性值, 这样的话,字符串文字则就要使用反引号;
3. 我们再来看看 activity_third 布局。
<?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>
<import type="java.util.List"/>
<variable
name="list"
type="List<String>"/>
<variable
name="bean"
type="com.example.weioule.databindingdemo.Bean"/>
</data>
<RelativeLayout
android:layout_width="match_parent"
android:layout_height="match_parent">
<include
android:id="@+id/include"
layout="@layout/layout_include"
app:bean="@{bean}"/>
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_below="@+id/include"
android:layout_marginLeft="25dp"
android:layout_marginTop="10dp"
android:text="@{bean.name +` `+ @string/str}"/>
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:layout_alignParentRight="true"
android:layout_marginBottom="25dp"
android:layout_marginRight="25dp"
android:padding="10dp"
android:text="@{list[0]}"/>
</RelativeLayout>
</layout>
data元素里声明了两个variable数据元素, 一个类型为String的List集合 list,一个是Bean的实例。
type="List<String>" 中的【 < 】是转义字符用来替换【 < 】,原文是type="List<String>" 。 否则会报错编译不通过。
在使用 list 的的时候跟代码里一样,用 [ index ] 就可以了:text="@{ list[0] }"。
arrays、lists、sparse lists以及maps 等集合用法一致。
当 include 另一个布局的时候,将数据传过去 app:bean="@{bean}" 。这个 bean 属性一定要与所 include 的布局里 variable 标签的 name 要一致。否则找不到该属性就会报错。
第一个TextView的文本设置 text="@{bean.name +` `+ @string/str}" 是直接引用strings文件里定义的字符串str,因为data binding 在xml里是可以使用正常的表达式来访问 resources 资源的,包括 dimens 和 colors等。
4. 我们看看layout_include。
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
<data>
<variable
name="bean"
type="com.example.weioule.databindingdemo.Bean"/>
</data>
<LinearLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:orientation="vertical">
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="25dp"
android:layout_marginTop="25dp"
android:text="@{bean.title??`title为空`}"/>
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginLeft="25dp"
android:layout_marginTop="10dp"
android:text='@{bean.visible?"visible = true":"visible = flase"}'/>
</LinearLayout>
</layout>
variable 标签定义的 name= "bean" ,是可以用属性的方式给它赋值的,就像上面的 app:bean="@{bean}" 。
第二个TextView的文本设置android:text='@{bean.visible?"visible = true":"visible = flase"}' 是两边用的单引号括起来,所以里面就可以用双引号来包文字。
ok,data binding的基本使用就到这里了。相信认真看完这篇文章,你也学会data binding的一些基础使用方法了。
demo项目地址:https://github.com/weioule/DataBindingDemo