揭开RecyclerView的神秘面纱(二)：处理Recycle

作者: 丶蓝天白云梦 | 来源:发表于2016-05-11 08:34 被阅读15207次

前言

上一篇文章揭开RecyclerView的神秘面纱(一)：RecyclerView的基本使用中，主要讲述了RecyclerView的基本使用方法，不同的布局管理器而造成的多样化展示方式，展示了数据之后，一般都会与用户进行交互，因此我们需要处理用户的点击事件。在ListView和GridView提供了onItemClickListener这个监听器，然而我们查找RecyclerView的API却没有类似的监听器，因此我们需要自己手动处理它的点击事件。
以下提供两种方法来实现处理RecyclerView点击事件的功能，以下代码均基于上一篇文章的代码做出修改。

方法一：利用View.onClickListener及onLongClickListener

利用了java回调机制，这里我们依赖于子Item View的onClickListener及onLongClickListener。
首先对MyAdapter.java代码做出如下修改：
①新建两个内部接口：

    public interface OnItemClickListener{
        void onItemClick(View view,int position);
    }

    public interface OnItemLongClickListener{
        void onItemLongClick(View view,int position);
    }

②新建两个私有变量用于保存用户设置的监听器及其set方法：

    private OnItemClickListener mOnItemClickListener;
    private OnItemLongClickListener mOnItemLongClickListener;

    public void setOnItemClickListener(OnItemClickListener mOnItemClickListener){
        this.mOnItemClickListener = mOnItemClickListener;
    }
    
    public void setOnItemLongClickListener(OnItemLongClickListener mOnItemLongClickListener) {
        this.mOnItemLongClickListener = mOnItemLongClickListener;
    }

③在onBindViewHolder方法内，实现回调：

@Override
public void onBindViewHolder(final ViewHolder holder, int position) {
    holder.mTextView.setText(mDataSet.get(position));
    //判断是否设置了监听器
    if(mOnItemClickListener != null){
        //为ItemView设置监听器
        holder.itemView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                int position = holder.getLayoutPosition(); // 1
                mOnItemClickListener.onItemClick(holder.itemView,position); // 2
            }
        });
    }
    if(mOnItemLongClickListener != null){
        holder.itemView.setOnLongClickListener(new View.OnLongClickListener() {
            @Override
            public boolean onLongClick(View v) {
                int position = holder.getLayoutPosition();
                mOnItemLongClickListener.onItemLongClick(holder.itemView,position);
                //返回true 表示消耗了事件 事件不会继续传递
                return true;
            }
        });
    }
}

可以看到，这里实际上用到了子Item View的onClickListener和onLongClickListener这两个监听器，如果当前子item view被点击了，会触发点击事件进行回调，然后在①处获取当前点击位置的position值，接着在②号代码处进行再次回调，而这一次的回调是我们自己手动添加的，需要实现上面所述的接口。
修改完MyAdapter.java后，我们接着在MainActivity.java中设置监听器，采用匿名内部类的形式实现了onItemClickListener、onItemLongClickListener接口，这种写法与一般的设置监听器的流程相同：

    
mAdapter = new MyAdapter(mData);
mAdapter.setOnItemClickListener(new MyAdapter.OnItemClickListener() {
    @Override
    public void onItemClick(View view, int position) {
        Toast.makeText(MainActivity.this, "click " + mData.get(position), Toast.LENGTH_SHORT).show();
    }
});
mAdapter.setOnItemLongClickListener(new MyAdapter.OnItemLongClickListener() {
    @Override
    public void onItemLongClick(View view, int position) {
        Toast.makeText(MainActivity.this,"long click "+mData.get(position),Toast.LENGTH_SHORT).show();
    }
});
mRecyclerView.setAdapter(mAdapter);

我们运行程序，观察一下运行结果：

点击Item 1.png

长按 Item 2.png

方法二：利用RecyclerView.OnItemTouchListener

官方虽然没有提供现成的监听器，但是提供了一个内部接口：OnItemTouchListener，我们看看官方文档对它的描述：An OnItemTouchListener allows the application to intercept touch events in progress at the view hierarchy level of the RecyclerView before those touch events are considered for RecyclerView's own scrolling behavior。大概意思是说该接口允许我们对RecyclerView的触摸事件进行拦截，我们看看它的几个接口方法：

    @Override
    public boolean onInterceptTouchEvent(RecyclerView rv, MotionEvent e) {
        return false;
    }
    
    @Override
    public void onTouchEvent(RecyclerView rv, MotionEvent e) {

    }
    
    @Override
    public void onRequestDisallowInterceptTouchEvent(boolean disallowIntercept) {

    }

熟悉View事件分发机制的同学看到这些方法的名字一定觉得很熟悉了吧，所以这个接口的实质是利用了View的事件分发与拦截机制。大体思路是：我们可以在onInterceptTouchEvent获取当前触摸位置对应的子item view，根据点击状态决定是否要把事件拦截，在拦截的时候同时添加一个回调方法，这样我们自己实现的监听器接口就能在这里得到回调。具体的请看如下代码：
新建一个RecyclerViewClickListener.java:

/**
  *  @author ChenYu
  *      2016-05-10
  */
public class RecyclerViewClickListener implements RecyclerView.OnItemTouchListener {

    private int mLastDownX,mLastDownY;
    //该值记录了最小滑动距离
    private int touchSlop ;
    private OnItemClickListener mListener;
    //是否是单击事件
    private boolean isSingleTapUp = false;
    //是否是长按事件
    private boolean isLongPressUp = false;
    private boolean isMove = false;
    private long mDownTime;

    //内部接口，定义点击方法以及长按方法
    public interface OnItemClickListener {
        void onItemClick(View view, int position);

        void onItemLongClick(View view, int position);
    }

    public RecyclerViewClickListener(Context context,OnItemClickListener listener){
        touchSlop = ViewConfiguration.get(context).getScaledTouchSlop();
        mListener = listener;
    }
    @Override
    public boolean onInterceptTouchEvent(RecyclerView rv, MotionEvent e) {
        int x = (int) e.getX();
        int y = (int) e.getY();
        switch (e.getAction()){
            /**
             *  如果是ACTION_DOWN事件，那么记录当前按下的位置，
             *  记录当前的系统时间。
             */
            case MotionEvent.ACTION_DOWN:
                mLastDownX = x;
                mLastDownY = y;
                mDownTime = System.currentTimeMillis();
                isMove = false;
                break;
            /**
             *  如果是ACTION_MOVE事件，此时根据TouchSlop判断用户在按下的时候是否滑动了，
             *  如果滑动了，那么接下来将不处理点击事件
             */
            case MotionEvent.ACTION_MOVE:
                if(Math.abs(x - mLastDownX)>touchSlop || Math.abs(y - mLastDownY)>touchSlop){
                    isMove = true;
                }
                break;
            /**
             *  如果是ACTION_UP事件，那么根据isMove标志位来判断是否需要处理点击事件；
             *  根据系统时间的差值来判断是哪种事件，如果按下事件超过1s，则认为是长按事件，
             *  否则是单击事件。
             */
            case MotionEvent.ACTION_UP:
                if(isMove){
                    break;
                }
                if(System.currentTimeMillis()-mDownTime > 1000){
                    isLongPressUp = true;
                }else {
                    isSingleTapUp = true;
                }
                break;
        }
        if(isSingleTapUp ){
            //根据触摸坐标来获取childView
            View childView = rv.findChildViewUnder(e.getX(),e.getY());
            isSingleTapUp = false;
            if(childView != null){
                //回调mListener#onItemClick方法
                mListener.onItemClick(childView,rv.getChildLayoutPosition(childView));
                return true;
            }
            return false;
        }
        if (isLongPressUp ){
            View childView = rv.findChildViewUnder(e.getX(),e.getY());
            isLongPressUp = false;
            if(childView != null){
                mListener.onItemLongClick(childView, rv.getChildLayoutPosition(childView));
                return true;
            }
            return false;
        }
        return false;
    }

    @Override
    public void onTouchEvent(RecyclerView rv, MotionEvent e) {

    }

    @Override
    public void onRequestDisallowInterceptTouchEvent(boolean disallowIntercept) {

    }
}

接着我们在MainActivity.java添加一段代码,同时不要忘记把方法一的代码注释掉哦：

 //调用RecyclerView#addOnItemTouchListener方法能添加一个RecyclerView.OnItemTouchListener对象
 mRecyclerView.addOnItemTouchListener(new RecyclerViewClickListener(this,new RecyclerViewClickListener.OnItemClickListener() {
    @Override
    public void onItemClick(View view, int position) {
        Toast.makeText(MainActivity.this,"Click "+mData.get(position),Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onItemLongClick(View view, int position) {
        Toast.makeText(MainActivity.this,"Long Click "+mData.get(position),Toast.LENGTH_SHORT).show();
    }
}));

OK，编译通过运行程序，结果和上面一模一样。

那么方法一和方法二有何区别呢？
首先，方法一我们是直接在MyAdapter数据适配器中，为itemview设置了内置监听器，再通过这个监听器实现我们的回调方法，相当于回调了两次，同时这个方法与MyAdapter的耦合度比较高，也违反了单一职责原则，当然其简易性也是突出的优点。而方法二，我们利用了onTouchListener接口对事件进行了拦截，在拦截中处理我们的点击事件，实现了与适配器的解耦，但是复杂程度会比方法一大。总地来说，如果RecyclerView需要处理的点击事件逻辑很简单，那么可以使用方法一；如果需要处理比较复杂的点击事件，比如说，双击、长按等点击事件，则需要使用方法二去实现各种复杂的逻辑。

对方法二的优化

在实现方法二的RecyclerViewClickListener的时候，在内部对事件的实现了单击、长按的判断，但是这个长按事件不是标准的，只有松开手指的时候才会触发长按事件，这也算是一点瑕疵，同时如果要增加别的事件，比如说双击事件，则需要增加相应的逻辑，如果需要判断的事件种类变多则会给我们的代码编写带来困难，那么有没有更加简便的方法呢？其实安卓SDK为我们提供了一个手势检测类：GestureDetector来处理各种不同的手势，那么我们完全可以利用GestureDetector来对方法二进行改进。

新建RecyclerViewClickListener2.java:

public class RecyclerViewClickListener2 implements RecyclerView.OnItemTouchListener {

    private GestureDetector mGestureDetector;
    private OnItemClickListener mListener;

    //内部接口，定义点击方法以及长按方法
    public interface OnItemClickListener {
        void onItemClick(View view, int position);

        void onItemLongClick(View view, int position);
    }

    public RecyclerViewClickListener2(Context context, final RecyclerView recyclerView,OnItemClickListener listener){
        mListener = listener;
        mGestureDetector = new GestureDetector(context,
                new GestureDetector.SimpleOnGestureListener(){ //这里选择SimpleOnGestureListener实现类，可以根据需要选择重写的方法
                    //单击事件
                    @Override
                    public boolean onSingleTapUp(MotionEvent e) {
                        View childView = recyclerView.findChildViewUnder(e.getX(),e.getY());
                        if(childView != null && mListener != null){
                            mListener.onItemClick(childView,recyclerView.getChildLayoutPosition(childView));
                            return true;
                        }
                        return false;
                    }
                    //长按事件
                    @Override
                    public void onLongPress(MotionEvent e) {
                        View childView = recyclerView.findChildViewUnder(e.getX(),e.getY());
                        if(childView != null && mListener != null){
                            mListener.onItemLongClick(childView,recyclerView.getChildLayoutPosition(childView));
                        }
                    }
                });
    }
    @Override
    public boolean onInterceptTouchEvent(RecyclerView rv, MotionEvent e) {
        //把事件交给GestureDetector处理
        if(mGestureDetector.onTouchEvent(e)){
            return true;
        }else
            return false;
    }

    @Override
    public void onTouchEvent(RecyclerView rv, MotionEvent e) {
    }

    @Override
    public void onRequestDisallowInterceptTouchEvent(boolean disallowIntercept) {
    }
}

在MainActivity.java改动如下：

mRecyclerView.addOnItemTouchListener(new RecyclerViewClickListener2(this, mRecyclerView,
        new RecyclerViewClickListener2.OnItemClickListener() {
    @Override
    public void onItemClick(View view, int position) {
        Toast.makeText(MainActivity.this,"Click "+mData.get(position),Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onItemLongClick(View view, int position) {
        Toast.makeText(MainActivity.this,"Long Click "+mData.get(position),Toast.LENGTH_SHORT).show();
    }
}));

运行结果与上面的相同。

至此，关于处理RecyclerView的点击事件的方法讲述完毕，如果你们还有什么别的方法欢迎留言讨论。

更多阅读：

揭开RecyclerView的神秘面纱(一)：RecyclerView的基本使用
 揭开RecyclerView的神秘面纱(三)：操作数据及添加分割线

网友评论

ctwillson:好奇最后在MainActivity.java处理时，如何获取到 adapter中的ui 资源，比如我要在onItemLongClick中动态更新adapter中的数据该怎么写。。。
78983551cc90:使用itemTouch你这样无法触发点击效果(振动/音效)的吧
德古拉伯爵_694b:我现在写的一个项目既要实现点击事件还要做滚动监听，目前已经用addOnScrollListener实现滚动监听，但是再用setOnItemClickListener做监听，点击事件完全不走。请问大佬怎么解决
心若冰清_:时间跨度比较久了，在方法一中使用了interface作为接口回调函数，去执行事件的监听，那如果直接在onBindViewHolder中，使用代码：
holder.textView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Toast.makeText(context,"点击了item：" + position, Toast.LENGTH_SHORT).show();
}
});
这样的写法不是更简单吗？
就不会出现使用两次回调了啊，是不是用你的写法还有其他的用途？
心若冰清_: @陈育这个确实如果是放在adapter中，在不同的activity中都有可能调用到同一个adapter，这样逻辑比较混乱。而且容易出错
丶蓝天白云梦:这是因为一般对每个item的点击操作逻辑会放在Activity来实现，所以抽象出一个接口，这样以后需要更改业务逻辑就只修改Activity内的代码即可，就不必要修改Adapter的内部代码。这样做的出发点是使业务逻辑清晰点。
石咩咩咩咩:你好，各路大神们，求助，
用第一种放方法activity里setOnItemClickListener一直是红色，adapter里的setOnItemClickListener显示未被调用，，，，，什么情况，求助，求助！！
Jon0418:我使用了文章里最后一个方法判断手势，但是出现了一个很奇怪的问题：单击响应后，长按里面的方法自动接着执行了，可能是哪方面原因？排查了很久查不出来，只好问问作者了
杨小过:@Jon0418 好的，谢谢回复
Jon0418:@yangxiaoguo 没有，换第一种方法了
杨小过:根本就不调用onSingleTapUp这个方法，我也遇到这个问题，你解决了吗？
橐驼骆:你好，采用了你第二种方案后，Item的点击事件会与Item内部的控件（如Button，ImageView）的点击事件发生冲突，只能点击到Item的点击事件，请问要如何解决呢？谢谢
橐驼骆:@陈育谢谢，我最终也是采用了你第一种方法来实现Item的点击事件和内部控件的点击事件。
丶蓝天白云梦:@橐驼骆如果Item内部还有别的控件需要获取点击事件，建议采取第一种方法定义一个回调接口，在onBindViewHolder方法内对内部的button一一设置点击事件的监听。如果采用第二种方法，首先需要获取按下的坐标，然后根据该触摸坐标是否在需要接受的事件的控件范围内来决定是否要拦截事件。如果不拦截事件，即onInterceptTouchEvent返回false，那么事件就会被内部的button接收到了。个人认为，方法二的逻辑比较复杂，如果仅是对Item的点击事件作出反应那么方法一是最好的选择，如果你的item还需要左滑删除等别的功能，采取方法二对触摸事件进行拦截判断会更好。
Jon0418:判断按下时间那儿，笔误了，应该是1s
丶蓝天白云梦:@Jon0418 谢谢提醒，已修正
1f2ff2c13903:item里多个点击事件怎么处理
Spur2:这个你解决的了吗
来lol里:item里多个点击事件怎么处理
Dodo杰:@来lol里直接获取item里边的控件然后进行点击事件的设置应该是没有问题的
xBuck:直接在 holder 里面给 itemview 设置 onclicklistener 也可以啊，或者说这样有什么缺点吗？
丶蓝天白云梦:@CoderBuck 不用谢，相互学习
xBuck:@陈育谢谢，查了很多文章，都没提到过这种写法，倒是Google simple 里是这样写的。
丶蓝天白云梦:@CoderBuck 这样实现也是可以的，同方法一一样，都是在adapter内部实现逻辑，简单可行，但耦合度高。