本文是用来简记DataBinding使用前的配置及一些情况下的使用。
在项目的要使用DataBinding的module的gradle构建文件里添加如下文件:
android {
....
dataBinding {
enabled = true
}
}
DataBinding插件将会在你的项目内添加必需提供的以及编译配置依赖。
DataBinding layout文件与普通布局文件的不同点是:
根标签是 layout ,然后是一个 data 标签和一个ViewGroup标签,此ViewGroup即普通布局的根布局。如下:
android:text="@{user.firstName}"
在com.zf包下创建一个User类:
public class User {
public final String firstName;
public final String lastName;
public User(String firstName, String lastName) {
this.firstName = firstName;
this.lastName = lastName;
}
}
编译之后会在build\generated\source\apt\debug\项目包名\databinding中生成对应的Binding类。在上述为main_activity.xml,在NainActivity中使用会生成一个MainActivityBinding类,然后调用binding.setUser(user)就可以完成数据的刷新。生成binding的最简单方式是inflating。
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
MainActivityBinding binding = DataBindingUtil.setContentView(this, R.layout.main_activity);
User user = new User("Test", "User");
binding.setUser(user);
}
在data中可以使用任意数量的variable元素,每个variable元素会在对应的Binding类中生成对应的set、get方法。如下:
public abstract void setBeanHairSideHome(@Nullable cn.yanzijia.mine.model.HairSideHomeBean BeanHairSideHome);
@Nullable
public cn.yanzijia.mine.model.HairSideHomeBean getBeanHairSideHome() {
return mBeanHairSideHome;
}
默认情况下,生成的Binding类的名称是布局文件去除下划线、(),所有单词首字母大写(被下划线分割的视为一个单词)。
然后再后面加上Binding。被放置在build\generated\source\apt\debug\项目包名\databinding包下。
...
...
使用如下:
home.xml
poster_layout_home_xm_new_order.xml文件:
...
...
注意点:
include中添加的传递项在接收的xml文件中必须一一对应。
名称也必须相同。
android:text="@{user.firstName ?? user.lastName}"
android:text="@{user.firstName != null ? user.firstName : user.lastName}"
…
android:text="@{list[index]}"
…
android:text="@{sparse[index]}"
…
android:text="@{map[key]}"
正常访问:
android:src="@{@drawable/poster_ic_fab_back_top}"
使用三元表达式:
android:src="@{islarge? @drawable/poster_ic_fab_back_top : @drawable/poster_ic_fab_back_top2}"
上述示例中,Data数据显示在UI上,但是改变Data属性UI不会刷新。DataBinding可以通过绑定使数据变化时UI随之刷新。数据变化的通知方式有三种:Observable objects,ObservableField,observable collection:观察对象、观察字段、观察集合。
ViewModel类:
public class User extends BaseObservable {
public String firstName;
public String lastName;
public User(String firstName, String lastName) {
this.firstName = firstName;
this.lastName = lastName;
}
@Bindable
public String getFirstName() {
return firstName;
}
public void setFirstName(String firstName) {
this.firstName = firstName;
notifyPropertyChanged(BR.firstName);
}
@Bindable
public String getLastName() {
return lastName;
}
public void setLastName(String lastName) {
this.lastName = lastName;
notifyPropertyChanged(BR.lastName);
}
}
Acivity类中设置及切换数据:
private ActivityMainBinding mBinding;
private User user;
private String[] first = {"张", "周", "李"};
private String[] last = {"倩倩", "花花", "小小"};
private int i = 0;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);
user = new User("李","笑笑");
mBinding.setUser(user);
}
public void changeData(View view) {
if (i >= first.length) i = 0;
user.setFirstName(first[i]);
user.setLastName(last[i]);
i++;
}
activity_main.xml文件:
在 set 方法里面,使用 notifyPropertyChanged 来通知 UI 刷新,notifyPropertyChanged 只会刷新具体的值,notifyChange 方法则会刷新所有的值。
BR 的域则是通过在 get 方法上加 @Bindable 生成的。
注意:如果在layout文件中使用get方法获取ViewModel中的值,则改变ViewModel中的值的时候不会刷新UI。
ViewModel类:
public class UserField {
public final ObservableField userName=new ObservableField<>();
public final ObservableField userPassword=new ObservableField<>();
}
直接把属性定义成 ObservableField 类型的,并且修饰符需要是 public final 的。
除了 ObservableField,还可以使用 ObservableBoolean, ObservableByte, ObservableChar, ObservableShort, ObservableInt, ObservableLong, ObservableFloat, ObservableDouble, ObservableParcelable。
访问值得时候,可以使用 get set 方法。
Activity中的处理:
private ActivityMainBinding mBinding;
private UserField userField;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);
userField = new UserField();
userField.userName.set("张三");
userField.userPassword.set("123456");
mBinding.setUserField(userField);
}
public void login(View view) {
userField.userName.set("李四");
userField.userPassword.set("098765");
}
activity_main.xml文件:
如果使用 Map,List 等保存数据。DataBinding 也提供了 ObservableArrayMap,ObservableArrayList。
修改集合中的值对应UI的值也随之改变。
Activity中的处理:
private ObservableMap objectObservableMap;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);
objectObservableMap = new ObservableArrayMap<>();
objectObservableMap.put(Keys.name, "王五");
mBinding.setMap(objectObservableMap);
}
public void collections(View view) {
objectObservableMap.put(Keys.name,"赵六");
}
activity_main.xml文件:
variable 类型声明的集合要添加泛型,但是泛型不能使用’<'字符。否则会报错:
与元素类型 "variable" 相关联的 "type" 属性值不能包含 '<' 字符。
如果不使用泛型会报错:
Found data binding errors.
****/ data binding error ****msg:Cannot find the setter for attribute 'android:text' with parameter type V on android.widget.TextView.
file:E:\demo\DataBindingDome\app\src\main\res\layout\activity_main.xml
loc:46:28 - 46:41
****\ data binding error ****
可以使用’<'的转义字符:<
其它特殊符号的转义字符:
&(逻辑与) &
<(小于) <
>(大于) >
"(双引号) "
'(单引号) '
ActivityMainBinding mBinding = DataBindingUtil.setContentView(this, R.layout.activity_main);
一般在Activity中使用
一般用于Fragment或者Adapter中。
public class QuickDataBindingVH extends BaseViewHolder {
public T binding;
public QuickDataBindingVH(ViewGroup parent, @LayoutRes int itemLayoutRes) {
super(LayoutInflater.from(parent.getContext()).inflate(itemLayoutRes, parent, false));
}
public QuickDataBindingVH(View view) {
super(view);
binding=DataBindingUtil.bind(view);
}
public T getBinding() {
return binding;
}
}
RecyclerView封装的可使用的ViewHolder
layout 中的每个带id的 View 在生成的Binding类中都会生成一个对应的 public final 成员变量。
会生成:
@NonNull
public final android.widget.TextView tvUser;
每个variable都会在Binding类中生成对应的访问方法。
会在Binding 类中生成setters和getters
public void setUserField(@Nullable com.example.zf.databindingdome.UserField UserField) {
this.mUserField = UserField;
synchronized(this) {
mDirtyFlags |= 0x10L;
}
notifyPropertyChanged(BR.userField);
super.requestRebind();
}
@Nullable
public com.example.zf.databindingdome.UserField getUserField() {
return mUserField;
}
public void setUser(@Nullable com.example.zf.databindingdome.User User) {
updateRegistration(3, User);
this.mUser = User;
synchronized(this) {
mDirtyFlags |= 0x8L;
}
notifyPropertyChanged(BR.user);
super.requestRebind();
}
@Nullable
public com.example.zf.databindingdome.User getUser() {
return mUser;
}
When a variable or observable object changes, the binding is scheduled to change before the next frame. There are times, however, when binding must be executed immediately. To force execution, use the executePendingBindings() method.