Oluşturulan bağlama sınıfları

Veri Bağlama Kitaplığı, düzenin değişkenlerine ve görünümlerine erişmek için kullanabileceğiniz bağlama sınıfları oluşturur. Bu dokümanda, oluşturulan bağlama sınıflarının nasıl oluşturulacağı ve özelleştirileceği gösterilmektedir.

Oluşturulan bağlama sınıfı, düzen değişkenlerini düzendeki görünümlere bağlar. Bağlamanın adını ve paketini özelleştirebilirsiniz. Oluşturulan tüm bağlama sınıfları, ViewDataBinding sınıfından devralınır.

Her düzen dosyası için bir bağlama sınıfı oluşturulur. Varsayılan olarak sınıfın adı, PascalCase'e dönüştürülen ve Binding son eki eklenen düzen dosyasının adıdır. Örneğin, düzen dosyasının adı activity_main.xml ise oluşturulan ilgili sınıf ActivityMainBinding olur. Bu sınıf, düzen özelliklerinden düzenin görünümlerine kadar tüm bağlamaları içerir ve bağlama ifadeleri için değerlerin nasıl atanacağını bilir.

Bağlama nesnesi oluşturma

Bağlama nesnesi, düzeni şişirdikten hemen sonra oluşturulur. Böylece, görünüm hiyerarşisinin düzendeki ifadelerle görünümlere bağlanmadan önce değiştirilmemesi sağlanır. Nesneyi bir düzene bağlamanın en yaygın yöntemi, bağlama sınıfındaki statik yöntemleri kullanmaktır. Aşağıdaki örnekte gösterildiği gibi, bağlama sınıfının inflate() yöntemini kullanarak görünüm hiyerarşisini şişirebilir ve nesneyi buna bağlayabilirsiniz:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    val binding: MyLayoutBinding = MyLayoutBinding.inflate(layoutInflater)

    setContentView(binding.root)
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    MyLayoutBinding binding = MyLayoutBinding.inflate(getLayoutInflater());

    setContentView(binding.root);
}

Aşağıdaki örnekte gösterildiği gibi, LayoutInflater nesnesine ek olarak ViewGroup nesnesini alan inflate() yönteminin alternatif bir sürümü vardır:

Kotlin

val binding: MyLayoutBinding = MyLayoutBinding.inflate(getLayoutInflater(), viewGroup, false)

Java

MyLayoutBinding binding = MyLayoutBinding.inflate(getLayoutInflater(), viewGroup, false);

Düzen farklı bir mekanizma kullanılarak şişiriliyorsa aşağıdaki gibi ayrı olarak bağlayabilirsiniz:

Kotlin

val binding: MyLayoutBinding = MyLayoutBinding.bind(viewRoot)

Java

MyLayoutBinding binding = MyLayoutBinding.bind(viewRoot);

Bazen bağlama türünü önceden bilemezsiniz. Bu gibi durumlarda, aşağıdaki kod snippet'inde gösterildiği gibi DataBindingUtil sınıfını kullanarak bağlamayı oluşturabilirsiniz:

Kotlin

val viewRoot = LayoutInflater.from(this).inflate(layoutId, parent, attachToParent)
val binding: ViewDataBinding? = DataBindingUtil.bind(viewRoot)

Java

View viewRoot = LayoutInflater.from(this).inflate(layoutId, parent, attachToParent);
ViewDataBinding binding = DataBindingUtil.bind(viewRoot);

Fragment, ListView veya RecyclerView adaptöründe veri bağlama öğeleri kullanıyorsanız aşağıdaki kod örneğinde gösterildiği gibi bağlama sınıflarının inflate() yöntemlerini veya DataBindingUtil sınıfını kullanmayı tercih edebilirsiniz:

Kotlin

val listItemBinding = ListItemBinding.inflate(layoutInflater, viewGroup, false)
// or
val listItemBinding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false)

Java

ListItemBinding binding = ListItemBinding.inflate(layoutInflater, viewGroup, false);
// or
ListItemBinding binding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false);

Kimlik içeren görünümler

Veri Bağlama Kitaplığı, düzende kimliği olan her görünüm için bağlama sınıfında sabit bir alan oluşturur. Örneğin, Veri Bağlama Kitaplığı, aşağıdaki düzenden TextView türünde firstName ve lastName alanlarını oluşturur:

<layout xmlns:android="http://schemas.android.com/apk/res/android">
   <data>
       <variable name="user" type="com.example.User"/>
   </data>
   <LinearLayout
       android:orientation="vertical"
       android:layout_width="match_parent"
       android:layout_height="match_parent">
       <TextView android:layout_width="wrap_content"
           android:layout_height="wrap_content"
           android:text="@{user.firstName}"
   android:id="@+id/firstName"/>
       <TextView android:layout_width="wrap_content"
           android:layout_height="wrap_content"
           android:text="@{user.lastName}"
  android:id="@+id/lastName"/>
   </LinearLayout>
</layout>

Kitaplık, kimlikler de dahil olmak üzere görünümleri tek bir geçişte görünüm hiyerarşisinden çıkarır. Bu mekanizma, düzendeki her görünüm için findViewById() yöntemini çağırmaktan daha hızlı olabilir.

Kimlikler, veri bağlama olmadan kullanıldıkları kadar gerekli değildir ancak koddan görünümlere erişimin gerekli olduğu bazı durumlar vardır.

Değişkenler

Veri Bağlama Kitaplığı, düzende tanımlanan her değişken için erişim yöntemleri oluşturur. Örneğin, aşağıdaki düzen, user, image ve note değişkenleri için bağlama sınıfında ayarlayıcı ve alıcı yöntemleri oluşturur:

<data>
   <import type="android.graphics.drawable.Drawable"/>
   <variable name="user" type="com.example.User"/>
   <variable name="image" type="Drawable"/>
   <variable name="note" type="String"/>
</data>

ViewStubs

Normal görünümlerin aksine ViewStub nesneleri, görünmez görünümler olarak başlar. Görünür hale getirildiklerinde veya açıkça şişirildiklerinde, başka bir düzeni şişirerek düzendeki yerlerini alırlar.

ViewStub, görünüm hiyerarşisinden kaybolduğu için bağlama nesnesindeki görünüm de kaybolmalıdır. Böylece çöp toplama tarafından alınabilir. Görünümler nihai olduğundan, oluşturulan bağlama sınıfında ViewStub yerine bir ViewStubProxy nesnesi kullanılır. Bu sayede, mevcut olduğunda ViewStub'ye ve ViewStub şişirildiğinde şişirilmiş görünüm hiyerarşisine erişebilirsiniz.

Başka bir düzeni şişirirken yeni düzen için bir bağlama oluşturulmalıdır. Bu nedenle, ViewStubProxy, ViewStub öğesini dinlemeli OnInflateListener ve gerektiğinde bağlamayı oluşturmalıdır. Aynı anda yalnızca bir dinleyici olabileceğinden ViewStubProxy, bağlama işlemini tamamladıktan sonra çağıracağı bir OnInflateListener ayarlamanıza olanak tanır.

Anında bağlama

Bir değişken veya gözlemlenebilir nesne değiştiğinde bağlamanın bir sonraki kareden önce değişmesi planlanır. Ancak bağlamanın hemen yürütülmesi gereken zamanlar da vardır. Yürütmeyi zorunlu kılmak için executePendingBindings() yöntemini kullanın.

Dinamik değişkenler

Bazen belirli bağlama sınıfı bilinmez. Örneğin, rastgele düzenlere karşı çalışan bir RecyclerView.Adapter, belirli bağlama sınıfını bilmez. onBindViewHolder() yöntemine yapılan çağrı sırasında bağlama değerini atamalıdır.

Aşağıdaki örnekte, RecyclerView öğesinin bağlandığı tüm düzenlerde bir item değişkeni vardır. BindingHolder nesnesinin, ViewDataBinding temel sınıfını döndüren bir getBinding() yöntemi vardır.

Kotlin

override fun onBindViewHolder(holder: BindingHolder, position: Int) {
    item: T = items.get(position)
    holder.binding.setVariable(BR.item, item);
    holder.binding.executePendingBindings();
}

Java

public void onBindViewHolder(BindingHolder holder, int position) {
    final T item = items.get(position);
    holder.getBinding().setVariable(BR.item, item);
    holder.getBinding().executePendingBindings();
}

Arka plan iş parçacığı

Koleksiyon olmadığı sürece veri modelinizi arka plan iş parçacığında değiştirebilirsiniz. Veri bağlama, eşzamanlılık sorunlarını önlemek için değerlendirme sırasında her değişkeni veya alanı yerelleştirir.

Özel bağlama sınıfı adları

Varsayılan olarak, bağlama sınıfı düzen dosyasının adına göre oluşturulur. Ad büyük harfle başlar, alt çizgiler ( _) kaldırılır, sonraki harf büyük harfle yazılır ve Binding kelimesi eklenir. Örneğin, contact_item.xml düzen dosyası ContactItemBinding sınıfını oluşturur. Sınıf, modül paketinin altındaki bir databinding paketine yerleştirilir. Örneğin, modül paketi com.example.my.app ise bağlama sınıfı com.example.my.app.databinding paketine yerleştirilir.

Bağlama sınıfları, data öğesinin class özelliği ayarlanarak yeniden adlandırılabilir veya farklı paketlere yerleştirilebilir. Örneğin, aşağıdaki düzen, mevcut modüldeki databinding paketinde ContactItem bağlama sınıfını oluşturur:

<data class="ContactItem">
    ...
</data>

Sınıf adının önüne nokta ekleyerek bağlama sınıfını farklı bir pakette oluşturabilirsiniz. Aşağıdaki örnek, modül paketinde bağlama sınıfını oluşturur:

<data class=".ContactItem">
    ...
</data>

Bağlama sınıfının oluşturulmasını istediğiniz tam paket adını da kullanabilirsiniz. Aşağıdaki örnekte, com.example paketinde ContactItem bağlama sınıfı oluşturulur:

<data class="com.example.ContactItem">
    ...
</data>

Ek kaynaklar

Veri bağlama hakkında daha fazla bilgi edinmek için aşağıdaki ek kaynaklara bakın.