ספריית 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);
}
}
מקורות מידע נוספים
כדי לקבל מידע נוסף על קישור נתונים, אפשר לעיין במקורות המידע הבאים.
מומלץ בשבילכם
- הערה: טקסט הקישור מוצג כש-JavaScript מושבת
- עבודה עם אובייקטים של נתונים גלויים
- טעינה והצגה של נתונים בדפים
- איך משתמשים בשגרות המשך (coroutine) של Kotlin עם רכיבים שמודעים למחזור החיים