Gözlemlenebilir veri nesneleriyle çalışma

Gözlemlenebilirlik, bir nesnenin verilerindeki değişiklikleri diğer nesnelere bildirme özelliğidir. Veri Bağlama Kitaplığı, nesneleri, alanları veya koleksiyonları gözlemlenebilir hale getirmenize olanak tanır.

Veri bağlama için herhangi bir nesneyi kullanabilirsiniz ancak nesneyi değiştirmek, kullanıcı arayüzünün otomatik olarak güncellenmesine neden olmaz. Veri bağlama özelliğini kullanarak veri nesnelerinize, verileri değiştiğinde diğer nesneleri (dinleyiciler olarak bilinir) bilgilendirme özelliği kazandırabilirsiniz. Üç tür gözlemlenebilir sınıf vardır: alanlar, koleksiyonlar ve nesneler.

Bu gözlemlenebilir veri nesnelerinden biri kullanıcı arayüzüne bağlıysa ve veri nesnesinin bir özelliği değişirse kullanıcı arayüzü otomatik olarak güncellenir.

Gözlemlenebilir alanlar

Sınıflarınızda yalnızca birkaç özellik varsa Observable arayüzünü uygulayan sınıflar oluşturmak için çaba harcamaya değmeyebilir. Bu durumda, alanları gözlemlenebilir hale getirmek için genel Observable sınıfını ve aşağıdaki temel türe özgü sınıfları kullanabilirsiniz:

Gözlemlenebilir alanlar, tek bir alanı olan bağımsız gözlemlenebilir nesnelerdir. Temel sürümler, erişim işlemleri sırasında kutulama ve kutudan çıkarma işlemlerini önler. Bu mekanizmayı kullanmak için Java programlama dilinde bir public final özelliği veya Kotlin'de salt okunur bir özellik oluşturun. Aşağıdaki örnekte bu gösterilmektedir:

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();
}

Alan değerine erişmek için set() ve get() erişim yöntemlerini veya Kotlin özellik söz dizimini kullanın:

Kotlin

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

Java

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

Gözlemlenebilir koleksiyonlar

Bazı uygulamalar, verileri tutmak için dinamik yapılar kullanır. Gözlemlenebilir koleksiyonlar, bir anahtar kullanarak bu yapılara erişim sağlar. ObservableArrayMap sınıfı, anahtarın String gibi bir referans türü olduğu durumlarda kullanışlıdır. Aşağıdaki örnekte bu durum gösterilmektedir:

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);

Düzende, aşağıdaki örnekte gösterildiği gibi dize anahtarlarını kullanarak haritayı bulabilirsiniz:

<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 sınıfı, anahtar bir tam sayı olduğunda kullanışlıdır. Örneğin:

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);

Düzende, aşağıdaki örnekte gösterildiği gibi dizinler aracılığıyla listeye erişebilirsiniz:

<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"/>

Gözlemlenebilir nesneler

Observable arayüzünü uygulayan bir sınıf, gözlemlenebilir nesneden özellik değişiklikleri hakkında bildirim almak isteyen dinleyicilerin kaydedilmesine olanak tanır.

Observable arayüzünde işleyici ekleme ve kaldırma mekanizması vardır ancak bildirimlerin ne zaman gönderileceğine siz karar verirsiniz. Geliştirme sürecini kolaylaştırmak için Veri Bağlama Kitaplığı, dinleyici kayıt mekanizmasını uygulayan BaseObservable sınıfını sağlar. BaseObservable uygulayan veri sınıfı, özellikler değiştiğinde bildirim göndermekten sorumludur. Bunu yapmak için alıcıya bir Bindable ek açıklaması atayın ve ayarlayıcıda notifyPropertyChanged() yöntemini çağırın. Aşağıdaki örnekte bu işlem gösterilmektedir:

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);
    }
}

Veri bağlama, modül paketinde BR adlı bir sınıf oluşturur. Bu sınıf, veri bağlama için kullanılan kaynakların kimliklerini içerir. Bindable ek açıklaması, derleme sırasında BR sınıf dosyasında bir giriş oluşturur. Veri sınıfları için temel sınıf değiştirilemiyorsa dinleyicileri verimli bir şekilde kaydetmek ve bilgilendirmek için PropertyChangeRegistry nesnesi kullanarak Observable arayüzünü uygulayabilirsiniz.

Yaşam döngüsüne duyarlı nesneler

Uygulamanızdaki düzenler, verilerdeki değişiklikleri kullanıcı arayüzüne otomatik olarak bildiren veri bağlama kaynaklarına da bağlanabilir. Bu sayede bağlamalarınız yaşam döngüsüne duyarlı olur ve yalnızca kullanıcı arayüzü ekranda görünürken tetiklenir.

Veri bağlama, StateFlow ve LiveData dillerini destekler. Veri bağlamada LiveData kullanımı hakkında daha fazla bilgi için Kullanıcı arayüzünü veri değişiklikleri hakkında bilgilendirmek için LiveData'yı kullanma başlıklı makaleyi inceleyin.

StateFlow'u kullanma

Uygulamanız eş yordamlarla Kotlin kullanıyorsa veri bağlama kaynağı olarak StateFlow nesnelerini kullanabilirsiniz. Bağlama sınıfınızla bir StateFlow nesnesi kullanmak için StateFlow nesnesinin kapsamını tanımlayacak bir yaşam döngüsü sahibi belirtin. Aşağıdaki örnekte, bağlama sınıfı örneklendirildikten sonra etkinliğin yaşam döngüsü sahibi olarak belirtilmesi gösterilmektedir:

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
    }
}

Düzen görünümlerini Mimari Bileşenleri'ne bağlama bölümünde açıklandığı gibi, veri bağlama ViewModel nesneleriyle sorunsuz bir şekilde çalışır. StateFlow ve ViewModel'i birlikte şu şekilde kullanabilirsiniz:

class ScheduleViewModel : ViewModel() {

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

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

Düzeninizde, aşağıdaki örnekte gösterildiği gibi bağlama ifadelerini kullanarak ViewModel nesnenizin özelliklerini ve yöntemlerini ilgili görünümlere atayın:

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

Kullanıcının ad değeri her değiştiğinde kullanıcı arayüzü otomatik olarak güncellenir.

StateFlow desteğini devre dışı bırakma

Kotlin ve AndroidX kullanan uygulamalarda StateFlow desteği, veri bağlama ile otomatik olarak eklenir. Bu, eş yordam bağımlılığının uygulamanızda henüz mevcut değilse otomatik olarak dahil edildiği anlamına gelir.

build.gradle dosyanıza aşağıdakileri ekleyerek bu işlevi devre dışı bırakabilirsiniz:

Modern

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

Kotlin

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

Alternatif olarak, gradle.properties dosyasına aşağıdaki satırı ekleyerek projenizde StateFlow özelliğini genel olarak devre dışı bırakabilirsiniz:

Modern

android.defaults.databinding.addKtx = false

Kotlin

android.defaults.databinding.addKtx = false

Ek kaynaklar

Veri bağlama hakkında daha fazla bilgi edinmek için aşağıdaki ek kaynaklara göz atın:

Örnekler

Blog yayınları