本頁面由 Cloud Translation API 翻譯而成。

使用可觀察的資料物件

觀測能力是指物件能否通知他人資料的任何變動資料繫結程式庫可讓您建立物件、欄位或可觀測的集合。

您可以使用任何物件進行資料繫結，但修改物件無法自動更新 UI。您可以使用資料繫結可以通知其他物件 (稱為「事件監聽器」) 能使用者的資料相關異動可觀測的類別有三種類型：欄位、集合和物件。

當其中一個可觀察的資料物件繫結至 UI 和當資料物件有所變更，使用者介面也會自動更新。

可觀測欄位

如果您的類別只有少數屬性，這麼做可能不值得會建立可實作 Observable 介面。在本在此情況下，您可以使用一般 Observable 類別和以下程式碼將欄位設為可觀察的基本類別：

可觀測欄位是獨立可觀測的物件，只有單一 ] 欄位。使用原始版本時，學生能避免開箱或開箱作業。如要使用這項機制，請在 Java 中建立 public final 屬性如範例：

Kotlin

class User {
    val firstName = ObservableField<String>()
    val lastName = ObservableField<String>()
    val age = ObservableInt()
}

Java

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

如要存取欄位值，請使用 set() 和 get() 存取子方法或使用 Kotlin 屬性語法：

Kotlin

user.firstName = "Google"
val age = user.age

Java

user.firstName.set("Google");
int age = user.age.get();

可觀測的集合

部分應用程式使用動態結構來保留資料。可觀測的集合存取這些結構 ObservableArrayMap 類別當鍵是參照類型 (例如 String) 時相當實用，如範例：

Kotlin

ObservableArrayMap<String, Any>().apply {
    put("firstName", "Google")
    put("lastName", "Inc.")
    put("age", 17)
}

Java

ObservableArrayMap<String, Object> user = new ObservableArrayMap<>();
user.put("firstName", "Google");
user.put("lastName", "Inc.");
user.put("age", 17);

在版面配置中，您可以使用字串鍵尋找地圖，如範例：

<data>
    <import type="android.databinding.ObservableMap"/>
    <variable name="user" type="ObservableMap&lt;String, Object&gt;"/>
</data>
…
<TextView
    android:text="@{user.lastName}"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>
<TextView
    android:text="@{String.valueOf(1 + (Integer)user.age)}"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>

ObservableArrayList 類別在鍵為整數時非常實用，如下所示：

Kotlin

ObservableArrayList<Any>().apply {
    add("Google")
    add("Inc.")
    add(17)
}

Java

ObservableArrayList<Object> user = new ObservableArrayList<>();
user.add("Google");
user.add("Inc.");
user.add(17);

在版面配置中，您可以透過索引存取清單，如範例：

<data>
    <import type="android.databinding.ObservableList"/>
    <import type="com.example.my.app.Fields"/>
    <variable name="user" type="ObservableList&lt;Object&gt;"/>
</data>
…
<TextView
    android:text='@{user[Fields.LAST_NAME]}'
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>
<TextView
    android:text='@{String.valueOf(1 + (Integer)user[Fields.AGE])}'
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"/>

可觀察物件

實作 Observable 介面的類別允許註冊接收來自可觀測項目的屬性變更通知的事件監聽器物件。

Observable 介面提供新增及移除事件監聽器的機制，但決定通知的傳送時機為了簡化開發作業繫結程式庫提供 BaseObservable 類別，也就是實作事件監聽器註冊機制。實作 BaseObservable 負責在屬性變更時通知我。待辦則指派 Bindable 註解 getter 並呼叫 notifyPropertyChanged()。方法，如以下範例所示：

Kotlin

class User : BaseObservable() {

    @get:Bindable
    var firstName: String = ""
        set(value) {
            field = value
            notifyPropertyChanged(BR.firstName)
        }

    @get:Bindable
    var lastName: String = ""
        set(value) {
            field = value
            notifyPropertyChanged(BR.lastName)
        }
}

Java

private static class User extends BaseObservable {
    private String firstName;
    private String lastName;

    @Bindable
    public String getFirstName() {
        return this.firstName;
    }

    @Bindable
    public String getLastName() {
        return this.lastName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
        notifyPropertyChanged(BR.firstName);
    }

    public void setLastName(String lastName) {
        this.lastName = lastName;
        notifyPropertyChanged(BR.lastName);
    }
}

資料繫結會在模組套件中產生名為 BR 的類別，其中包含用於資料繫結的資源 ID。Bindable 註解在編譯期間，BR 類別檔案中會產生項目。如果基礎類別如果無法變更資料類別，可以實作 Observable 介面請使用 PropertyChangeRegistry 物件，以便有效率地註冊及通知事件監聽器。

生命週期感知物件

應用程式中的版面配置也可以繫結至自動繫結的資料繫結來源通知 UI 資料變更。如此一來生命週期感知，且只會在 UI 在畫面上顯示時觸發。

資料繫結支援 StateFlow 和 LiveData。如要進一步瞭解在資料繫結中使用 LiveData，請參閱「使用 LiveData 向 UI 通知資料變更。

使用 StateFlow

如果應用程式將 Kotlin 與協同程式搭配使用，您可以使用 StateFlow 物件做為資料繫結來源。如要搭配使用 StateFlow 物件和並指定生命週期擁有者 StateFlow 物件。以下範例會指定將活動設為繫結類別執行個體化後的生命週期擁有者：

class ViewModelActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        // Inflate view and obtain an instance of the binding class.
        val binding: UserBinding = DataBindingUtil.setContentView(this, R.layout.user)

        // Specify the current activity as the lifecycle owner.
        binding.lifecycleOwner = this
    }
}

如「將版面配置檢視畫面繫結至架構」一節所述元件、資料繫結可與 ViewModel 完美搭配運作如需儲存大量結構化物件建議使用 Cloud Bigtable您可以搭配使用 StateFlow 和 ViewModel，方法如下：

class ScheduleViewModel : ViewModel() {

    private val _username = MutableStateFlow<String>("")
    val username: StateFlow<String> = _username

    init {
        viewModelScope.launch {
            _username.value = Repository.loadUserName()
        }
    }
}

在版面配置中，將 ViewModel 物件的屬性和方法指派給使用繫結運算式對應的檢視畫面，如下所示範例：

<TextView
    android:id="@+id/name"
    android:text="@{viewmodel.username}" />

每當使用者名稱值變更時，UI 就會自動更新。

停用 StateFlow 支援功能

如果應用程式使用 Kotlin 和 AndroidX，系統會自動支援 StateFlow 繫結至資料繫結中這表示協同程式依附元件如果沒有可用的依附元件，就會自動納入您的應用程式。

如要停用這項功能，請在您的 build.gradle 檔案：

Groovy

android {
    ...
    dataBinding {
        addKtx = false
    }
}

Kotlin

android {
    ...
    dataBinding {
        addKtx = false
    }
}

或者，您也可以在專案中全面停用 StateFlow，方法是新增 gradle.properties 檔案中加入以下這行程式碼：

Groovy

android.defaults.databinding.addKtx = false

Kotlin

android.defaults.databinding.addKtx = false

其他資源

如要進一步瞭解資料繫結，請參閱以下其他資源：

使用可觀察的資料物件

可觀測欄位

Kotlin

Java

Kotlin

Java

可觀測的集合

Kotlin

Java

Kotlin

Java

可觀察物件

Kotlin

Java

生命週期感知物件

使用 StateFlow

停用 StateFlow 支援功能

Groovy

Kotlin

Groovy

Kotlin

其他資源

範例

程式碼研究室

網誌文章

為您推薦