קישור תצוגות פריסה לרכיבי ארכיטקטורה

ספריית AndroidX כוללת את רכיבי הארכיטקטורה, שבעזרתם אפשר לעצב אפליקציות חזקות, שניתנות לבדיקה ולתחזוקה. ספריית Data Binding פועלת בצורה חלקה עם רכיבי הארכיטקטורה כדי לפשט עוד יותר את הפיתוח של ממשק המשתמש. הפריסות באפליקציה יכולות להתחבר לנתונים ברכיבי הארכיטקטורה, שעוזרים לנהל את מחזור החיים של בקר ממשק המשתמש ולשלוח לממשק המשתמש התראות על שינויים בנתונים.

במסמך הזה מוסבר איך לשלב את רכיבי הארכיטקטורה באפליקציה כדי להפיק את המקסימום מספריית קישור הנתונים.

שימוש ב-LiveData כדי להודיע לממשק המשתמש על שינויים בנתונים

אתם יכולים להשתמש באובייקטים מסוג LiveData כמקור הקישור לנתונים כדי להודיע באופן אוטומטי לממשק המשתמש על שינויים בנתונים. מידע נוסף על רכיב הארכיטקטורה הזה זמין בסקירה הכללית של LiveData.

בניגוד לאובייקטים שמטמיעים את Observable, כמו שדות שניתנים למעקב, אובייקטים מסוג LiveData מכירים את מחזור החיים של הצופים שנרשמו לשינויים בנתונים. הידע הזה מאפשר יתרונות רבים, שמוסברים במאמר היתרונות של שימוש ב-LiveData. ב-Android Studio בגרסה 3.1 ואילך, אתם יכולים להחליף שדות שניתנים למעקב באובייקטים של LiveData בקוד של קישור הנתונים.

כדי להשתמש באובייקט LiveData עם מחלקת הקישור, צריך לציין בעלים של מחזור חיים כדי להגדיר את ההיקף של האובייקט LiveData. בדוגמה הבאה, הפעילות מוגדרת כבעלים של מחזור החיים אחרי שנוצר מופע של מחלקת הקישור:

Kotlin

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.setLifecycleOwner(this)
    }
}

Java

class ViewModelActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // Inflate view and obtain an instance of the binding class.
        UserBinding binding = DataBindingUtil.setContentView(this, R.layout.user);

        // Specify the current activity as the lifecycle owner.
        binding.setLifecycleOwner(this);
    }
}

כדי לקשר את הנתונים לפריסה, אפשר להשתמש ברכיב ViewModel, כמו שמוסבר בקטע הבא. ברכיב ViewModel, אתם יכולים להשתמש באובייקט LiveData כדי לשנות את הנתונים או למזג כמה מקורות נתונים. בדוגמה הבאה אפשר לראות איך לשנות את הנתונים ב-ViewModel:

Kotlin

class ScheduleViewModel : ViewModel() {
    val userName: LiveData<String>

    init {
        val result = Repository.userName
        userName = Transformations.map(result) { result -> result.value }
    }
}

Java

class ScheduleViewModel extends ViewModel {
    LiveData<String> username;

    public ScheduleViewModel() {
        String result = Repository.userName;
        userName = Transformations.map(result, result -> result.value);
    }
}

שימוש ב-ViewModel לניהול נתונים שקשורים לממשק המשתמש

ספריית Data Binding פועלת בצורה חלקה עם רכיבי ViewModel. ה-ViewModel חושף את הנתונים שהפריסה צופה בהם ומגיבה לשינויים שלהם. שימוש ברכיבי ViewModel עם ספריית קישור הנתונים מאפשר להעביר את הלוגיקה של ממשק המשתמש מהפריסות לרכיבים, שקל יותר לבדוק אותם. ספריית Data Binding מבטיחה שהתצוגות מקושרות למקור הנתונים ומנותקות ממנו לפי הצורך. רוב העבודה שנותרה היא לוודא שאתם חושפים את הנתונים הנכונים. מידע נוסף על רכיב הארכיטקטורה הזה זמין בסקירה הכללית של ViewModel.

כדי להשתמש ברכיב ViewModel עם ספריית קישור הנתונים, צריך ליצור מופע של הרכיב, שיורש מהמחלקה ViewModel, לקבל מופע של מחלקת הקישור ולהקצות את הרכיב ViewModel למאפיין במחלקת הקישור. בדוגמה הבאה אפשר לראות איך משתמשים ברכיב עם הספרייה:

Kotlin

class ViewModelActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        // Obtain the ViewModel component.
        val userModel: UserModel by viewModels()

        // Inflate view and obtain an instance of the binding class.
        val binding: UserBinding = DataBindingUtil.setContentView(this, R.layout.user)

        // Assign the component to a property in the binding class.
        binding.viewmodel = userModel
    }
}

Java

class ViewModelActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        // Obtain the ViewModel component.
        UserModel userModel = new ViewModelProvider(this).get(UserModel.class);

        // Inflate view and obtain an instance of the binding class.
        UserBinding binding = DataBindingUtil.setContentView(this, R.layout.user);

        // Assign the component to a property in the binding class.
        binding.viewmodel = userModel;
    }
}

בפריסה, מקצים את המאפיינים והשיטות של הרכיב ViewModel לתצוגות המתאימות באמצעות ביטויי קישור, כמו בדוגמה הבאה:

<CheckBox
    android:id="@+id/rememberMeCheckBox"
    android:checked="@{viewmodel.rememberMe}"
    android:onCheckedChanged="@{() -> viewmodel.rememberMeChanged()}" />

שימוש ב-Observable ViewModel כדי לקבל יותר שליטה על מתאמי קישור

אתם יכולים להשתמש ברכיב ViewModel שמטמיע את הממשק Observable כדי להודיע לרכיבי אפליקציה אחרים על שינויים בנתונים, בדומה לאופן שבו הייתם משתמשים באובייקט LiveData.

יש מצבים שבהם עדיף להשתמש ברכיב ViewModel שמטמיע את הממשק Observable על פני שימוש באובייקטים של LiveData, גם אם מאבדים את יכולות ניהול מחזור החיים של LiveData. שימוש ברכיב ViewModel שמטמיע את Observable נותן לכם יותר שליטה על מתאמי הקישור באפליקציה. לדוגמה, התבנית הזו נותנת לכם יותר שליטה על ההתראות כשנתונים משתנים. היא גם מאפשרת לכם לציין שיטה מותאמת אישית להגדרת הערך של מאפיין בקישור נתונים דו-כיווני.

כדי להטמיע רכיב ViewModel שניתן לצפייה, צריך ליצור מחלקה שיורשת מהמחלקה ViewModel ומטמיעה את הממשק Observable. אתם יכולים לספק לוגיקה מותאמת אישית כשצופה נרשם להתראות או מבטל את ההרשמה אליהן באמצעות השיטות addOnPropertyChangedCallback() ו-removeOnPropertyChangedCallback(). אפשר גם לספק לוגיקה מותאמת אישית שפועלת כשמאפיינים משתנים ב-method‏ notifyPropertyChanged(). בדוגמת הקוד הבאה אפשר לראות איך מטמיעים ViewModel שניתן לצפייה:

Kotlin

/**
 * A ViewModel that is also an Observable,
 * to be used with the Data Binding Library.
 */
open class ObservableViewModel : ViewModel(), Observable {
    private val callbacks: PropertyChangeRegistry = PropertyChangeRegistry()

    override fun addOnPropertyChangedCallback(
            callback: Observable.OnPropertyChangedCallback) {
        callbacks.add(callback)
    }

    override fun removeOnPropertyChangedCallback(
            callback: Observable.OnPropertyChangedCallback) {
        callbacks.remove(callback)
    }

    /**
     * Notifies observers that all properties of this instance have changed.
     */
    fun notifyChange() {
        callbacks.notifyCallbacks(this, 0, null)
    }

    /**
     * Notifies observers that a specific property has changed. The getter for the
     * property that changes must be marked with the @Bindable annotation to
     * generate a field in the BR class to be used as the fieldId parameter.
     *
     * @param fieldId The generated BR id for the Bindable field.
     */
    fun notifyPropertyChanged(fieldId: Int) {
        callbacks.notifyCallbacks(this, fieldId, null)
    }
}

Java

/**
 * A ViewModel that is also an Observable,
 * to be used with the Data Binding Library.
 */
class ObservableViewModel extends ViewModel implements Observable {
    private PropertyChangeRegistry callbacks = new PropertyChangeRegistry();

    @Override
    protected void addOnPropertyChangedCallback(
            Observable.OnPropertyChangedCallback callback) {
        callbacks.add(callback);
    }

    @Override
    protected void removeOnPropertyChangedCallback(
            Observable.OnPropertyChangedCallback callback) {
        callbacks.remove(callback);
    }

    /**
     * Notifies observers that all properties of this instance have changed.
     */
    void notifyChange() {
        callbacks.notifyCallbacks(this, 0, null);
    }

    /**
     * Notifies observers that a specific property has changed. The getter for the
     * property that changes must be marked with the @Bindable annotation to
     * generate a field in the BR class to be used as the fieldId parameter.
     *
     * @param fieldId The generated BR id for the Bindable field.
     */
    void notifyPropertyChanged(int fieldId) {
        callbacks.notifyCallbacks(this, fieldId, null);
    }
}

מקורות מידע נוספים

כדי לקבל מידע נוסף על קישור נתונים, אפשר לעיין במקורות המידע הבאים.