Biblioteka wiązania danych   Jest częścią Android Jetpack.

Biblioteka wiązania danych to biblioteka pomocnicza, która umożliwia wiązanie komponentów interfejsu w układach ze źródłami danych w aplikacji przy użyciu formatu deklaratywnego, a nie programistycznego.

Układy są często definiowane w aktywnościach za pomocą kodu, który wywołuje metody platformy UI. Na przykład ten kod wywołuje funkcję findViewById(), aby znaleźć widżet TextView i powiązać go z właściwością userName zmiennej viewModel:

Kotlin

findViewById<TextView>(R.id.sample_text).apply {
    text = viewModel.userName
}

Java

TextView textView = findViewById(R.id.sample_text);
textView.setText(viewModel.getUserName());

Poniższy przykład pokazuje, jak za pomocą biblioteki wiązania danych przypisać tekst do widżetu bezpośrednio w pliku układu. Dzięki temu nie trzeba wywoływać żadnego z powyższych kodów Java. Zwróć uwagę na użycie składni @{} w wyrażeniu przypisania:

<TextView
    android:text="@{viewmodel.userName}" />

Powiązanie komponentów w pliku układu pozwala usunąć wiele wywołań platformy UI w aktywnościach, dzięki czemu są one prostsze i łatwiejsze w utrzymaniu. Może to też poprawić wydajność aplikacji i pomóc w zapobieganiu wyciekom pamięci oraz wyjątkom wskaźnika o wartości null.

Korzystanie z biblioteki wiązania danych

Na tych stronach dowiesz się, jak używać biblioteki wiązania danych w aplikacjach na Androida.

Rozpocznij
Dowiedz się, jak przygotować środowisko programistyczne do pracy z biblioteką wiązania danych, w tym jak uzyskać obsługę kodu wiązania danych w Android Studio.

Układy i wyrażenia wiążące

Język wyrażeń umożliwia pisanie wyrażeń, które łączą zmienne z widokami w układzie. Biblioteka wiązania danych automatycznie generuje klasy wymagane do powiązania widoków w układzie z obiektami danych. Biblioteka udostępnia funkcje takie jak importy, zmienne i elementy include, których możesz używać w układach.

Te funkcje biblioteki bezproblemowo współistnieją z dotychczasowymi układami. Na przykład zmienne wiązania, których można używać w wyrażeniach, są definiowane w elemencie data, który jest elementem równorzędnym elementu głównego układu interfejsu. Oba elementy są opakowane w tag layout, jak w tym przykładzie:

<layout xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:app="http://schemas.android.com/apk/res-auto">
    <data>
        <variable
            name="viewmodel"
            type="com.myapp.data.ViewModel" />
    </data>
    <ConstraintLayout... /> <!-- UI layout's root element -->
</layout>

Praca z obiektami danych dostępnych do obserwacji
Biblioteka wiązania danych udostępnia klasy i metody do obserwowania zmian danych. Nie musisz się martwić o odświeżanie interfejsu, gdy zmienia się źródło danych. Możesz ustawić zmienne lub ich właściwości jako możliwe do obserwowania. Biblioteka umożliwia obserwowanie obiektów, pól lub kolekcji.
Wygenerowane klasy powiązań
Biblioteka wiązania danych generuje klasy wiązania, które służą do uzyskiwania dostępu do zmiennych i widoków układu. Na tej stronie dowiesz się, jak używać i dostosowywać wygenerowane klasy powiązań.
Adaptery wiązania

Dla każdego wyrażenia układu istnieje adapter wiązania, który wykonuje wywołania platformy wymagane do ustawienia odpowiednich właściwości lub detektorów. Na przykład adapter wiązania może wywołać metodę setText(), aby ustawić właściwość tekstową, lub metodę setOnClickListener(), aby dodać detektor do zdarzenia kliknięcia. Najpopularniejsze adaptery wiązania, takie jak adaptery właściwości android:text używane w przykładach na tej stronie, są dostępne w pakiecie android.databinding.adapters. Listę typowych adapterów wiązania znajdziesz w sekcji Adaptery. Możesz też tworzyć niestandardowe adaptery, jak w tym przykładzie:

Kotlin

@BindingAdapter("app:goneUnless")
fun goneUnless(view: View, visible: Boolean) {
    view.visibility = if (visible) View.VISIBLE else View.GONE
}

Java

@BindingAdapter("app:goneUnless")
public static void goneUnless(View view, Boolean visible) {
    view.visibility = visible ? View.VISIBLE : View.GONE;
}
Wiązanie widoków układu z komponentami architektury
Biblioteka pomocy Androida zawiera komponenty architektury, które można wykorzystać do projektowania niezawodnych, testowalnych i łatwych w utrzymaniu aplikacji. Możesz używać komponentów architektury z biblioteką wiązania danych, aby jeszcze bardziej uprościć tworzenie interfejsu.
Dwukierunkowe wiązanie danych
Biblioteka wiązania danych obsługuje dwukierunkowe wiązanie danych. Notacja używana w przypadku tego typu powiązania umożliwia otrzymywanie zmian danych we właściwości i jednoczesne nasłuchiwanie aktualizacji tej właściwości przez użytkownika.