-
依赖
在使用databinding的module的build.gradle中设置
android {
...
defaultConfig {
...
}
dataBinding {
enabled = true
}
...
}
-
开始简单的数据绑定
1.我们先定义一个java bean
public class User {
private String username;
private String avatar;
private int age;
public User(String username, String avatar, int age){
this.username = username;
this.avatar = avatar;
this.age = age;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getAvatar() {
return avatar;
}
public void setAvatar(String avatar) {
this.avatar = avatar;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
}
2.我们需要简单的展示用户头像、名称以及年龄，需要定义xml文件
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
<data>
<variable
name="user"
type="com.xzj.aacapp.bean.User" />
</data>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
android:gravity="center_horizontal">
<ImageView
android:id="@+id/ivImage"
imageUrl="@{user.avatar}"
android:layout_width="60dp"
android:layout_height="60dp" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="20dp"
android:text="@{user.username}"
android:textSize="14sp" />
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginTop="20dp"
android:text="@{String.valueOf(user.age)}"
android:textSize="14sp" />
</LinearLayout>
</layout>
这个和常规的xml有所不同，使用databinding xml布局文件是以layout标签为布局文件最外层，data标签是绑定的数据来源，然后重新rebuild project会在build/ganerated/source/apt下相关目录下生成 ***Binding 类。
默认生成规则：xml通过文件名生成，使用下划线分割大小写，即 activity_main.xml 会生成对应的 ActivityMainBinding
3.数据绑定
之前说了在build/ganerated/source/apt下会生成ActivityMainBinding.java文件，那么我们就可以绑定数据了
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main);
binding.setUser(new User("zhangsan", "http://xxxxx" ,18));
}
}
binding会根据xml中data标签下variable标签name属性自动生成setUser和getUser方法，通过binding.setUser方法自动将数据显示在界面上了，至于上文提到的imageUrl="@{user.avatar}"属性是什么，别急在后面会讲解。
以上就是基本的绑定示例了，接下来看下基础的语法和其他基础操作。
-
运算符
支持绝大部分的 Java 写法，允许变量数据访问、方法调用、参数传递、比较、通过索引访问数组，甚至还支持三目运算表达式
算术 + - * / %
字符串合并 +
逻辑 && ||
二元 & | ^
一元 + - ! ~
移位 >> >>> <<
比较 == > < >= <=
instanceof
Grouping ()
文字 - character, String, numeric, null
Cast
方法调用
Field 访问
Array 访问 []
三目运算符 ?:
尚且不支持 this，super，new 以及显式的泛型调用
-
空指针处理
DataBinding 是 Null Safe 的，DataBinding 会自动检查是否为 null，如果引用对象为 null，那么所有属性引用的都是 null 的，你无需判断也不会导致崩溃
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{user.name}"
如果 user 为 null，@{user.name} 也将为 null，并不会出现 NullPointerException。
-
运算符 ??
android:text="@{user.username ?? user.nickname}"
如果左边username不为 null，则选取 ?? 左边的，如果为 null，则选取 ?? 右边的nickname，相当于以下代码
android:text="@{user.username!= null ? user.username: user.nickname}"
-
集合的使用
<data>
<import type="android.util.SparseArray"/>
<import type="java.util.Map"/>
<import type="java.util.List"/>
<variable name="list" type="List<String>"/>
<variable name="sparse" type="SparseArray<String>"/>
<variable name="map" type="Map<String, String>"/>
</data>
…
android:text="@{list[0]}"
…
android:text="@{sparse[0]}"
…
android:text="@{map['key']}"
-
资源文件的引用
可以直接引用String.xml配置文件如：
<string name="name">My name is %s</string>
可以使用 String.format 传入参数
android:text="@{String.format(@string/name,user.username)}"
也可以简单的写法：
android:text="@{@string/name(user.username)}"
还可以对数值类应用直接进行运算
android:padding="@{@dimen/padding + @dimen/avatar_size}"
-
import
当在 XML 中数据绑定的时候，用到了 java.lang 之外的类，必须在 data 标签下面 import。
比如想控制 View 的显示和隐藏。
<TextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{user.name}"
android:visibility="@{user.showName ? View.VISIBLE : View.GONE}" />
由于用到了 View 类，所以必须 import。
<data>
<import type="android.view.View" />
......
</data>
如果类名相同，package 名不相同，就需要用别名解决。
<data>
<import type="com.xzj.aacapp.bean.User" alias="User1" />
<import type="com.xzj.aacapp.pojo.bean.User" alias="User2" />
<variable
name="user1"
type="User1" />
<variable
name="user2"
type="User2" />
</data>
import 的类型可以用到 variable 中
<data>
<import type="com.xzj.aacapp.bean.User" />
<import type="java.util.List"/>
<variable name="user" type="User"/>
<variable name="userList" type="List<User>"/>
</data>
import 的类型也可以调用它的static 变量和 static 方法
<data>
<import type="com.example.MyStringUtils"/>
<variable name="user" type="com.example.User"/>
</data>
…
<TextView
android:text="@{MyStringUtils.capitalize(user.lastName)}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
-
include
当 layout 文件中用到 include 的时候，variable 也可以传到 include 的 layout 文件中继续使用
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:bind="http://schemas.android.com/apk/res-auto">
<data>
<variable name="user" type="com.xzj.aacapp.pojo.User"/>
</data>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<include layout="@layout/name"
bind:user="@{user}"/>
</LinearLayout>
</layout>
-
双向绑定
有别于单向绑定使用的@{}符号，双向绑定使用@={}符号用于区别
<EditText
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="@={user.username}"/>
-
属性扩展
BindingMethods 和 BindingAdapter 注解
文章开头示例中用到了imageUrl="@{user.avatar}"自定义的属性
<ImageView
android:id="@+id/ivImage"
imageUrl="@{user.avatar}"
android:layout_width="60dp"
android:layout_height="60dp" />
我们通过BindingAdapter注解定义了imageUrl属性
public class BindingAdapters {
@BindingAdapter("visibleGone")
public static void showHide(View view, boolean show) {
view.setVisibility(show ? View.VISIBLE : View.GONE);
}
@BindingAdapter("imageUrl")
public static void bindImage(ImageView icon, String url) {
if (!TextUtils.isEmpty(url)) {
GlideImageLoader.displayByUrl(icon.getContext(), url, icon);
}
}
@BindingAdapter("html")
public static void html(WebView webView, String html) {
webView.loadDataWithBaseURL(null, html, "text/html", "utf8", null);
}
@BindingConversion
public static ColorDrawable convertColorToDrawable(int color) {
return new ColorDrawable(color);
}
}
未完待续...(菜鸟一枚，刚开始试着写文章，写的好累啊，只当是工作记录，写的不好请大神们多多提意见)
-
参考
