事件分发机制源码分析

屏幕接受到一个触摸事件,首先由系统回调Activity中的dispatchTouchEvent方法

    public boolean dispatchTouchEvent(MotionEvent ev) {
        // 对一组事件来说,首先要处理DOWN事件
        if (ev.getAction() == MotionEvent.ACTION_DOWN) {
            //  是一个空方法,供用户自己实现自己的逻辑
            onUserInteraction();
        }
        if (getWindow().superDispatchTouchEvent(ev)) {
            return true;
        }
        return onTouchEvent(ev);
    }

如果执行getWindow().superDispatchTouchEvent(ev) 返回了true,那么就不会调用自己的onTouchEvent方法。否则,就会执行onTouchEvent。关键是看getWindow().superDispatchTouchEvent(ev)的返回值了。此方法直接调用了此acitivty所属的phoneWindow中mDecor的superDispatchTouchEvent方法。而mDecor直接调用了它父类中的dispatchTouchEvent方法

    // 这是一个ViewGroup的成员变量,TouchTarget是ViewGroup的内部类,这个类是一个单链表数据结构,
    // 这个类内部保存着对一个View的引用。其实它的主要职责就是形成一个View的单链表集合
    //  mFirstTouchTarget就是在这个链表集合中保存第一个触摸的VIew
    private TouchTarget mFirstTouchTarget;

    @Override
    public boolean dispatchTouchEvent(MotionEvent ev) {
        // a.对事件的检测
        if (mInputEventConsistencyVerifier != null) {
            mInputEventConsistencyVerifier.onTouchEvent(ev, 1);
        }
        // b.处理accessibility相关的逻辑
        if (ev.isTargetAccessibilityFocus() && isAccessibilityFocusedViewOrHost()) {
            ev.setTargetAccessibilityFocus(false);
        }

        boolean handled = false;
        // c. 过滤安全的事件,一般情况下都会返回true
        if (onFilterTouchEventForSecurity(ev)) {
            final int action = ev.getAction();
            final int actionMasked = action & MotionEvent.ACTION_MASK;

            // d.mask为down,表明是一组新的事件,当前为down事件
            if (actionMasked == MotionEvent.ACTION_DOWN) {
                // 清除和复位上一组事件的所有标记以及变量,以备开始一个新的循环
                cancelAndClearTouchTargets(ev);
                resetTouchState();
            }

            // e.定义一个boolean变量,表示是否拦截
            final boolean intercepted;
            // f.此次事件为down或者 mFirstTouchTarget已经被赋值了
            if (actionMasked == MotionEvent.ACTION_DOWN
                    || mFirstTouchTarget != null) {
                // g.子view是否请求父控件拦截此次事件
                final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
                if (!disallowIntercept) {
                    // h.子view没有请求父控件拦不拦截,所以走正常逻辑  
                    intercepted = onInterceptTouchEvent(ev);
                    ev.setAction(action); 
                } else {
                   // i.子view请求父控件不要拦截此次事件,所以intercepted直接赋值为false
                    intercepted = false;
                }
            } else {
                // j. mFirstTouchTarget为null或者此时的acition不是down,此时需要拦截
                intercepted = true;
            }

            if (intercepted || mFirstTouchTarget != null) {
                ev.setTargetAccessibilityFocus(false);
            }
            // k.检查是否取消
            final boolean canceled = resetCancelNextUpFlag(this)
                    || actionMasked == MotionEvent.ACTION_CANCEL;

            final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0;
            TouchTarget newTouchTarget = null;
            boolean alreadyDispatchedToNewTouchTarget = false;
            // l.如果没有取消此次事件并且不拦截此次事件,那就意味着要把此次事件交给子view
            if (!canceled && !intercepted) {
                View childWithAccessibilityFocus = ev.isTargetAccessibilityFocus()
                        ? findChildWithAccessibilityFocus() : null;

                if (actionMasked == MotionEvent.ACTION_DOWN
                        || (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
                        || actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
                    final int actionIndex = ev.getActionIndex(); // always 0 for down
                    final int idBitsToAssign = split ? 1 << ev.getPointerId(actionIndex)
                            : TouchTarget.ALL_POINTER_IDS;

                    removePointersFromTouchTargets(idBitsToAssign);

                    final int childrenCount = mChildrenCount;
                    if (newTouchTarget == null && childrenCount != 0) {
                        final float x = ev.getX(actionIndex);
                        final float y = ev.getY(actionIndex);
                        //  m.遍历所有children,对子view进行针对触摸事件的排序
                        final ArrayList preorderedList = buildTouchDispatchChildList();
                        final boolean customOrder = preorderedList == null
                                && isChildrenDrawingOrderEnabled();
                        final View[] children = mChildren;
                        // n.遍历所有children
                        for (int i = childrenCount - 1; i >= 0; i--) {
                            final int childIndex = getAndVerifyPreorderedIndex(
                                    childrenCount, i, customOrder);
                            final View child = getAndVerifyPreorderedView(
                                    preorderedList, children, childIndex);

                            if (childWithAccessibilityFocus != null) {
                                if (childWithAccessibilityFocus != child) {
                                    continue;
                                }
                                childWithAccessibilityFocus = null;
                                i = childrenCount - 1;
                            }
                            // o.当前遍历的view不能接受到手指触摸事件(View当前不是VISIBLE状态
                            // 或者view当前只在执行动画),或者当前的触摸点不在这个View上
                            // 都需要continue,不必在执行下面的代码,而是去遍历下一个View
                            if (!canViewReceivePointerEvents(child)
                                    || !isTransformedTouchPointInView(x, y, child, null)) {
                                ev.setTargetAccessibilityFocus(false);
                                continue;
                            }
                            // p.代码能执行到这里,说明此View有必要相应这个事件
                            // 检查child在链表中是否存在。如果存在返回,否则返回null
                            // 如果是一组新事件,当前是down,那么newTouchTarget必定返回null
                            newTouchTarget = getTouchTarget(child);
                            // q.
                            if (newTouchTarget != null) {
                                newTouchTarget.pointerIdBits |= idBitsToAssign;
                                break;
                            }

                            resetCancelNextUpFlag(child);
                            // r.
                            if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
                                mLastTouchDownTime = ev.getDownTime();
                                if (preorderedList != null) {
                                    for (int j = 0; j < childrenCount; j++) {
                                        if (children[childIndex] == mChildren[j]) {
                                            mLastTouchDownIndex = j;
                                            break;
                                        }
                                    }
                                } else {
                                    mLastTouchDownIndex = childIndex;
                                }
                                mLastTouchDownX = ev.getX();
                                mLastTouchDownY = ev.getY();
                                // s.将当前view封装成一个TouchTarget对象,并把这个TouchTarget
                                // 对象加入到链表中。将mFirstTouchTarget指向了这个对象,并返回
                                newTouchTarget = addTouchTarget(child, idBitsToAssign);
                                alreadyDispatchedToNewTouchTarget = true;
                                break;
                            }
                            ev.setTargetAccessibilityFocus(false);
                        }
                        if (preorderedList != null) preorderedList.clear();
                    }
                    // t.没有找到能处理此次事件的view并且mFirstTouchTarget !=null,
                    // 把此次事件指派给链表的最后一个touchTarget处理
                    if (newTouchTarget == null && mFirstTouchTarget != null) {
                        newTouchTarget = mFirstTouchTarget;
                        while (newTouchTarget.next != null) {
                            newTouchTarget = newTouchTarget.next;
                        }
                        newTouchTarget.pointerIdBits |= idBitsToAssign;
                    }
                }
            }

            if (mFirstTouchTarget == null) {
                // u.没有touchTarget能处理事件,那还是本viewGroup自己来处理这次事件吧
                handled = dispatchTransformedTouchEvent(ev, canceled, null,
                        TouchTarget.ALL_POINTER_IDS);
            } else {
                TouchTarget predecessor = null;
                TouchTarget target = mFirstTouchTarget;
                while (target != null) {
                    final TouchTarget next = target.next;
                    // v.这个if语句成立的条件就是执行了注释编号r的if语句块,那个语句块中确实消费了事件,
                    // 所以这里的handled直接赋值为了true
                    if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
                        handled = true;
                    } else {
                        final boolean cancelChild = resetCancelNextUpFlag(target.child)
                                || intercepted;
                        // w.事件分发下去
                        if (dispatchTransformedTouchEvent(ev, cancelChild,
                                target.child, target.pointerIdBits)) {
                            handled = true;
                        }
                        if (cancelChild) {
                            if (predecessor == null) {
                                mFirstTouchTarget = next;
                            } else {
                                predecessor.next = next;
                            }
                            target.recycle();
                            target = next;
                            continue;
                        }
                    }
                    predecessor = target;
                    target = next;
                }
            }

            if (canceled
                    || actionMasked == MotionEvent.ACTION_UP
                    || actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
                resetTouchState();
            } else if (split && actionMasked == MotionEvent.ACTION_POINTER_UP) {
                final int actionIndex = ev.getActionIndex();
                final int idBitsToRemove = 1 << ev.getPointerId(actionIndex);
                removePointersFromTouchTargets(idBitsToRemove);
            }
        }

        if (!handled && mInputEventConsistencyVerifier != null) {
            mInputEventConsistencyVerifier.onUnhandledEvent(ev, 1);
        }
        return handled;
    }

此方法逻辑比较复杂,理解此方法是理解事件分发机制的关键。可以说此方法弄明白了,事件分发的机制也就弄明白了。

模拟一个场景,一个activity中仅包含一个ViewGroup,这个ViewGroup又仅仅包含一个View。现在假设执行了从屏幕上滑动了一段距离的操作。

其他什么都保持不变
  • 1 mDecor执行其父类ViewGroup中的dispatchTouchEvent
  • 2 首先响应这组事件中的down事件,所以会进入到注释编号f的代码块中,此时disallowIntercept 为false,所以会执行intercepted = onInterceptTouchEvent(ev); intercepted被赋值为false。
  • 3 进入注释标号为l的if语句块中,执行到注释编号为p的代码时
    private TouchTarget getTouchTarget(@NonNull View child) {
        for (TouchTarget target = mFirstTouchTarget; target != null; target = target.next) {
            if (target.child == child) {
                return target;
            }
        }
        return null;
    }

由于此时mFirstTouchTarget为null,所以返回null。向下继续执行,由于newTouchTarget ==null,所以不会进入q中

  • 4 执行到编号为r处执行dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)
    private boolean dispatchTransformedTouchEvent(MotionEvent event, boolean cancel,
            View child, int desiredPointerIdBits) {
        final boolean handled;
        // ......
        final MotionEvent transformedEvent;
        if (newPointerIdBits == oldPointerIdBits) {
            if (child == null || child.hasIdentityMatrix()) {
                if (child == null) {
                    handled = super.dispatchTouchEvent(event);
                } else {
                    final float offsetX = mScrollX - child.mLeft;
                    final float offsetY = mScrollY - child.mTop;
                    event.offsetLocation(offsetX, offsetY);

                    handled = child.dispatchTouchEvent(event);

                    event.offsetLocation(-offsetX, -offsetY);
                }
                return handled;
            }
            transformedEvent = MotionEvent.obtain(event);
        } else {
            transformedEvent = event.split(newPointerIdBits);
        }

        if (child == null) {
            handled = super.dispatchTouchEvent(transformedEvent);
        } else {
            final float offsetX = mScrollX - child.mLeft;
            final float offsetY = mScrollY - child.mTop;
            transformedEvent.offsetLocation(offsetX, offsetY);
            if (! child.hasIdentityMatrix()) {
                transformedEvent.transform(child.getInverseMatrix());
            }

            handled = child.dispatchTouchEvent(transformedEvent);
        }

        transformedEvent.recycle();
        return handled;
    }

此方法很重要,但是逻辑很简单。就是如果child==null,就调用super.dispatchTouchEvent(event);;否则调用child.dispatchTouchEvent(event);,所以会进入view的dispatchTouchEvent方法。

    public boolean dispatchTouchEvent(MotionEvent event) {    
        boolean result = false;
        if (onFilterTouchEventForSecurity(event)) {
            if (li != null && li.mOnTouchListener != null
                    && (mViewFlags & ENABLED_MASK) == ENABLED
                    && li.mOnTouchListener.onTouch(this, event)) {
                result = true;
            }
            if (!result && onTouchEvent(event)) {
                result = true;
            }
        }
        return result;
    }

省略的其他代码,可以清晰的看到,只有该View的OnTouchListener的onTouch方法和它的onTouchEvent方法返回true,result才会为true,否则就会返回false。此情景中view调用dispatchTouchEvent的返回值应为false,所以ViewGroup中的dispatchTransformedTouchEvent也返回了false。不会进入编号r中的if块中。

  • 5 程序继续向下执行,会进入到编号为u的代码处,handled = dispatchTransformedTouchEvent(ev, canceled, null,TouchTarget.ALL_POINTER_IDS); 还是执行dispatchTransformedTouchEvent方法,只是这次child参数为null了,按照此方法的逻辑,会调用它自己父类中的dispatchTouchEvent方法,会依然返回false。所以在u处handled被赋值为false。至此,ViewGroup中的一次dispatchTouchEvent执行完毕,并返回了false。
  • 6 activity#dispatchTouchEvent的getWindow().superDispatchTouchEvent(ev)返回了false,所以执行了activity的onTouchEvent方法。
  • 7 刚刚仅仅是一次down的操作,此时又有一系列move事件触发。同样通过mDecor执行其父类ViewGroup中的dispatchTouchEvent
  • 8 执行到f代码处,由于不符合if的成立条件,所以intercepted被赋值为ture;代码直接执行到了u处,同样会返回false,同样最终也会调用activity的onTouchEvent。
这次设置最里层view的onTouchListener的onTouch返回值为true
  • 1 前面的流程与上面的1、2、3的步骤一模一样。只是在第4步中调用child.dispatchTouchEvent(event);时,由于此时child的onTouch返回了true,所以dispatchTransformedTouchEvent也返回了true。进入了if语句中,执行了newTouchTarget = addTouchTarget(child, idBitsToAssign);
  • 2 程序向下执行,走到了编号v处,ViewGroup中的一次dispatchTouchEvent执行down操作结束,并返回了true。
  • 3 activity#dispatchTouchEvent的getWindow().superDispatchTouchEvent(ev)返回了true,不执行activity的onTouchEvent方法了。
  • 4 接着触发一系列的move事件,接着执行ViewGroup中的dispatchTouchEvent
  • 5 执行到f处,由于mFirstTouchTarget已经不为null了,所以进入if语句。执行h,intercepted被赋值为false。
  • 6 进入l处的if语句,在执行newTouchTarget = getTouchTarget(child);后,newTouchTarget 这时已经不为null了,已经找到了处理事件的touchTarget,所以直接break
  • 7 按照流程直接会走到w处去分发事件,执行dispatchTransformedTouchEvent(ev, cancelChild,target.child, target.pointerIdBits) ,此时返回值会为true,所以handled为true。
  • 8 同理,Activity#onTouchEvent不执行
重写ViewGroup的onInterceptTouchEvent返回值为true,并让onTouchEvent返回值也为true
  • 1 前面的流程与第一种情况的1、2、3步骤一样。当代码执行到编号r的注释处执行child.dispatchTouchEvent(event);时,当遍历传入的child为ViewGroup时,会执行这个ViewGroup的dispatchTouchEvent
  • 2 又会依次执行 a,b,c,d,e,f,g代码,执行到h时,由于此ViewGroup的onInterceptTouchEvent方法返回了true,所以intercepted被赋值为true
  • 3 代码就会直接执行编号为u的代码,执行了此VIewGroup自己父类的dispatchTouchEvent。去执行了它自己的onTouchEvent,并返回了true,所以此VIewGroup的dispatchTouchEvent方法也返回了true。
  • 4 那么在mDeocr调用的dispatchTouchEvent方法中,编号为r处的代码返回了true,所以进入此次if语句块
  • 5 接着执行v处代码,handled被赋值为true,表明此次事件被消耗掉了,所以Activity#onTouchEvent没被调用
  • 6 接着又来了一系列的move事件,会依次执行a b c e f h , intercepted被赋值为false.
  • 7 进入标号l注释中,执行p后,newTouchTarget 不为null,取出了谁要处理此次事件,break
  • 8 运行w处代码,将向下分发事件,此处的child就为viewGroup,调用了viewGroup的dispatchTouchEvent,然后是onTouchEvent,返回true。所以mDeocr中的dispatchTouchEvent返回的是true,依然不会调用Activity#onTouchEvent方法
  • 9 up事件同理

其他情况也都一样,只要理解了dispatchTouchEvent的逻辑,也就理解了事件分发的逻辑

你可能感兴趣的:(事件分发机制源码分析)