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:
ObservableBooleanObservableByteObservableCharObservableShortObservableIntObservableLongObservableFloatObservableDoubleObservableParcelable
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<String, Object>"/>
</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<Object>"/>
</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ı
Sizin için önerilenler
- Not: JavaScript devre dışı olduğunda bağlantı metni gösterilir.
- ViewModel için SavedState modülü
- Düzen görünümlerini mimari bileşenlere bağlama
- Paging kitaplığına genel bakış