Android状态页切换（数据加载中，数据加载失败，空数据）

深碍√TFBOYSˉ_ 2022-05-26 02:47 279阅读 0赞

咱们在开发过程中经常需要从网络上获取数据。这个时候为了增强用户体验。就可能有如下需求：在获取的数据的中时候显示加载中的UI（获取数据需要 一定的时间）、如果获取数据失败显示失败的UI、获取的数据为空的时候显示空数据的UI、数据成功获取到的时候才显示获取到的数据列表。总之一句话就是根据不同的状态现实不同的UI。这也是我们这篇文章的重点．接下来咱么就对这一需求做一个简单的封装。

#### 一、效果图 ####

在代码之前先把效果图贴出来给大伙看下．

*  默认的数据为空，数据加载失败，数据加载中UI．  
    
    
      
    ![default\_state][default_state]
 *  自定义各个状态的UI样式(这里用了YY-SVGA动画框架　[官网][Link 1])  
    
    
      
    ![customer\_state][customer_state]

> 加入了下拉刷新功能  
> 
> 
>   
> ![customer\_state\_action][customer_state_action]

*  同一个界面有多个地方使用  
      
    ![mult\_module\_state][mult_module_state]

#### 二、实现过程 ####

状态不同显示的UI不同．所以我们先确定下我们要支持的状态有哪些，如下：

public enum State {
            /** * 数据内容显示 */
            CONTENT,
            /** * 数据加载中 */
            ING,
            /** * 数据为空 */
            EMPTY,
            /** * 数据加载失败 */
            ERROR
        }

然后就是对布局进行封装了，StateLayout就是用来管理这四个状态的UI切换的．StateLayout里面肯定会有对应上面四种状态的View实例：数据获取成功对应view实例、数据为空对应view实例、数据获取失败对应view实例子、数据获取中对应view实例．StateLayout要做的事情就是根据不同的状态确定哪些view显示，哪些view不显示．这也是StateLayout里面最核心的逻辑了．代码如下：

public void switchState(State state) {
            if (mState != null && mState == state) {
                return;
            }
            switch (state) {
                case CONTENT:
                    mContentView.setVisibility(VISIBLE);
                    mStateIngView.getView().setVisibility(GONE);
                    mStateIngView.visible(false);
                    mStateEmptyView.getView().setVisibility(GONE);
                    mStateEmptyView.visible(false);
                    mStateErrorView.getView().setVisibility(GONE);
                    mStateErrorView.visible(false);
                    break;
                case ING:
                    mContentView.setVisibility(GONE);
                    mStateIngView.getView().setVisibility(VISIBLE);
                    mStateIngView.visible(true);
                    mStateEmptyView.getView().setVisibility(GONE);
                    mStateEmptyView.visible(false);
                    mStateErrorView.getView().setVisibility(GONE);
                    mStateErrorView.visible(false);
                    break;
                case EMPTY:
                    mContentView.setVisibility(GONE);
                    mStateIngView.getView().setVisibility(GONE);
                    mStateIngView.visible(false);
                    mStateEmptyView.getView().setVisibility(VISIBLE);
                    mStateEmptyView.visible(true);
                    mStateErrorView.getView().setVisibility(GONE);
                    mStateErrorView.visible(false);
                    break;
                case ERROR:
                    mContentView.setVisibility(GONE);
                    mStateIngView.getView().setVisibility(GONE);
                    mStateIngView.visible(false);
                    mStateEmptyView.getView().setVisibility(GONE);
                    mStateEmptyView.visible(false);
                    mStateErrorView.getView().setVisibility(VISIBLE);
                    mStateErrorView.visible(true);
                    break;
            }
            mState = state;
        }

考虑到每种状态都可能有一些额外的需求．比如加载失败的状态可能额外需要有一个重新加载的按钮，或者自定义显示加载失败的文字．所以为了能尽量更多的去适应这样的功能需求，这里每种状态的view其实我都有写一个接口，让去各自实现．比如加载失败状态的接口：

public interface StateErrorInterface { 
    
        interface OnRetryListener {
    
            void onRetry();
        }
    
        /** * 获取实体视图 * * @return 实体视图 */
        @NonNull
        View getView();
    
        /** * 设置提示信息 */
        void setPromptMessage(String msg);
    
        /** * 设置重试监听 */
        void setOnRetryListener(OnRetryListener listener);
    
        /** * View是否显示(有的时候可能会启动一些动画，可以在这里做开始停止的动作) */
        void visible(boolean visible);
    }

#### 三、如何使用 ####

状态呢，咱么是有四种．CONTENT　state对应的UI是要打交道最多的，这个状态的UI咱们不做过多的控制．按照常规findViewById()找到这个状态里面的View然后使用．咱们主要是对其他三种状态做了一个简单的封装，既可以使用里面默认的状态UI也可以自定义的状态对应UI．就是要注意自定义状态UI的时候一定要实现对应的接口方法：自定义数据为空的时候的UI要实现StateEmptyInterface接口、自定义数据加载失败的时候的UI要实现StateErrorInterface接口、要实现数据加载中的时候的UI的时候要实现StateIngInterface接口．

> 默认的状态UI也是支持修改功能的

/** * 设置默认的加载中的UI * * @param creator 　IngCreator */
        public static void setDefaultIngCreator(IngCreator creator) {
            sIngCreator = creator;
        }
    
        /** * 设置默认数据为空的时候的UI * * @param creator 　EmptyCreator */
        public static void setDefaultEmptyCreator(EmptyCreator creator) {
            sEmptyCreator = creator;
        }
    
        /** * 设置默认数据获取失败时候的UI * * @param creator 　ErrorCreator */
        public static void setDefaultErrorCreator(ErrorCreator creator) {
            sErrorCreator = creator;
        }

关于Android状态切换Layout（数据加载中，数据加载失败，空数据）的东西就说这么多，里面更加具体的细节和使用方式可以参考[DEMO下载链接][DEMO]．

[default_state]: /images/20220526/f2f0789c47704a0aac96d2c8a4349981.png
[Link 1]: http://svga.io/
[customer_state]: /images/20220526/a53cb3cdc1f944dd91ed57e48b1de63d.png
[customer_state_action]: /images/20220526/602545ddd5614bcc9ea30aa5339be906.png
[mult_module_state]: /images/20220526/381d9f58afdb42db94956e16894f7718.png
[DEMO]: https://github.com/tuacy/StateSwitchLayout