Android自定義StatusView，資料加載四種狀态的切換

一般情況下，空白界面和網絡錯誤界面是不用顯示的，是以用ViewStub，減少記憶體消耗。

1.準備四種view的布局 1）status_empty.xml 資料空白界面

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical">
    <Button
        android:id="@+id/btn_status_empty"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="資料空白，重新加載" />
</LinearLayout>

2）status_loading.xml 加載中界面

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:background="@color/colorPrimary"
    android:orientation="vertical">
    <ProgressBar
        android:id="@+id/progressBar"
        style="?android:attr/progressBarStyle"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />
</LinearLayout>

3）status_error.xml 網絡錯誤界面

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical">
    <Button
        android:id="@+id/btn_status_error"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="網路錯誤，重新加載" />
</LinearLayout>

4）success.xml 資料加載成功界面

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <TextView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:text="成功加載" />
</LinearLayout>

2.根布局 status_view.xml

<?xml version="1.0" encoding="utf-8"?>
<merge xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <include
        android:id="@+id/status_loading"
        layout="@layout/status_loading"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

    <ViewStub
        android:id="@+id/stub_empty"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:inflatedId="@+id/status_empty"
        android:layout="@layout/status_empty" />

    <ViewStub
        android:id="@+id/stub_error"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:inflatedId="@+id/status_error"
        android:layout="@layout/status_error" />

</merge>

3.自定義StatusView

public class StatusView extends FrameLayout {
    private static final String TAG = "StatusView";
    /**
     * 四種狀态
     */
    public static final int LOADING = 1;
    public static final int ERROR = 2;
    public static final int EMPTY = 3;
    public static final int SUCCESS = 4;

    private FrameLayout mRootView;
    private View mLoadingView;
    private View mEmptyView;
    private View mErrorView;
    private View mSuccessView;

    //重新整理按鈕
    private Button mBtnEmptyRefresh, mBtnErrorRefresh;

    public StatusView(@NonNull Context context) {
        super(context, null);
    }

    public StatusView(@NonNull Context context, @Nullable AttributeSet attrs) {
        super(context, attrs);
        initView(context);
    }

    public StatusView(@NonNull Context context, @Nullable AttributeSet attrs, @AttrRes int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        initView(context);
    }

    private void initView(Context context) {
        mRootView = (FrameLayout) LayoutInflater.from(context).inflate(R.layout.status_view, this);
        initLoadView();
    }

    private void initLoadView() {
        mLoadingView = mRootView.findViewById(R.id.status_loading);
    }

    public void setSuccessView(int id) {
        if (mSuccessView == null) {
            mSuccessView = LayoutInflater.from(getContext()).inflate(id, null);
            FrameLayout.LayoutParams layoutParams = new LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT);
            mRootView.addView(mSuccessView, 0, layoutParams);//放到FrameLayout第一個位置
        }
    }

    /**
     * View的切換
     * @param status
     */
    public void showStatusView(int status) {
        Log.d(TAG, "showStatusView: status==" + status);
        switch (status) {
            case EMPTY:
                showEmptyView();
                break;
            case ERROR:
                showErrorView();
                break;
            case LOADING:
                showLoadingView();
                break;
            case SUCCESS:
                showSuccessView();
                break;
            default:
                showLoadingView();
                break;
        }
    }

    private void showLoadingView() {
        if (mLoadingView != null) {
            mLoadingView.setVisibility(VISIBLE);
        }
        dismissErrorView();
        dismissEmptyView();
        dismissSuccessView();
    }

    private void showEmptyView() {
        ViewStub stub = (ViewStub) mRootView.findViewById(R.id.stub_empty);
        if (stub != null) {
            mEmptyView = stub.inflate();//ViewStub調用inflate()方法後，R.id.stub_empty這個id會從布局中移除
            mBtnEmptyRefresh = (Button) mEmptyView.findViewById(R.id.btn_status_empty);
            mBtnEmptyRefresh.setOnClickListener(mOnClickListener);
        } else {
            mEmptyView.setVisibility(VISIBLE);
        }
        dismissErrorView();
        dismissLoadingView();
        dismissSuccessView();
    }

    private void showErrorView() {
        ViewStub stub = (ViewStub) mRootView.findViewById(R.id.stub_error);
        if (stub != null) {
            mErrorView = stub.inflate();
            mBtnErrorRefresh = (Button) findViewById(R.id.btn_status_error);
            mBtnErrorRefresh.setOnClickListener(mOnClickListener);
        } else {
            mErrorView.setVisibility(VISIBLE);
        }
        dismissLoadingView();
        dismissEmptyView();
        dismissSuccessView();
    }

    private void showSuccessView() {
        if (mSuccessView != null) {
            mSuccessView.setVisibility(VISIBLE);
            dismissEmptyView();
            dismissLoadingView();
            dismissErrorView();
        }
    }

    private void dismissLoadingView() {
        if (mLoadingView != null && mLoadingView.getVisibility() == VISIBLE) {
            mLoadingView.setVisibility(GONE);
        }
    }

    private void dismissEmptyView() {
        if (mEmptyView != null && mEmptyView.getVisibility() == VISIBLE) {
            mEmptyView.setVisibility(GONE);
        }
    }

    private void dismissErrorView() {
        if (mErrorView != null && mErrorView.getVisibility() == VISIBLE) {
            mErrorView.setVisibility(GONE);
        }
    }

    private void dismissSuccessView() {
        if (mSuccessView != null && mSuccessView.getVisibility() == VISIBLE) {
            mSuccessView.setVisibility(GONE);
        }
    }

    private OnClickListener mOnClickListener = new OnClickListener() {
        @Override
        public void onClick(View v) {
            switch (v.getId()) {
                case R.id.btn_status_empty:
                case R.id.btn_status_error:
                    if (mOnRetryGetDataListener != null) {
                        mOnRetryGetDataListener.refresh();
                    }
                    break;
            }
        }
    };

    /**
     * 點選重新加載
     */
    public interface OnRetryGetDataListener {
        void refresh();
    }

    private OnRetryGetDataListener mOnRetryGetDataListener;

    public void setOnRetryGetDataListener(OnRetryGetDataListener onRetryGetDataListener) {
        if (onRetryGetDataListener != null) {
            mOnRetryGetDataListener = onRetryGetDataListener;
        }
    }
}

4.StatusView的使用 1）測試的布局activity_test_status_view.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    tools:context="com.example.testretrofitrxjava.TestStatusViewActivity">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:orientation="horizontal">

        <Button
            android:id="@+id/btn_loading"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="加載中" />

        <Button
            android:id="@+id/btn_empty"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="空白" />

        <Button
            android:id="@+id/btn_net_error"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="網絡錯誤" />

        <Button
            android:id="@+id/btn_success"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="成功" />

    </LinearLayout>

    <com.example.testretrofitrxjava.widget.StatusView
        android:id="@+id/status_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"></com.example.testretrofitrxjava.widget.StatusView>

</LinearLayout>

2）測試的Activity

public class TestStatusViewActivity extends AppCompatActivity {

    private static final String TAG = "TestStatusViewActivity";
    private Button mBtnLoading, mBtnEmpty, mBtnError, mBtnSuccess;
    private StatusView mStatusView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_test_status_view);
        initView();
    }

    private void initView() {
        mBtnLoading = (Button) findViewById(R.id.btn_loading);
        mBtnLoading.setOnClickListener(mOnClickListener);

        mBtnEmpty = (Button) findViewById(R.id.btn_empty);
        mBtnEmpty.setOnClickListener(mOnClickListener);

        mBtnError = (Button) findViewById(R.id.btn_net_error);
        mBtnError.setOnClickListener(mOnClickListener);

        mBtnSuccess = (Button) findViewById(R.id.btn_success);
        mBtnSuccess.setOnClickListener(mOnClickListener);

        mStatusView = (StatusView) findViewById(R.id.status_view);
        mStatusView.setSuccessView(R.layout.success);
        mStatusView.setOnRetryGetDataListener(new StatusView.OnRetryGetDataListener() {
            @Override
            public void refresh() {
                Log.e(TAG, "refresh: 資料重新加載");
            }
        });
    }

    private View.OnClickListener mOnClickListener = new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            switch (v.getId()) {
                case R.id.btn_loading:
                    mStatusView.showStatusView(StatusView.LOADING);
                    break;
                case R.id.btn_empty:
                    mStatusView.showStatusView(StatusView.EMPTY);
                    break;
                case R.id.btn_net_error:
                    mStatusView.showStatusView(StatusView.ERROR);
                    break;
                case R.id.btn_success:
                    mStatusView.showStatusView(StatusView.SUCCESS);
                    break;
                default:
                    break;
            }
        }
    };
}

Android自定義StatusView，資料加載四種狀态的切換

一般情況下，空白界面和網絡錯誤界面是不用顯示的，是以用ViewStub，減少記憶體消耗。

繼續閱讀

專訪鄧凡平：深入了解Android

與專家面對面：Android開發入門問與答

Android MVP架構MVCMVP

mvp初探

Android常用工具類簡介目錄

android常用工具類轉載自：http://www.trinea.cn/android/android-common-utils/Android常用工具類

Android常用工具類ToastUtilsSizeUtilsLogUtilsRetrofitManagerAnimUtil

Android Studio 0.8.0解決 Failure [INSTALL_FAILED_OLDER_SDK] 問題

Android – ListView 中添加按鈕，動态删除添加ItemView的操作

Kotlin的ListView與RecyclerView的簡單應用

關于公司的那些坑：Android Studio篇

android SQLite事務和kotlin協程

無法正常編譯錯誤Compilation failed to complete

關于Gradle配置的小結

AOP程式設計_Android優雅權限架構(1)概念基礎，2021金三銀四前言正文大綱正文

Android APK檔案反編譯Android APK檔案反編譯