亲自动手编写Android通用刷新控件

请允许我详细讲解“亲自动手编写Android通用刷新控件”的完整攻略。

简介

在Android应用中，刷新控件是一个非常重要的组件，通常用于刷新列表、操作反馈等场景。本攻略基于自定义View和RecyclerView实现通用的下拉刷新和上拉加载更多的功能。

实现步骤

步骤一：自定义刷新控件布局

首先，我们需要自定义一个刷新控件布局RefreshLayout，这个布局需要包含两个子布局：下拉刷新头部HeaderView和内容区域RecyclerView。

<RelativeLayout
    android:id="@+id/rl_refresh_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <include
        android:id="@+id/iv_header_view"
        layout="@layout/header_view" />

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/rv_content"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_below="@id/iv_header_view" />

</RelativeLayout>

步骤二：自定义刷新控件

接下来，创建一个Java类RefreshRecyclerView，继承自ViewGroup。在RefreshRecyclerView中完成下拉刷新和上拉加载更多的操作，同时需要监听手势操作。

public class RefreshRecyclerView extends ViewGroup {

    // 上下文
    private Context mContext;
    // 内容区域
    private RecyclerView mRecyclerView;
    // 下拉刷新头部
    private View mHeaderView;

    // 构造函数
    public RefreshRecyclerView(Context context) {
        this(context, null);
    }

    public RefreshRecyclerView(Context context, AttributeSet attrs) {
        this(context, attrs, 0);
    }

    public RefreshRecyclerView(Context context, AttributeSet attrs, int defStyleAttr) {
        super(context, attrs, defStyleAttr);
        mContext = context;
        init();
    }

    // 初始化
    private void init() {
        // 添加自定义布局
        LayoutInflater inflater = LayoutInflater.from(mContext);
        View view = inflater.inflate(R.layout.refresh_layout, this, false);
        mHeaderView = view.findViewById(R.id.iv_header_view);
        mRecyclerView = view.findViewById(R.id.rv_content);
        addView(view);
        // 监听手势操作
        initGesture();
    }

    // 监听手势操作
    private void initGesture() {
        // TODO
    }

    // 下拉刷新
    private void refresh() {
        // TODO
    }

    // 上拉加载更多
    private void loadMore() {
        // TODO
    }

}

步骤三：实现手势监听

在initGesture()方法中，我们需要监听下拉手势和上滑手势，并根据手势进行相应的操作。

private void initGesture() {
    final GestureDetectorCompat mGestureDetector = new GestureDetectorCompat(mContext, new GestureDetector.SimpleOnGestureListener() {

        // 下拉
        @Override
        public boolean onDown(MotionEvent e) {
            return true;
        }

        // 上滑
        @Override
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
            if (e1.getY() - e2.getY() > 50 && Math.abs(velocityX) < Math.abs(velocityY)) {
                // 上滑
                loadMore();
                return true;
            }
            return false;
        }

    });
    mRecyclerView.setOnTouchListener(new OnTouchListener() {
        @Override
        public boolean onTouch(View v, MotionEvent event) {
            return mGestureDetector.onTouchEvent(event);
        }
    });
}

步骤四：实现下拉刷新

首先，在init()方法中，我们需要使用mHeaderView.measure(0, 0)来测量下拉刷新头部的高度，并将其隐藏。

private void init() {
    // 添加自定义布局
    LayoutInflater inflater = LayoutInflater.from(mContext);
    View view = inflater.inflate(R.layout.refresh_layout, this, false);
    mHeaderView = view.findViewById(R.id.iv_header_view);
    mRecyclerView = view.findViewById(R.id.rv_content);
    addView(view);
    // 隐藏下拉刷新头部
    mHeaderView.measure(0, 0);
    mHeaderView.setPadding(0, -mHeaderView.getMeasuredHeight(), 0, 0);
}

接下来，在initGesture()方法中，我们需要监听下拉手势，并根据下拉的距离来滑动下拉刷新头部。

private void initGesture() {
    final GestureDetectorCompat mGestureDetector = new GestureDetectorCompat(mContext, new GestureDetector.SimpleOnGestureListener() {

        // 下拉
        @Override
        public boolean onDown(MotionEvent e) {
            return true;
        }

        // 上滑
        @Override
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
            if (e1.getY() - e2.getY() > 50 && Math.abs(velocityX) < Math.abs(velocityY)) {
                // 上滑
                loadMore();
                return true;
            }
            return false;
        }

        // 滑动
        @Override
        public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
            if (distanceY > 0) {
                // 上滑
                return false;
            }
            if (mRecyclerView.getAdapter() == null || mRecyclerView.getAdapter().getItemCount() == 0) {
                // 数据为空
                return false;
            }
            if (canRefresh()) {
                // 可以刷新
                int paddingTop = (int) (e2.getY() - e1.getY() - mHeaderView.getMeasuredHeight());
                mHeaderView.setPadding(0, paddingTop, 0, 0);
            }
            return false;
        }

    });
    mRecyclerView.setOnTouchListener(new OnTouchListener() {
        @Override
        public boolean onTouch(View v, MotionEvent event) {
            return mGestureDetector.onTouchEvent(event);
        }
    });
}

在onScroll()方法中，我们判断当前是否可以刷新，如果可以，就根据下拉的距离来滑动下拉刷新头部。

private boolean canRefresh() {
    LinearLayoutManager layoutManager = (LinearLayoutManager) mRecyclerView.getLayoutManager();
    int firstVisibleItem = layoutManager.findFirstVisibleItemPosition();
    if (firstVisibleItem != 0) {
        // 不是第一项
        return false;
    }
    int paddingTop = -mHeaderView.getPaddingTop();
    if (paddingTop < mHeaderView.getMeasuredHeight()) {
        // 未完全下拉
        return false;
    }
    return true;
}

接下来，在refresh()方法中，我们处理下拉刷新的具体操作。

private void refresh() {
    // 显示下拉刷新头部
    mHeaderView.setPadding(0, 0, 0, 0);
    // TODO: 请求数据
}

最后，在loadMore()方法中，我们处理上拉加载更多的具体操作。

private void loadMore() {
    // TODO: 请求数据
}

步骤五：使用刷新控件

在代码中使用刷新控件非常简单，只需要创建一个RefreshRecyclerView实例，并设置数据适配器即可。

RefreshRecyclerView refreshRecyclerView = findViewById(R.id.refresh_recycler_view);
refreshRecyclerView.setLayoutManager(new LinearLayoutManager(this));
refreshRecyclerView.setAdapter(new MyAdapter(this, mDataList));

示例说明

示例一：下拉刷新数据

在refresh()方法中，我们可以使用异步任务来模拟请求数据的操作。在请求数据结束后，我们需要调用RefreshRecyclerView的notifyRefreshComplete()方法来通知刷新操作已经完成。

private void refresh() {
    // 显示下拉刷新头部
    mHeaderView.setPadding(0, 0, 0, 0);
    // 模拟请求数据
    new AsyncTask<Void, Void, Void>() {
        @Override
        protected Void doInBackground(Void... params) {
            try {
                Thread.sleep(3000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            mDataList.clear();
            for (int i = 0; i < 20; i++) {
                mDataList.add("Item " + i);
            }
            return null;
        }

        @Override
        protected void onPostExecute(Void aVoid) {
            // 更新数据
            mRecyclerView.getAdapter().notifyDataSetChanged();
            // 隐藏下拉刷新头部
            mHeaderView.setPadding(0, -mHeaderView.getMeasuredHeight(), 0, 0);
            // 通知刷新完成
            notifyRefreshComplete();
        }
    }.execute();
}

示例二：上拉加载更多数据

在loadMore()方法中，我们同样可以使用异步任务来模拟请求数据的操作。如果没有更多数据，我们需要调用RefreshRecyclerView的notifyLoadMoreComplete()方法来通知加载更多操作已经完成，从而禁用上拉加载更多操作。

private void loadMore() {
    // 模拟请求数据
    new AsyncTask<Void, Void, Void>() {
        @Override
        protected Void doInBackground(Void... params) {
            try {
                Thread.sleep(3000);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            for (int i = mDataList.size(); i < mDataList.size() + 20; i++) {
                mDataList.add("Item " + i);
            }
            return null;
        }

        @Override
        protected void onPostExecute(Void aVoid) {
            // 更新数据
            mRecyclerView.getAdapter().notifyDataSetChanged();
            // 通知加载更多完成
            notifyLoadMoreComplete(mDataList.size() < 100);
        }
    }.execute();
}

在更新完数据之后，我们还需要判断是否还有更多数据，从而禁用上拉加载更多操作。

结语

至此，我们已经完成了自定义通用的刷新控件的开发。在开发过程中，我们掌握了如何使用自定义View和RecyclerView组件来构建刷新控件，并完成了下拉刷新和上拉加载更多功能的开发。