android 数据绑定(6)自定义绑定方法、双向数据绑定

1.官方文档

　　https://developer.android.com/topic/libraries/data-binding/binding-adapters

　　https://developer.android.com/topic/libraries/data-binding/two-wa

2.自定义绑定

2.1 系统定义的绑定方法

　　假设在绑定布局文件中使用app:aaaaa 的属性，绑定库自动尝试查找方法 setAaaaa(arg)。

• 按app:aaaaa 时传递的参数， 找到参数匹配或兼容的那个方法setAaaaa
• 不会考虑属性的命名空间
• 搜索方法时仅使用属性名称和类型
• 假设类Student包含 setTtttt 这个方法，那么可以直接在布局文件中使用 app:ttttt 这个属性。

2.2 自定义绑定的方法

• a.重新绑定属性与对应的方法

       @BindingMethods(value = [
       BindingMethod(
               type = ImageView::class,
               attribute = "android:tint",
               method = "setImageTintList")])

上述代码把 android:tint 这个属性绑定到了setImageTintList方法。官方文档中并没有给出这段应该放哪里，放在类里面编译不过,通过官方完整示例中发现它是全局的。

• b.修改系统已经定义好的方法

           @androidx.databinding.BindingAdapter("android:paddingLeft")
           @JvmStatic
           fun setPaddingLeft(view: View, oldPadding: Int, newPadding: Int) {
               if (oldPadding != newPadding) {
                   view.setPadding(,
                           view.getPaddingTop(),
                           view.getPaddingRight(),
                           view.getPaddingBottom())
               }
           }

  重新定义了 android:paddingLeft属性，注意，调用的时候  android:paddingLeft='@{16}' 才匹配这个方法，android:paddingLeft="16dp" 还是系统的那个方法。

　　　出现冲突时，自定义的绑定方法会替换数据绑定库提供的默认方法.

　　　重新定义系统已经存在的属性没意义，这个方法要以 '@{16}‘ 这种 方式调用，android:paddingLeft="16dp" 无效

• c.把多个属性联合在一起，绑定个方法

           @JvmStatic
           @androidx.databinding.BindingAdapter(value = ["imageUrl", "error"], requireAll = false)
           fun loadImage(view: ImageView, url: String, error: Drawable) {
               Picasso.get().load(url).error(error).into(view)
           }

  requireAll = false 的含义是 单独使用imageUrl,error其中一个属性的时候，就绑定这个方法，true就是必需同时使用这两个属性的时候才绑定这个方法。

  使用

  <ImageView
              android:id="@+id/imageView2"
              android:layout_width="64dp"
              android:layout_height="64dp"
              app:error='@{@drawable/error}'
              app:imageUrl='@{"sdfsd.com/fef.ppppjnpng"}'
              />

2.3 类型转换 @BindingConversion

作用：使用这个 注解可以定义一个类型A到类型B在转换函数，函数名的格式为

convertAToB,如 convertStringToData

         @JvmStatic
         @androidx.databinding.BindingConversion
         fun convertStringToData(name : String) = Data()

3. 双向绑定

3.1 单向的问题

　　默认是单向绑定，控件与用户的交互（如输入新的名字，点单选框和复选框）不会自动修改对应的绑定数据对象，要在代码里手动处理相应的控件事件，在事件函数里修改数据对象。如：

     val data = Data()
     lateinit var binding : Way2Binding
     val nameWatcher = object : TextWatcher{
         override fun afterTextChanged(p0: Editable?) {
             val txt = p0.toString()
             data.name = txt
             binding.invalidateAll()
         }
         override fun beforeTextChanged(p0: CharSequence?, p1: Int, p2: Int, p3: Int) {}
         override fun onTextChanged(p0: CharSequence?, p1: Int, p2: Int, p3: Int) {}
     }

     fun initBinding(){
         binding.data = data
         binding.normalEdt.addTextChangedListener(nameWatcher)
     }

3.2 使用双向绑定

　　使用双向绑定可以简化这个问题，减少相应代码。

　　用 @={} 表示可接收属性的数据更改并同时监听用户更新.

       <EditText
             ...
             android:text='@={data.name,default=@string/data_name}'
             .../>

　　这样当用户在这个EditText上输入新的内容后，直接更新到绑定的数据对象。

　　注意： @={} 不可以使用格式化的@string/xx 　　

3.3 自定义的属性使用双向绑定

a.自定义属性的 setXXX

     @BindingAdapter("dataName")
     @JvmStatic fun setDataName(edt : EditText, txt : String){
         edt.setText(txt)
     }

b.自定义属性的 getXXX

     @InverseBindingAdapter(attribute = "dataName")
     @JvmStatic fun getDataName(edt : EditText) : String{
         return edt.text.toString()
     }

注意：attribute =  不可少，否则编译不过。

c.编写属性变化监听器及想要监听的事件

     @BindingAdapter("dataNameAttrChanged")
     @JvmStatic fun setListener(edit : EditText, listener: InverseBindingListener?) {
         Log.e("dataNameAttrChanged","txt = ${edit.text.toString()}")
         var txt = ""
         edit.addTextChangedListener(object : TextWatcher{
             override fun afterTextChanged(p0: Editable?) {
                 Log.e("dataNameAttrChanged","afterTextChanged")
                 if (txt != p0.toString()){
                     listener?.onChange()
                     txt = p0.toString()
                 }
             }
             override fun beforeTextChanged(p0: CharSequence?, p1: Int, p2: Int, p3: Int) {}
             override fun onTextChanged(p0: CharSequence?, p1: Int, p2: Int, p3: Int) {}
         })
     }

• InverseBindingListener 是属性变化监听器
• 这个 EditText 监听的事件是 textChanged

注意：  listener?.onChange() 容易死 循环,要判断下原内容与新内容，不一样才调用这个函数。上述代码中的高亮部分。

d.布局文件中使用

    <EditText  app:dataName='@={data.name}'  ... >

3.4 类型转换的双向绑定

使用类型转换时，也可以使用双向绑定，但是要指定一个反向转换的函数。用 @InverseMethod("转换函数名") 来声明。

 @file:JvmName("Converter")

 package com.example.databind
 import androidx.databinding.InverseMethod

 class A (var name: String)

 @InverseMethod("a2String")
 fun string2a(string: String) : A{
     return A(string)
 }

 fun a2String(a : A) : String{
     return a.name
 }

在布局文件中

    <EditText android:text='@={Converter.a2String(a)}' />

3.5 支持双向绑定的内置属性

控件	属性	绑定适配器所在的类
AdapterView	android:selectedItemPosition android:selection	AdapterViewBindingAdapter
CalendarView	android:date	CalendarViewBindingAdapter
CompoundButton	android:checked	CompoundButtonBindingAdapter
DatePicker	android:year android:month android:day	DatePickerBindingAdapter
NumberPicker	android:value	NumberPickerBindingAdapter
RadioButton	android:checkedButton	RadioGroupBindingAdapter
RatingBar	android:rating	RatingBarBindingAdapter
SeekBar	android:progress	SeekBarBindingAdapter
TabHost	android:currentTab	TabHostBindingAdapter
TextView	android:text	TextViewBindingAdapter
TimePicker	android:hour android:minute	TimePickerBindingAdapte