乐趣区

android状态管理优化

目录介绍

  • 01. 界面状态有哪些
  • 02. 采用 include 方式管理
  • 03. 在 Base 类中处理逻辑
  • 04. 如何降低偶性和入侵性
  • 05. 封装低入侵性状态库

    • 5.1 自定义帧布局
    • 5.2 自定义状态管理器
    • 5.3 如何管理多种状态
  • 06. 封装库极致优化点说明

    • 6.1 用 ViewStub 显示布局
    • 6.2 处理重新加载逻辑
  • 07. 如何使用该封装库

好消息

  • 博客笔记大汇总【16 年 3 月到至今】,包括 Java 基础及深入知识点,Android 技术博客,Python 学习笔记等等,还包括平时开发中遇到的 bug 汇总,当然也在工作之余收集了大量的面试题,长期更新维护并且修正,持续完善……开源的文件是 markdown 格式的!同时也开源了生活博客,从 12 年起,积累共计 N 篇 [近 100 万字,陆续搬到网上],转载请注明出处,谢谢!
  • 链接地址:https://github.com/yangchong2…
  • 如果觉得好,可以 star 一下,谢谢!当然也欢迎提出建议,万事起于忽微,量变引起质变!

01. 界面状态有哪些

  • 在 Android 中,不管是 activity 或者 fragment,在加载视图的时候都有可能会出现多种不同的状态页面 View。比如常见的就有这些:

    • 内容界面,也就是正常有数据页面
    • 加载数据中,加载 loading
    • 加载数据错误,请求数据异常
    • 加载后没有数据,请求数据为空
    • 没有网络,网络异常
  • 同时,思考一下几个问题。

    • 怎样切换界面状态?有些界面想定制自定义状态?状态如何添加点击事件?下面就为解决这些问题!
  • 为何要这样?

    • 一般在加载网络数据时,需要用户等待的场景,显示一个加载的 Loading 动画可以让用户知道 App 正在加载数据,而不是程序卡死,从而给用户较好的使用体验。
    • 当加载的数据为空时显示一个数据为空的视图、在数据加载失败时显示加载失败对应的 UI 并支持点击重试会比白屏的用户体验更好一些。
    • 加载中、加载失败、空数据等不同状态页面风格,一般来说在 App 内的所有页面中需要保持一致,也就是需要做到全局统一。

02. 采用 include 方式管理

  • 直接把这些界面 include 到 main 界面中,然后动态去切换界面,具体一点的做法如下所示。

    • 在布局中,会存放多个状态的布局。然后在页面中根据逻辑将对应的布局给显示或者隐藏,但存在诸多问题。
    <?xml version="1.0" encoding="utf-8"?>
    <LinearLayout
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:id="@+id/activity_main"
        android:orientation="vertical"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
    
        <!-- 正常时布局 -->
        <include layout="@layout/activity_content"/>
        <!-- 加载 loading 布局 -->
        <include layout="@layout/activity_loading"/>
        <!-- 异常时布局 -->
        <include layout="@layout/activity_error"/>
        <!-- 空数据时布局 -->
        <include layout="@layout/activity_emptydata"/>
    
    </LinearLayout>
  • 存在的问题分析

    • 后来发现这样处理不容易复用到其他项目中,代码复用性很低
    • 在 activity 中处理这些状态的显示和隐藏比较乱
    • 调用 setContentView 方法时,是将所有的布局给加载绘制出来。其实没有必要
    • 如果将逻辑写在 BaseActivity 中,利用子类继承父类特性,在父类中写切换状态,但有些界面如果没有继承父类,又该如何处理

03. 在 Base 类中处理逻辑

  • 首先是定义一个自定义的控件,比如把它命名成 LoadingView,然后在这个里面 include 一个布局,该布局包含一些不同状态的视图。代码思路如下所示:

    public class LoadingView extends LinearLayout implements View.OnClickListener {
    
        public static final int LOADING = 0;
        public static final int STOP_LOADING = 1;
        public static final int NO_DATA = 2;
        public static final int NO_NETWORK = 3;
        public static final int GONE = 4;
        public static final int LOADING_DIALOG = 5;
    
        private TextView mNoDataTextView;
        private ProgressBar mLoadingProgressBar;
        private RelativeLayout mRlError;
        private LinearLayout mLlLoading;
        private View mView;
    
        private OnRefreshListener mListener;
    
        public void setRefrechListener(OnRefreshListener mListener) {this.mListener = mListener;}
    
        public interface OnRefreshListener {void refresh();
        }
    
        public LoadingView(Context context) {super(context);
            init(context);
        }
    
        public LoadingView(Context context, AttributeSet attrs) {super(context, attrs);
            init(context);
        }
    
        public LoadingView(Context context, AttributeSet attrs, int defStyleAttr) {super(context, attrs, defStyleAttr);
            init(context);
        }
    
        private void init(Context context) {LayoutInflater inflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
            mView = inflater.inflate(R.layout.common_loading_get, this);
            mLoadingProgressBar = (ProgressBar) mView.findViewById(R.id.mLoadingProgressBar);
            mNoDataTextView  = (TextView) mView.findViewById(R.id.mNoDataTextView);
            mLlLoading = (LinearLayout) mView.findViewById(R.id.ll_loading);
            mRlError = (RelativeLayout) mView.findViewById(R.id.rl_error);
            mRlError.setOnClickListener(this);
            setStatue(GONE);
        }
    
        public void setStatue(int status) {setVisibility(View.VISIBLE);
            try {if (status == LOADING) {// 更新
                    mRlError.setVisibility(View.GONE);
                    mLlLoading.setVisibility(View.VISIBLE);
                } else if (status == STOP_LOADING) {setVisibility(View.GONE);
                } else if (status == NO_DATA) {// 无数据情况
                    mRlError.setVisibility(View.VISIBLE);
                    mLlLoading.setVisibility(View.GONE);
                    mNoDataTextView.setText("暂无数据");
                } else if (status == NO_NETWORK) {// 无网络情况
                    mRlError.setVisibility(View.VISIBLE);
                    mLlLoading.setVisibility(View.GONE);
                    mNoDataTextView.setText("网络加载失败,点击重新加载");
                } else {setVisibility(View.GONE);
                }
            } catch (OutOfMemoryError e) {}}
    
        @Override
        public void onClick(View v) {mListener.refresh();
            setStatue(LOADING);
        }
    }
  • 然后在 BaseActivity/BaseFragment 中封装 LoadingView 的初始化逻辑,并封装加载状态切换时的 UI 显示逻辑,暴露给子类以下方法:

    void showLoading(); // 调用此方法显示加载中的动画
    void showLoadFailed(); // 调用此方法显示加载失败界面
    void showEmpty(); // 调用此方法显示空页面
    void onClickRetry(); // 子类中实现,点击重试的回调方法 
    • 在 BaseActivity/BaseFragment 的子类中可通过上一步的封装比较方便地使用加载状态显示功能。这种使用方式耦合度太高,每个页面的布局文件中都需要添加 LoadingView,使用起来不方便而且维护成本较高,比如说有时候异常状态的布局各个页面不同,那么难以自定义处理,修改起来成本较高。
    • 同时如果是要用这种状态管理工具,则需要在需要的页面布局中添加该 LoadingView 视图。这样也能够完成需求,但是感觉有点麻烦。
  • 具体如何使用它进行状态管理呢?可以看到在对应的布局中需要写上 LoadingView

    <?xml version="1.0" encoding="utf-8"?>
    <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
    
        <com.cheoo.app.view.recyclerview.TypeRecyclerView
            android:id="@+id/mRecyclerView"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:overScrollMode="never"
            android:scrollbars="none">
    
        </com.cheoo.app.view.recyclerview.TypeRecyclerView>
    
        <com.cheoo.app.view.LoadingView
            android:id="@+id/mLoadingView"
            android:layout_width="match_parent"
            android:layout_height="match_parent" />
    
    </RelativeLayout>
  • 那么,如果某个子类不想继承 BaseActivity 类,如何使用该状态管理器呢?代码中可以这种使用。

    mLoadingView  = (LoadingView)findViewById(R.id.mLoadingView);
    mLoadingView.setStatue(LoadingView.LOADING);
    mLoadingView.setStatue(LoadingView.STOP_LOADING);
    mLoadingView.setStatue(LoadingView.NO_NETWORK);
    mLoadingView.setStatue(LoadingView.NO_DATA);

04. 如何降低偶性和入侵性

  • 让 View 状态的切换和 Activity 彻底分离开,必须把这些状态 View 都封装到一个管理类中,然后暴露出几个方法来实现 View 之间的切换。

在不同的项目中可以需要的 View 也不一样,所以考虑把管理类设计成 builder 模式来自由的添加需要的状态 View。

  • 那么如何降低耦合性,让代码入侵性低。方便维护和修改,且移植性强呢?大概具备这样的条件……

    • 可以运用在 activity 或者 fragment 中
    • 不需要在布局中添加 LoadingView,而是统一管理不同状态视图,同时暴露对外设置自定义状态视图方法,方便 UI 特定页面定制
    • 支持设置自定义不同状态视图,即使在 BaseActivity 统一处理状态视图管理,也支持单个页面定制
    • 在加载视图的时候像异常和空页面能否用 ViewStub 代替,这样减少绘制,只有等到出现异常和空页面时,才将视图给 inflate 出来
    • 当页面出现网络异常页面,空页面等,页面会有交互事件,这时候可以设置点击设置网络或者点击重新加载等等

05. 封装低入侵性状态库

5.1 自定义帧布局

  • 首先需要自定义一个状态 StateFrameLayout 布局,它是继承 FrameLayout。在这个类中,目前是设置五种不同状态的视图布局,主要的功能操作是显示或者隐藏布局。为了后期代码维护性,根据面向对象的思想,类尽量保证单一职责,所以关于状态切换,以及设置自定义状态布局,把这个功能分离处理,放到一个 StateLayoutManager 中处理。

    • 看代码可知,这个类的功能非常明确,就是隐藏或者展示视图作用。
    /**
     * <pre>
     *     @author yangchong
     *     blog  : https://github.com/yangchong211/YCStateLayout
     *     time  : 2017/7/6
     *     desc  : 自定义帧布局
     *     revise:
     * </pre>
     */
    public class StateFrameLayout extends FrameLayout {
    
        /**
         *  loading 加载 id
         */
        public static final int LAYOUT_LOADING_ID = 1;
    
        /**
         *  内容 id
         */
        public static final int LAYOUT_CONTENT_ID = 2;
    
        /**
         *  异常 id
         */
        public static final int LAYOUT_ERROR_ID = 3;
    
        /**
         *  网络异常 id
         */
        public static final int LAYOUT_NETWORK_ERROR_ID = 4;
    
        /**
         *  空数据 id
         */
        public static final int LAYOUT_EMPTY_DATA_ID = 5;
    
        /**
         *  存放布局集合
         */
        private SparseArray<View> layoutSparseArray = new SparseArray<>();
    
        //private HashMap<Integer,View> map = new HashMap<>();
    
        /**
         *  布局管理器
         */
        private StateLayoutManager mStatusLayoutManager;
    
    
        public StateFrameLayout(Context context) {super(context);
        }
    
        public StateFrameLayout(Context context, AttributeSet attrs) {super(context, attrs);
        }
    
        public StateFrameLayout(Context context, AttributeSet attrs, int defStyleAttr) {super(context, attrs, defStyleAttr);
        }
    
    
        public void setStatusLayoutManager(StateLayoutManager statusLayoutManager) {
            mStatusLayoutManager = statusLayoutManager;
            // 添加所有的布局到帧布局
            addAllLayoutToRootLayout();}
    
        private void addAllLayoutToRootLayout() {if (mStatusLayoutManager.contentLayoutResId != 0) {addLayoutResId(mStatusLayoutManager.contentLayoutResId, StateFrameLayout.LAYOUT_CONTENT_ID);
            }
            if (mStatusLayoutManager.loadingLayoutResId != 0) {addLayoutResId(mStatusLayoutManager.loadingLayoutResId, StateFrameLayout.LAYOUT_LOADING_ID);
            }
    
            if (mStatusLayoutManager.emptyDataVs != null) {addView(mStatusLayoutManager.emptyDataVs);
            }
            if (mStatusLayoutManager.errorVs != null) {addView(mStatusLayoutManager.errorVs);
            }
            if (mStatusLayoutManager.netWorkErrorVs != null) {addView(mStatusLayoutManager.netWorkErrorVs);
            }
        }
    
        private void addLayoutResId(@LayoutRes int layoutResId, int id) {View resView = LayoutInflater.from(mStatusLayoutManager.context).inflate(layoutResId, null);
            layoutSparseArray.put(id, resView);
            addView(resView);
        }
    
        /**
         *  显示 loading
         */
        public void showLoading() {if (layoutSparseArray.get(LAYOUT_LOADING_ID) != null) {showHideViewById(LAYOUT_LOADING_ID);
            }
        }
    
        /**
         *  显示内容
         */
        public void showContent() {if (layoutSparseArray.get(LAYOUT_CONTENT_ID) != null) {showHideViewById(LAYOUT_CONTENT_ID);
            }
        }
    
        /**
         *  显示空数据
         */
        public void showEmptyData(int iconImage, String textTip) {if (inflateLayout(LAYOUT_EMPTY_DATA_ID)) {showHideViewById(LAYOUT_EMPTY_DATA_ID);
                emptyDataViewAddData(iconImage, textTip);
            }
        }
    
    
        /**
         * 根据 ID 显示隐藏布局
         * @param id                        id 值
         */
        private void showHideViewById(int id) {for (int i = 0; i < layoutSparseArray.size(); i++) {int key = layoutSparseArray.keyAt(i);
                View valueView = layoutSparseArray.valueAt(i);
                // 显示该 view
                if(key == id) {valueView.setVisibility(View.VISIBLE);
                    if(mStatusLayoutManager.onShowHideViewListener != null) {mStatusLayoutManager.onShowHideViewListener.onShowView(valueView, key);
                    }
                } else {if(valueView.getVisibility() != View.GONE) {valueView.setVisibility(View.GONE);
                        if(mStatusLayoutManager.onShowHideViewListener != null) {mStatusLayoutManager.onShowHideViewListener.onHideView(valueView, key);
                        }
                    }
                }
            }
        }
    
        /**
         * 这个是处理 ViewStub 的逻辑,主要有网络异常布局,加载异常布局,空数据布局
         * @param id                        布局 id
         * @return                          布尔值
         */
        private boolean inflateLayout(int id) {
            boolean isShow = true;
            // 如果为 null,则直接返回 false
            if (layoutSparseArray.get(id) == null) {return false;}
            switch (id) {
                case LAYOUT_NETWORK_ERROR_ID:
                    if (mStatusLayoutManager.netWorkErrorVs != null) {View view = mStatusLayoutManager.netWorkErrorVs.inflate();
                        retryLoad(view, mStatusLayoutManager.netWorkErrorRetryViewId);
                        layoutSparseArray.put(id, view);
                        isShow = true;
                    } else {isShow = false;}
                    break;
                case LAYOUT_ERROR_ID:
                    if (mStatusLayoutManager.errorVs != null) {View view = mStatusLayoutManager.errorVs.inflate();
                        if (mStatusLayoutManager.errorLayout != null) {mStatusLayoutManager.errorLayout.setView(view);
                        }
                        retryLoad(view, mStatusLayoutManager.errorRetryViewId);
                        layoutSparseArray.put(id, view);
                        isShow = true;
                    } else {isShow = false;}
                    break;
                case LAYOUT_EMPTY_DATA_ID:
                    if (mStatusLayoutManager.emptyDataVs != null) {View view = mStatusLayoutManager.emptyDataVs.inflate();
                        if (mStatusLayoutManager.emptyDataLayout != null) {mStatusLayoutManager.emptyDataLayout.setView(view);
                        }
                        retryLoad(view, mStatusLayoutManager.emptyDataRetryViewId);
                        layoutSparseArray.put(id, view);
                        isShow = true;
                    } else {isShow = false;}
                    break;
                default:
                    break;
            }
            return isShow;
        }
    }

5.2 自定义状态管理器

  • 上面状态的自定义布局创建出来了,而且隐藏和展示都做了。那么如何控制设置自定义视图布局,还有如何控制不同布局之间切换,那么就需要用到这个类呢!https://github.com/yangchong2…

    • loadingLayoutResId 和 contentLayoutResId 代表等待加载和显示内容的 xml 文件
    • 几种异常状态要用 ViewStub,因为在界面状态切换中 loading 和内容 View 都是一直需要加载显示的,但是其他的 3 个只有在没数据或者网络异常的情况下才会加载显示,所以用 ViewStub 来加载他们可以提高性能。
    • 采用 builder 模式,十分简单,代码如下所示。创建 StateFrameLayout 对象,然后再设置 setStatusLayoutManager,这一步操作是传递一个 Manager 对象到 StateFrameLayout,建立连接。
    public final class StateLayoutManager {
    
        final Context context;
    
        final int netWorkErrorRetryViewId;
        final int emptyDataRetryViewId;
        final int errorRetryViewId;
        final int loadingLayoutResId;
        final int contentLayoutResId;
        final int retryViewId;
        final int emptyDataIconImageId;
        final int emptyDataTextTipId;
        final int errorIconImageId;
        final int errorTextTipId;
    
        final ViewStub emptyDataVs;
        final ViewStub netWorkErrorVs;
        final ViewStub errorVs;
        final AbsViewStubLayout errorLayout;
        final AbsViewStubLayout emptyDataLayout;
    
        private final StateFrameLayout rootFrameLayout;
        final OnShowHideViewListener onShowHideViewListener;
        final OnRetryListener onRetryListener;
    
        public static Builder newBuilder(Context context) {return new Builder(context);
        }
    
        private StateLayoutManager(Builder builder) {
            this.context = builder.context;
            this.loadingLayoutResId = builder.loadingLayoutResId;
            this.netWorkErrorVs = builder.netWorkErrorVs;
            this.netWorkErrorRetryViewId = builder.netWorkErrorRetryViewId;
            this.emptyDataVs = builder.emptyDataVs;
            this.emptyDataRetryViewId = builder.emptyDataRetryViewId;
            this.errorVs = builder.errorVs;
            this.errorRetryViewId = builder.errorRetryViewId;
            this.contentLayoutResId = builder.contentLayoutResId;
            this.onShowHideViewListener = builder.onShowHideViewListener;
            this.retryViewId = builder.retryViewId;
            this.onRetryListener = builder.onRetryListener;
            this.emptyDataIconImageId = builder.emptyDataIconImageId;
            this.emptyDataTextTipId = builder.emptyDataTextTipId;
            this.errorIconImageId = builder.errorIconImageId;
            this.errorTextTipId = builder.errorTextTipId;
            this.errorLayout = builder.errorLayout;
            this.emptyDataLayout = builder.emptyDataLayout;
    
            // 创建帧布局
            rootFrameLayout = new StateFrameLayout(this.context);
            ViewGroup.LayoutParams layoutParams = new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
            rootFrameLayout.setLayoutParams(layoutParams);
    
            // 设置状态管理器
            rootFrameLayout.setStatusLayoutManager(this);
        }
    
    
        /**
         * 显示 loading
         */
        public void showLoading() {rootFrameLayout.showLoading();
        }
    
        /**
         * 显示内容
         */
        public void showContent() {rootFrameLayout.showContent();
        }
    
        /**
         * 显示空数据
         */
        public void showEmptyData(int iconImage, String textTip) {rootFrameLayout.showEmptyData(iconImage, textTip);
        }
    
        /**
         * 显示空数据
         */
        public void showEmptyData() {showEmptyData(0, "");
        }
    
        /**
         * 显示空数据
         */
        public void showLayoutEmptyData(Object... objects) {rootFrameLayout.showLayoutEmptyData(objects);
        }
    
        /**
         * 显示网络异常
         */
        public void showNetWorkError() {rootFrameLayout.showNetWorkError();
        }
    
        /**
         * 显示异常
         */
        public void showError(int iconImage, String textTip) {rootFrameLayout.showError(iconImage, textTip);
        }
    
        /**
         * 显示异常
         */
        public void showError() {showError(0, "");
        }
    
        public void showLayoutError(Object... objects) {rootFrameLayout.showLayoutError(objects);
        }
    
        /**
         * 得到 root 布局
         */
        public View getRootLayout() {return rootFrameLayout;}
    
        public static final class Builder {
    
            private Context context;
            private int loadingLayoutResId;
            private int contentLayoutResId;
            private ViewStub netWorkErrorVs;
            private int netWorkErrorRetryViewId;
            private ViewStub emptyDataVs;
            private int emptyDataRetryViewId;
            private ViewStub errorVs;
            private int errorRetryViewId;
            private int retryViewId;
            private int emptyDataIconImageId;
            private int emptyDataTextTipId;
            private int errorIconImageId;
            private int errorTextTipId;
            private AbsViewStubLayout errorLayout;
            private AbsViewStubLayout emptyDataLayout;
            private OnShowHideViewListener onShowHideViewListener;
            private OnRetryListener onRetryListener;
    
            Builder(Context context) {this.context = context;}
    
            /**
             * 自定义加载布局
             */
            public Builder loadingView(@LayoutRes int loadingLayoutResId) {
                this.loadingLayoutResId = loadingLayoutResId;
                return this;
            }
    
            /**
             * 自定义网络错误布局
             */
            public Builder netWorkErrorView(@LayoutRes int newWorkErrorId) {netWorkErrorVs = new ViewStub(context);
                netWorkErrorVs.setLayoutResource(newWorkErrorId);
                return this;
            }
    
            /**
             * 自定义加载空数据布局
             */
            public Builder emptyDataView(@LayoutRes int noDataViewId) {emptyDataVs = new ViewStub(context);
                emptyDataVs.setLayoutResource(noDataViewId);
                return this;
            }
    
            /**
             * 自定义加载错误布局
             */
            public Builder errorView(@LayoutRes int errorViewId) {errorVs = new ViewStub(context);
                errorVs.setLayoutResource(errorViewId);
                return this;
            }
    
            /**
             * 自定义加载内容正常布局
             */
            public Builder contentView(@LayoutRes int contentLayoutResId) {
                this.contentLayoutResId = contentLayoutResId;
                return this;
            }
    
            public Builder errorLayout(AbsViewStubLayout errorLayout) {
                this.errorLayout = errorLayout;
                this.errorVs = errorLayout.getLayoutVs();
                return this;
            }
    
            public Builder emptyDataLayout(AbsViewStubLayout emptyDataLayout) {
                this.emptyDataLayout = emptyDataLayout;
                this.emptyDataVs = emptyDataLayout.getLayoutVs();
                return this;
            }
    
            public Builder netWorkErrorRetryViewId(@LayoutRes int netWorkErrorRetryViewId) {
                this.netWorkErrorRetryViewId = netWorkErrorRetryViewId;
                return this;
            }
    
            public Builder emptyDataRetryViewId(@LayoutRes int emptyDataRetryViewId) {
                this.emptyDataRetryViewId = emptyDataRetryViewId;
                return this;
            }
    
            public Builder errorRetryViewId(@LayoutRes int errorRetryViewId) {
                this.errorRetryViewId = errorRetryViewId;
                return this;
            }
    
            public Builder retryViewId(@LayoutRes int retryViewId) {
                this.retryViewId = retryViewId;
                return this;
            }
    
            public Builder emptyDataIconImageId(@LayoutRes int emptyDataIconImageId) {
                this.emptyDataIconImageId = emptyDataIconImageId;
                return this;
            }
    
            public Builder emptyDataTextTipId(@LayoutRes int emptyDataTextTipId) {
                this.emptyDataTextTipId = emptyDataTextTipId;
                return this;
            }
    
            public Builder errorIconImageId(@LayoutRes int errorIconImageId) {
                this.errorIconImageId = errorIconImageId;
                return this;
            }
    
            public Builder errorTextTipId(@LayoutRes int errorTextTipId) {
                this.errorTextTipId = errorTextTipId;
                return this;
            }
    
            /**
             * 为状态 View 显示隐藏监听事件
             * @param listener                  listener
             * @return
             */
            public Builder onShowHideViewListener(OnShowHideViewListener listener) {
                this.onShowHideViewListener = listener;
                return this;
            }
    
            /**
             * 为重试加载按钮的监听事件
             * @param onRetryListener           listener
             * @return
             */
            public Builder onRetryListener(OnRetryListener onRetryListener) {
                this.onRetryListener = onRetryListener;
                return this;
            }
    
            /**
             * 创建对象
             * @return
             */
            public StateLayoutManager build() {return new StateLayoutManager(this);
            }
        }
    
    }

5.3 如何管理多种状态

  • 大约 5 种状态,如何管理这些状态?添加到集合中,Android 中选用 SparseArray 比 HashMap 更省内存,在某些条件下性能更好,主要是因为它避免了对 key 的自动装箱(int 转为 Integer 类型),它内部则是通过两个数组来进行数据存储的,一个存储 key,另外一个存储 value,为了优化性能,它内部对数据还采取了压缩的方式来表示稀疏数组的数据,从而节约内存空间

    /** 存放布局集合 */
    private SparseArray<View> layoutSparseArray = new SparseArray();
    
    /** 将布局添加到集合 */
    private void addLayoutResId(@LayoutRes int layoutResId, int id) {View resView = LayoutInflater.from(mStatusLayoutManager.context).inflate(layoutResId, null);
        layoutSparseArray.put(id, resView);
        addView(resView);
    }
    
    // 那么哪里从集合中取数据呢
    public void showContent() {if (layoutSparseArray.get(LAYOUT_CONTENT_ID) != null) {showHideViewById(LAYOUT_CONTENT_ID);
        }
    }

06. 封装库极致优化点说明

6.1 用 ViewStub 显示布局

  • 方法里面通过 id 判断来执行不同的代码,首先判断 ViewStub 是否为空,如果为空就代表没有添加这个 View 就返回 false,不为空就加载 View 并且添加到集合当中,然后调用 showHideViewById 方法显示隐藏 View,retryLoad 方法是给重试按钮添加事件

    • 注意,即使当你设置了多种不同状态视图,调用 setContentView 的时候,因为异常页面使用 ViewStub,所以在绘制的时候不会影响性能的。
    /**
    *  显示 loading
    */
    public void showLoading() {if (layoutSparseArray.get(LAYOUT_LOADING_ID) != null)
            showHideViewById(LAYOUT_LOADING_ID);
    }
    
    /**
    *  显示内容
    */
    public void showContent() {if (layoutSparseArray.get(LAYOUT_CONTENT_ID) != null)
            showHideViewById(LAYOUT_CONTENT_ID);
    }
    
    // 调用 inflateLayout 方法,方法返回 true 然后调用 showHideViewById 方法
    private boolean inflateLayout(int id) {
        boolean isShow = true;
        if (layoutSparseArray.get(id) != null) return isShow;
        switch (id) {
            case LAYOUT_NETWORK_ERROR_ID:
                if (mStatusLayoutManager.netWorkErrorVs != null) {View view = mStatusLayoutManager.netWorkErrorVs.inflate();
                    retryLoad(view, mStatusLayoutManager.netWorkErrorRetryViewId);
                    layoutSparseArray.put(id, view);
                    isShow = true;
                } else {isShow = false;}
                break;
            case LAYOUT_ERROR_ID:
                if (mStatusLayoutManager.errorVs != null) {View view = mStatusLayoutManager.errorVs.inflate();
                    if (mStatusLayoutManager.errorLayout != null) mStatusLayoutManager.errorLayout.setView(view);
                    retryLoad(view, mStatusLayoutManager.errorRetryViewId);
                    layoutSparseArray.put(id, view);
                    isShow = true;
                } else {isShow = false;}
                break;
            case LAYOUT_EMPTYDATA_ID:
                if (mStatusLayoutManager.emptyDataVs != null) {View view = mStatusLayoutManager.emptyDataVs.inflate();
                    if (mStatusLayoutManager.emptyDataLayout != null) mStatusLayoutManager.emptyDataLayout.setView(view);
                    retryLoad(view, mStatusLayoutManager.emptyDataRetryViewId);
                    layoutSparseArray.put(id, view);
                    isShow = true;
                } else {isShow = false;}
                break;
        }
        return isShow;
    }

6.2 处理重新加载逻辑

  • 最后看看重新加载方法

    /**
    *  重试加载
    */
    private void retryLoad(View view, int id) {View retryView = view.findViewById(mStatusLayoutManager.retryViewId != 0 ? mStatusLayoutManager.retryViewId : id);
        if (retryView == null || mStatusLayoutManager.onRetryListener == null) return;
        retryView.setOnClickListener(new OnClickListener() {
            @Override
            public void onClick(View v) {mStatusLayoutManager.onRetryListener.onRetry();
            }
        });
    }

07. 如何使用该封装库

  • 可以自由切换内容,空数据,异常错误,加载,网络错误等 5 种状态。父类 BaseActivity 直接暴露 5 中状态,方便子类统一管理状态切换,这里 fragment 的封装和 activity 差不多。

    /**
    * ================================================
    * 作    者:杨充
    * 版    本:1.0
    * 创建日期:2017/7/6
    * 描    述:抽取类
    * 修订历史:
*/
public abstract class BaseActivity extends AppCompatActivity {

    protected StatusLayoutManager statusLayoutManager;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_base_view);
        initStatusLayout();
        initBaseView();
        initToolBar();
        initView();}
    
    // 子类必须重写该方法
    protected abstract void initStatusLayout();

    protected abstract void initView();

    /**
    * 获取到布局
    */
    private void initBaseView() {LinearLayout ll_main = (LinearLayout) findViewById(R.id.ll_main);
        ll_main.addView(statusLayoutManager.getRootLayout());
    }

    // 正常展示数据状态
    protected void showContent() {statusLayoutManager.showContent();
    }

    // 加载数据为空时状态
    protected void showEmptyData() {statusLayoutManager.showEmptyData();
    }

    // 加载数据错误时状态
    protected void showError() {statusLayoutManager.showError();
    }

    // 网络错误时状态
    protected void showNetWorkError() {statusLayoutManager.showNetWorkError();
    }

    // 正在加载中状态
    protected void showLoading() {statusLayoutManager.showLoading();
    }
}
```
  • 子类继承 BaseActivity 后,该如何操作呢?具体如下所示

    @Override
    protected void initStatusLayout() {statusLayoutManager = StateLayoutManager.newBuilder(this)
                .contentView(R.layout.activity_main)
                .emptyDataView(R.layout.activity_emptydata)
                .errorView(R.layout.activity_error)
                .loadingView(R.layout.activity_loading)
                .netWorkErrorView(R.layout.activity_networkerror)
                .build();}
    
    // 或者添加上监听事件
    @Override
    protected void initStatusLayout() {statusLayoutManager = StateLayoutManager.newBuilder(this)
                .contentView(R.layout.activity_content_data)
                .emptyDataView(R.layout.activity_empty_data)
                .errorView(R.layout.activity_error_data)
                .loadingView(R.layout.activity_loading_data)
                .netWorkErrorView(R.layout.activity_networkerror)
                .onRetryListener(new OnRetryListener() {
                    @Override
                    public void onRetry() {// 为重试加载按钮的监听事件}
                })
                .onShowHideViewListener(new OnShowHideViewListener() {
                    @Override
                    public void onShowView(View view, int id) {// 为状态 View 显示监听事件}
    
                    @Override
                    public void onHideView(View view, int id) {// 为状态 View 隐藏监听事件}
                })
                .build();}
    
    // 如何切换状态呢?showContent();
    showEmptyData();
    showError();
    showLoading();
    showNetWorkError();
    
    // 或者这样操作也可以
    statusLayoutManager.showLoading();
    statusLayoutManager.showContent();
  • 那么如何设置状态页面的交互事件呢?当状态是加载数据失败时,点击可以刷新数据;当状态是无网络时,点击可以设置网络。代码如下所示:

    /**
*/
private void initErrorDataView() {statusLayoutManager.showError();
    LinearLayout ll_error_data = (LinearLayout) findViewById(R.id.ll_error_data);
    ll_error_data.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {initData();
            adapter.notifyDataSetChanged();
            showContent();}
    });
}

/**
* 点击设置网络
*/
private void initSettingNetwork() {statusLayoutManager.showNetWorkError();
    LinearLayout ll_set_network = (LinearLayout) findViewById(R.id.ll_set_network);
    ll_set_network.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {Intent intent = new Intent("android.settings.WIRELESS_SETTINGS");
            startActivity(intent);
        }
    });
}
```
  • 那有些页面想要自定义指定的状态页面 UI,又该如何操作呢?倘若有些页面想定制状态布局,也可以自由实现,很简单:

    /**
*/
private void initEmptyDataView() {statusLayoutManager.showEmptyData();
    // 此处是自己定义的状态布局
    statusLayoutManager.showLayoutEmptyData(R.layout.activity_emptydata);
    LinearLayout ll_empty_data = (LinearLayout) findViewById(R.id.ll_empty_data);
    ll_empty_data.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {initData();
            adapter.notifyDataSetChanged();
            showContent();}
    });
}
``` 


其他介绍

01. 关于博客汇总链接

  • 1. 技术博客汇总
  • 2. 开源项目汇总
  • 3. 生活博客汇总
  • 4. 喜马拉雅音频汇总
  • 5. 其他汇总

02. 关于我的博客

  • github:https://github.com/yangchong211
  • 知乎:https://www.zhihu.com/people/…
  • 简书:http://www.jianshu.com/u/b7b2…
  • csdn:http://my.csdn.net/m0_37700275
  • 喜马拉雅听书:http://www.ximalaya.com/zhubo…
  • 开源中国:https://my.oschina.net/zbj161…
  • 泡在网上的日子:http://www.jcodecraeer.com/me…
  • 邮箱:yangchong211@163.com
  • 阿里云博客:https://yq.aliyun.com/users/a… 239.headeruserinfo.3.dT4bcV
  • segmentfault 头条:https://segmentfault.com/u/xi…
  • 掘金:https://juejin.im/user/593943…

项目开源地址:https://github.com/yangchong2…

退出移动版