Andriod DataBinding基础入门

  • 依赖

在使用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);
    }
}

未完待续...(菜鸟一枚,刚开始试着写文章,写的好累啊,只当是工作记录,写的不好请大神们多多提意见)

  • 参考

Android DataBinding入门
Android DataBinding (一) 基本用法

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容