当前位置:   article > 正文

Android DataBinding从入门到精通_androidx.databinding

androidx.databinding

DataBinding可以更加方便的编写与视图交互的代码。即系统会为模块中的每个xml文件生成一个绑定类,其实例包含指向相应布局中具有ID的所有视图的直接引用。大多数情况下,DataBinding会代替findMyId。

启动DataBinding

Android SDK 32及后续版本中(PCCT控制面板用的版本为SDK 34),在项目gradle中配置:

adroid {
    compileSdk 32
    buildFeatures {
        viewBinding true
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

然后,系统会将XML(layout)文件的名称转换为驼峰式,并在末尾添加“Binding”作为词缀。即若xml的文件名称为ActDataBindg1,那么会自动生成ActDataBinding1Binding类,可以直接使用。

Java调用

在DataBindingAct1中,需要调用setContentView

public class DataBindingAct1 extends AbsActivity {
    ActDataBinding1Binding binding;
    
    @Override
    protected void onCreate(Bundle savedInstantceState){
        super.onCreate(savedInstanceState);
        binding = ActDataBinding1Binding.inflate(getLayoutInflater());
        setContentView(binding.getRoot());
        
        binding.tv1.setText("可以直接使用TextView");
        binding.tv2.setText("不用findViewById");
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13

可以看出,不像过去的方式,不用写那么多冗余的findViewById,可以直接使用binding。同时,每个类还绑定一个getRoot()方法用于为相应布局文件的根视图提供引用。

DataBindingUtil

在上文的ActDataBinding1Binding.inflate(getLaoutInflater())也可以用于换为DataBindingUtil.setContentView,如下所示:

@Override
protected void onCreate(Bundle savedInstanceState){
    super.onCreate(savedInstanceState);
    binding = DataBindingUtil.setContentView(this, R.layout.act_data_binding_1);
}
  • 1
  • 2
  • 3
  • 4
  • 5

Binding与findViewById的区别:

与使用findViewById相比,将视图绑定有如下优点:

  • Null安全:由于视图绑定创建了对视图的直接引用,因此不会出现因视图无效ID而出现Null异常。同时,若视图只出现在布局的某些配置中,那么绑定类中的引用字段会加@Nullable注解。
  • 类型安全:每个绑定类中的字段均有与之匹配的类型(XML文件中引用的视图)。这意味着不会发生类转换异常的问题。

Activity示例

首先提供一个抽象类BaseAct封装一些常用操作,继承ViewDataBinding

/**
 * 抽象类
 */
 public abstract class BaseAct<B extends ViewDataBinding> extends AppCompatActivity {
     protected B binding;
     // @return 界面对应的layout id
     protected abstract int getLayoutId();
     
     @Override
     protected void onCreate(@Nullable Bundle savedInstanceState) {
         super.onCreate(saveInstanceState);
         binding = DataBindingUtil.setContentView(this, getLayoutId());
     }
 }
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14

实现类继承BaseAct,指定ViewDataBinding的子类后,就可以使用binding对象了。

public class MainActivity extends BaseAct<ActMainBinding> {
    @Override
    protected int getLayoutId() {
        return R.layout.act_main;
    }
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // binding操作
    }
    
    @Override
    public void onBackPressed() {
    
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17

使用Observable

DataBinding提供Obeservable接口用于监听实体类对象属性的变化,其具有添加、删除监听的功能。

我们可以直接实现基本监听类BaseObeservable,然后在get方法加上@Bindable注解,set方法中直接调用notifyPropertyChanged通知UI更新即可。

继承BaseObservable类

设计一个类SysInfo(代表业务上的数据),并让它集成BaseObservable类,给Get方法加@Bindable注解

public class SysInfo {
    private String info1 = build.MANUFACTURER;
    private String timeStr = " ";
    private long time;
    
    @Bindable
    public String getInfo1() 
        return info1;
    }
    
    public void setTimeStr(String timeStr) {
        this.timeStr = timeStr;
        notifyPropertyChanged(BR.timeStr);
    }
    
    @Bindable
    public long getTime() {
        return time;
    }
    
    public void setTime(long time) {
        this.time = time;
        notifyPropertyChanged(BR.time);
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25

此时,SysInfo类就是可以被观测到的了。其中在set方法中调用notifyPropertyChanged()、get方法上加@Bindable注解,在编译工程后,DataBinding就会在BR文件中生成相应字段。【BR是编译期间生成的类,相当于R文件】

接下来,定义工具类DataUtils的,提供静态方法【后续会在layout中用到】

public class DataUtils {
    private static SimpleDateFormat format =  new SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.CHINA);
    public static String formatTime(long time) {
        return format.format(time);
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

layout布局

在data标签下使用多个import标签把使用的类导入。

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

    <data>
        // 引入[import]工具类DataUtils
        <import type="com.rustfisher.tutorial2020.databinding.DataUtils" />
        // 生命[variable]使用SysInfo对象。变量名为info
        <variable
            name="info"
            type="com.rustfisher.tutorial2020.databinding.data.SysInfo" />
    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        android:padding="16dp">
        // 使用DataUtils方法,也是@{}
        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{info.info1}" />

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{info.timeStr}" />
        // 在使用对象的属性时,也可以直接进行操作
        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{DataUtils.formatTime(info.time)}" />
    </LinearLayout>
</layout>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34

Activity代码

在layout文件中设置了SysInfo变量后,binding会自动生成binding.setInfo()方法。

在Activity中创建一个SysInfo对象,交由binding。后续这个对象的数据变化时,界面即可相应改变。为演示数据变化,使用定时器更新数据。

public class DataBindingAct1 extends AbsActivity {
    private ActDataBinding1Binding binding;
    private SysInfo mSysInfo = new SysInfo();
    private Timer mTimer;
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        binding = DataBindingUtil.setContentView(this, R.layout.act_data_binding_1);
        binding.setInfo(mSysInfo);
        
        mTimer = new Timer();
        // 定期执行,每500毫秒执行一次[0 表示0延迟,500 表示周期时间]
        mTimer.schedule(new TimerTask() {
            @Override
            public void run() {
                mSysInfo.setTimeStr("Time: " + System.currentTimeMillis());
                mSysInfo.setTime(System.currentTimeMillis());
            }
        }, 0, 500);
    }
    
    @Override
    protected void onDestroy() {
        super.onDestroy();
        mTimer.cancel();
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29

可观察数据对象ObservableField

对于基础类型使用如下类型即可:

ObservableBoolean
ObservableByte
ObservableChar
ObservableShort
ObservableInt
ObservableLong
ObservableFloat
ObservableDouble
ObservableParcelable
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

对于自创建对象,使用可观察字段避免访问操作期间封箱和开箱的操作,使用此机制需要使用public final属性:

User.java
import androidx.databinding.ObservableField;
import androidx.databinding.ObservableInt;

public class User {
    public final ObservableField<String> firstName = new ObservableField<>();
    public final ObservableField<String> lastName = new ObservableField<>();
    public final ObservableInt age = new ObservableInt();
}

// 要访问字段值,使用set()和get()方法
user.firstName.set("Google");
int age = user.age.get();
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13

使用ObservableField

在使用Observable时,在每个set方法都需要调用notifyPropertyChanged去通知ui,而在ObservableField即可避免这个事情:

public class SysInfoObs {
    public ObservableField<String> info1 = new ObservableField<>(Build.MANUFACTURER);
    public ObservableField<String> timeStr = new ObservableField<>();
    public ObservableField<Long> time = new ObservableField<>();
}
  • 1
  • 2
  • 3
  • 4
  • 5

layout与上文大致相同,只需将variable改为新建的SysInfoObs类:

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

    <data>

        <import type="com.rustfisher.tutorial2020.databinding.DataUtils" />
        // 将variable改为新建的SysInfoObs类
        <variable
            name="info"
            type="com.rustfisher.tutorial2020.databinding.data.SysInfoObs" />
    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        android:padding="16dp">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{info.info1}" />

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{info.timeStr}" />

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{DataUtils.formatTime(info.time)}" />
    </LinearLayout>
</layout>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34

在Activity中更改使用方式,新建DataBindingAct2类,持有SysInfoObs的对象:

public class DataBindingAct2 extends AbsActivity {
    private ActDataBinding2Binding binding;
    private SysInfoObs mSysInfo = new SysInfoObs();
    
    private Timer mTimer;
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        binding = DataBindingUtil.setContenteView(this, R.layout.act_data_binding_2);
        binidng.setInfo(mSysInfo);
        
        mTimer = new Timer();
        mTimer.schedule(new TimerTask() {
            @Override
            public void run() {
                mSysInfo.timeStr.set("Time: " + System.currentTimeMillis());
                mSysInfo.time.set(System.currentTimeMillis());
            }
        }, 0, 500);
    }
    
    @Override
    protected void onDestroy() {
        super.onDestroy();
        mTimer.cancel();
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29

在更新数据时,使用ObservableField的set方法即可。

可观察集合

某些应用使用动态结构存储数据,当键为引用时,ObservableArrayMap则非常有用:

ObservableArrayMap<String, Object> user = new ObservableArrayMap<>();
user.put("firstName", "RUST");
user.put("lastName", "Fisher");
user.put("age", 18);
binding.setUser(user);
  • 1
  • 2
  • 3
  • 4
  • 5

layout文件如下:

<data>
    <import type="androidx.databinding.ObservableArrayMap" />
    // 注意Map的左尖括号要使用&lt
    <variable
        name="user"
        type="ObservableArrayMap&lt;String, Object>" />
</data>

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text='@{user.firstName + " " + user.lastName}' />

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@{String.valueOf(1 + (Integer)user.age)}" />
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17

使用ObservableArraylist如下所示:

ObservableArrayList<Object> obList = new ObservableArrayList<>();
obList.add("NeoSoft");
obList.add("Java");
obList.add("Android");
obList.add(2020);
binding.setObList(obList);
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

在layout中设置

<data>
    <import type="androidx.databinding.ObservableArrayList" />

    <variable
        name="obList"
        type="ObservableArrayList&lt;Object>" />
</data>

<!-- .... -->

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text='@{obList[0] + " " + obList[1]}' />

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text='@{String.valueOf(1 + (Integer)obList[3])}' />
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19

点击事件

准备监听方法,以MutableDemoVm类为例

public class MutableDemoVM {
    // ... 
    // 用于设置点击监听
    public void onClickBack(View view) {
        // ...
    }
    // 用于设置点击监听
    public void onClickAdd(View view) {
        // ...
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11

其中需要View作为参数,因为要对应View.OnClickListener的onClick(View v)方法

public interface OnClickListener {
    /**
     * Called when a view has been clicked.
     *
     * @param v The view that was clicked.
     */
    void onClick(View v);
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

layout中设置监听方法

设置android:onClick监听

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">

    <data>
        <variable
            name="vm"
            type="com.rustfisher.tutorial2020.databinding.data.MutableDemoVM" />
    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="50dp"
            android:orientation="horizontal">

            <ImageView
                android:layout_width="50dp"
                android:layout_height="50dp"
                android:onClick="@{vm.onClickBack}"
                android:padding="10dp"
                android:src="@drawable/ic_arrow_back_black_24dp" />

        </LinearLayout>

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:orientation="vertical">
            // 设置android:onClick时,建议用2个冒号@{vm::onClickAdd}来引用方法都可以
            // 随着Jetpack的升级,后面只用2个冒号的形式
            <Button
                android:layout_width="100dp"
                android:layout_height="50dp"
                android:layout_gravity="center_horizontal"
                android:layout_marginTop="20dp"
                android:onClick="@{vm::onClickAdd}"
                android:text="+" />
        </LinearLayout>

    </LinearLayout>
</layout>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45

在activity中设置数据

public class MutableDemo1 extends AppCompatActivity {
    private ActMutableDemo1Binding binding;
    private MutableDemoVM mVM = new MutableDemoVm();
    
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        binding = DataBindingUtil.setContentView(this, R.layout.act_mutable_demo1);
        binding.setVm(mVM);
        // ...
    }
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13

RadioButton OnCheckedChangeListener

在类中定义好选择的方法,方法签名和CompoundButton.OnCheckedChangeListener.onCheckedChanged(CompoundButton buttonView, boolean isChecked)一致。

public void choose1(CompoundButton buttonView, boolean isChecked) {
    // ...
}

public void choose2(CompoundButton buttonView, boolean isChecked) {
    // ...
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7

在layout中设置使用方法。

<RadioGroup
    android:layout_width="wrap_content"
    android:layout_height="wrap_content">

    <RadioButton
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:onCheckedChanged="@{viewModel.choose1}"
        android:text="选项1"/>

    <RadioButton
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:onCheckedChanged="@{viewModel.choose2}"
        android:text="选项2" />
</RadioGroup>
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/神奇cpp/article/detail/894123
推荐阅读
相关标签
  

闽ICP备14008679号