Android中正確儲存view的狀態

jcodecraeer發表於2016-01-09

今天我們聊一聊安卓中儲存和恢復view狀態的問題。我刻意強調View狀態是因為我發現這個過程要比儲存 Activity 和 Fragment狀態稍微複雜,還有一個原因是因為網上有太多“重複造的輪子”(有時還是奇醜無比的輪子)。

為什麼我們需要儲存View的狀態?

這個問題問的好!我堅信移動應用應該幫助你解決問題,而不是製造問題。

想象一下一個非常複雜的設定頁面:

android中正確儲存view的狀態

這並不是從一個移動應用的截圖(這不是典型的win32程式嗎。。),但是適合用於說明我們的問題:

這裡有非常多的文字輸入控制元件,多選框,開關(switch)等等,你花了15分鐘填完所有這些格子,總算輪到點選”完成”按鈕了,但是突然,你不小心旋轉了下螢幕,omg,所有的改動都沒了,一切都回歸到了初始狀態。

當然,總有一些使用者喜歡你的app簡直到不行,不在乎重新填一次。但是老實說,這樣做真的正確嗎?(原文有老外常喜歡的喋喋不休的幽默句子,略了)。

別犯傻,我們需要儲存使用者的修改,除非使用者特意讓我們不要這樣做。

如何儲存View的狀態?

假設我們這裡有一個帶有影像,文字和 Switch toggle控制元件的簡單佈局:

<LinearLayout  
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  
    android:orientation="horizontal"  
    android:padding="@dimen/activity_horizontal_margin">  
    <ImageView  
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"  
        android:src="@drawable/ic_launcher"/>  
    <TextView  
        android:layout_width="0dip"
        android:layout_weight="1"  
        android:layout_height="wrap_content"  
        android:text="My Text"/>  
    <Switch  
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"  
        android:layout_margin="8dip"/>  
</LinearLayout>

看吧,非常簡單的佈局。但是當我們滑動一下switch開關然後旋轉螢幕方向,switch又回到了原來的狀態。

通常,安卓會自動儲存這些View(一般是系統控制元件)的狀態,但是為什麼在我們的案例中不起作用了呢?

讓我們先停下來,弄明白安卓是如何管理View狀態的。這裡是正常情況下儲存與恢復的示意圖:

android中正確儲存view的狀態

  • saveHierarchyState(SparseArray<Parcelable> container)- 當狀態需要儲存的時候被安卓framework呼叫,通常會呼叫dispatchSaveInstanceState() 。
  • dispatchSaveInstanceState(SparseArray<Parcelable> container)- 被saveHierarchyState()呼叫。 在其內部呼叫onSaveInstanceState(),並且返回一個代表當前狀態的Parcelable。這個Parcelable被儲存在container引數中,container引數是一個鍵值對的map集合。View的ID是加鍵Parcelable是值。如果這是一個ViewGroup,還需要遍歷其子view,儲存子View的狀態。
  • Parcelable onSaveInstanceState()- 被 dispatchSaveInstanceState()呼叫。這個方法應該在View的實現中被重寫以返回實際的View狀態。
  • restoreHierarchyState(SparseArray<Parcelable> container)- 在需要恢復View狀態的時候被android呼叫,作為傳入的SparseArray引數,包含了在儲存過程中的所有view狀態。
  • dispatchRestoreInstanceState(SparseArray<Parcelable> container)- 被restoreHierarchyState()呼叫。根據View的ID找出相應的Parcelable,同時傳遞給onRestoreInstanceState()。如果這是一個ViewGroup,還要恢復其子View的資料。
  • onRestoreInstanceState(Parcelable state)- 被dispatchRestoreInstanceState()呼叫。如果container中有某個view,ViewID所對應的狀態被傳遞在這個方法中。

理解這個過程的重點是,container在整個view層級中是被共享的。我們將看到為什麼它這麼重要。

既然View的狀態是基於它的ID儲存的 , 因此如果一個VIew沒有ID,那麼將不會被儲存到container中。沒有儲存的支點(id),我們也無法恢復沒有ID的view的狀態,因為不知道這個狀態是屬於哪個View的。

    其實這是安卓的策略,假如我們來做也許會這樣設計,大致這樣:所有view按照一定的順序依次儲存,在恢復的時候只需知道這個View在儲存的時候的順序就可以了,不過顯然這樣要耗費更多的開銷。- 譯者注。

看樣子這就是switch開關狀態沒有被儲存的原因。那我們試試在switch開關上新增id(其他的View也加上id):

<LinearLayout  
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"  
    android:layout_height="match_parent"  
    android:orientation="horizontal"  
    android:padding="@dimen/activity_horizontal_margin">  
    <ImageView  
        android:id="@+id/image"
        android:layout_width="wrap_content"  
        android:layout_height="wrap_content"  
        android:src="@drawable/ic_launcher"/>  
    <TextView  
        android:id="@+id/text"
        android:layout_width="0dip"  
        android:layout_weight="1"  
        android:layout_height="wrap_content"  
        android:text="My Text"/>  
    <Switch  
        android:id="@+id/toggle"
        android:layout_width="wrap_content"  
        android:layout_height="wrap_content"  
        android:layout_margin="8dip"/>  
</LinearLayout>

ok,看結果,確實可行。在configuration changes期間狀態是可以保持的。下面是SparseArray的示意圖:

android中正確儲存view的狀態

就如你看到的那樣,每個view都有一個id來把狀態儲存在container的SparseArray中。

你可能會問這是如何發生的 – 我們並沒有提供任何Parcelable來代表狀態啊。答案是 – 安卓處理好了這個事情,安卓知道如何儲存系統自帶控制元件的狀態。 在經過上面的一番解釋之後,這句話來的太遲了吧 -譯者注。

除了ID之外,你還需要明確的告訴安卓你的view需要儲存狀態,呼叫setSaveEnabled(true)就可以了。通常你不需要對自帶的控制元件這樣做,但是如果你從開始開發一個自定義的view,則需要手動設定(setSaveEnabled)。

要儲存view的狀態,至少有兩點需要滿足:

  1. view要有id
  2. 要呼叫setSaveEnabled(true)

現在我們知道如何儲存自帶控制元件的狀態,但是如果我們有一些自定義的狀態,想在configuration變化的時候保持這些狀態又該如何呢?

儲存自定義的狀態

下面,讓我們舉一個更為複雜的例子。我想在繼承自Switch的的類中新增一個自定義的狀態:

public class CustomSwitch extends Switch {

    private int customState;//所謂狀態其實就是資料

    .......

    public void setCustomState(int customState) {
        this.customState = customState;
    }  
}

下面是我們將如何儲存這個狀態的過程:

public class CustomSwitch extends Switch {

    private int customState;

    .............

    public void setCustomState(int customState) {
        this.customState = customState;
    }

    @Override
    public Parcelable onSaveInstanceState() {
        Parcelable superState = super.onSaveInstanceState();
        SavedState ss = new SavedState(superState);  
        ss.state = customState;  
        return ss;  
    }

    @Override
    public void onRestoreInstanceState(Parcelable state) {
        SavedState ss = (SavedState) state;
        super.onRestoreInstanceState(ss.getSuperState());  
        setCustomState(ss.state);  
    }

    static class SavedState extends BaseSavedState {
        int state;

        SavedState(Parcelable superState) {  
            super(superState);
        }

        private SavedState(Parcel in) {
            super(in);
            state = in.readInt();  
        }

        @Override
        public void writeToParcel(Parcel out, int flags) {
            super.writeToParcel(out, flags);
            out.writeInt(state);  
        }

        public static final Parcelable.Creator<SavedState> CREATOR
                = new Parcelable.Creator<SavedState>() {
            public SavedState createFromParcel(Parcel in) {
                return new SavedState(in);
            }

            public SavedState[] newArray(int size) {
                return new SavedState[size];
            }  
        };
    }  
}

讓我來解釋一下上面所做的事情。

首先,既然重寫了onSaveInstanceState,我就必須呼叫其父類的相應方法讓父類儲存它想儲存的所有東西。在我的情況中,Switch將建立一個Parcelable,將狀態放進去然後返回給自己。不幸的是,我們無法在這個parcelable中新增更多的狀態,因此需要建立一個封裝類來封裝這個父類的狀態,然後放入額外的狀態。在安卓中有一個類(View.BaseSavedState)專門做這件事情 – 通過繼承它來實現儲存上一級的狀態同時允許你儲存自定義的屬性。

在onRestoreInstanceState()期間我們則需要做相反的事情 – 從指定的Parcelable中獲取上一級的狀態 ,同時讓你的父類通過呼叫super.onRestoreInstanceState(ss.getSuperState())來恢復它的狀態。之後我們才能恢復我們自己的狀態。

Since you override onSaveInstanceState() – always save super state – state of your super class.

View的ID必須唯一

現在我們決定將佈局放在一個自定義的view中達到重用的效果,然後在其他的佈局中include幾次:

注:這裡是include了兩次。

android中正確儲存view的狀態

當我們改變configuration之後,所有的狀態都一團糟了,讓我們看看在SparseArray中是什麼情況:

android中正確儲存view的狀態

哈哈!因為狀態的儲存是基於view id的,而SparseArray container是整個View層次結構中共享的 ,所以view的id必須唯一。否則你的狀態就會被另外一個具有相同id的view覆蓋。在這裡有兩個view的id都是@id/toggle,而container只持有一個它的例項- 儲存過程中最後到來的一個。

到了恢復資料的時候 – 這兩個view都從container那裡得到一個相同的狀態。

那麼該如何解決這個問題?

最直接的答案是  – 每個子view都具有獨立的SparseArray container,這樣就不會重疊了:

public class MyCustomLayout extends LinearLayout {

.........

    @Override
    public Parcelable onSaveInstanceState() {
        Parcelable superState = super.onSaveInstanceState();
        SavedState ss = new SavedState(superState);  
        ss.childrenStates = new SparseArray();  
        for (int i = 0; i < getChildCount(); i++) {  
            getChildAt(i).saveHierarchyState(ss.childrenStates);
        }  
        return ss;
    }

    @Override
    public void onRestoreInstanceState(Parcelable state) {
        SavedState ss = (SavedState) state;
        super.onRestoreInstanceState(ss.getSuperState());  
        for (int i = 0; i < getChildCount(); i++) {  
            getChildAt(i).restoreHierarchyState(ss.childrenStates);
        }  
    }

    @Override
    protected void dispatchSaveInstanceState(SparseArray<Parcelable> container) {
        dispatchFreezeSelfOnly(container);
    }

    @Override
    protected void dispatchRestoreInstanceState(SparseArray<Parcelable> container) {
        dispatchThawSelfOnly(container);
    }

    static class SavedState extends BaseSavedState {
        SparseArray childrenStates;

        SavedState(Parcelable superState) {  
            super(superState);
        }

        private SavedState(Parcel in, ClassLoader classLoader) {
            super(in);
            childrenStates = in.readSparseArray(classLoader);  
        }

        @Override
        public void writeToParcel(Parcel out, int flags) {
            super.writeToParcel(out, flags);
            out.writeSparseArray(childrenStates);  
        }

        public static final ClassLoaderCreator<SavedState> CREATOR
                = new ClassLoaderCreator<SavedState>() {
            @Override
            public SavedState createFromParcel(Parcel source, ClassLoader loader) {
                return new SavedState(source, loader);
            }

            @Override
            public SavedState createFromParcel(Parcel source) {
                return createFromParcel(null);
            }

            public SavedState[] newArray(int size) {
                return new SavedState[size];
            }  
        };
    }  
}

讓我們過一遍這段亂麻了的程式碼:

  • 在自定義的佈局中沒我建立了一個特殊的SaveState類,它持有父類狀態以及儲存子view狀態的獨立SparseArray。
  • 在onSaveInstanceState()中我主動儲存父類與子view的狀態到獨立的SparseArray中。
  • 在onRestoreInstanceState()中我主動從儲存期間建立的SparseArray中恢復父類和子view的狀態。
  • 記住如果這是一個ViewGroup – dispatchSaveInstanceState()還需要遍歷子View然後儲存它們的狀態嗎?既然我們現在是手動的了,我需要廢棄這種行為。幸運的是使用dispatchFreezeSelfOnly()方法可以告訴安卓只儲存viewGroup的狀態,不要碰它的子View(在dispatchSaveInstanceState()中呼叫)。
  • dispatchRestoreInstanceState()需要做同樣的事情 – 呼叫dispatchThawSelfOnly()。告訴安卓只恢復自身的狀態 ,子view我們自己來處理。

下面是SparseArray的示意圖:

android中正確儲存view的狀態

正如你看到的每個view group都有了獨自的SparseArray,因此他們就不會重疊和覆蓋彼此了。

狀態儲存了 賺大了!

這篇文章的程式碼可以在 GitHub上 找到。

相關文章