13.View的事件分发机制——dispatchTouchEvent详解

 在前面的第二篇文章中，我们提过，View的事件分发是一种委托思想：上层委托下层，父容器委托子元素来处理这个流程。接下来，我们就将深入去学习View的事件分发机制。

1.事件的传递流程

    事件，在Android中对应的类是MotionEvent，因此，我们要分析的就是MotionEvent这个类。对点击事件的分发，其实就是对MotionEvent的对象进行处分发。所以，当一个MotionEvent产生以后（从驱动读取），系统需要把这个事件传递给一个具体的View，这个传递的过程就是分发过程，点击事件由三个很重要的方法完成：

public boolean dispatchTouchEvent( MotionEvent event)
            用于进行事件的分发，如果事件能够传递给当前的View，那么此方法一定会被调用。返回结构受当前View的onTouchEvent和下级View的dispatchTouchEvent方法的影响，表示是否消耗当前事件。
public boolean onIntercptTouchEvent( MotionEvent event )
            在上述方法内部调用，用来判断是否拦截某个事件，如果当前View拦截了某个事件，那么在同一个事件序列中，此方法不会被再次调用，返回结果是表示是否拦截当前事件。本方法不在View内部，在ViewGroup中的dispatchEvent被调用。
public boolean onTouchEvent( MotionEvent event )

            在dispatchTouchEvent方法中调用，用来处理点击事件，返回结果表示是否消耗当前事件，如果不消耗，则在同一个事件序列中，当前View无法再次接收到事件，事件全部往下传递给子View去了。
        例如自定义了一个MyTestView，重写了onTouchEvent方法如下：
        @Override
       public boolean onTouchEvent(MotionEvent event) {

        switch (event.getAction()) {
        case MotionEvent.ACTION_DOWN:
            Log.d( "MyTestView",  "================ Action down ==============");
            return true;
         case MotionEvent.ACTION_MOVE:
            Log.d( "MyTestView",  "================ Action move ==============");
            return true;

         case MotionEvent.ACTION_UP:
            Log.d( "MyTestView",  "================ Action up ==============");
            return true;

         default:
            break;
        }

    触摸，打印出来截图为：
    


    然后，修改方法为如下：
    @Override
    public boolean onTouchEvent(MotionEvent event) {

        switch (event.getAction()) {
        case MotionEvent.ACTION_DOWN:
            Log.d( "MyTestView",  "================ Action down ==============");
            return false;
         case MotionEvent.ACTION_MOVE:
            Log.d( "MyTestView",  "================ Action move ==============");
            return true;

         case MotionEvent.ACTION_UP:
            Log.d( "MyTestView",  "================ Action up ==============");
            return true;

         default:
            break;
        }
    打印的结果为：



    可以看到，我们在down事件reture false了，那么之后的up事件和move事件都不执行本方法了。
 
   对于一个根ViewGroup来说，点击事件产生了以后，首先会传递给它，此时，它的dispatchTouchEvent会被调用，在dispatcTouchEvent中，onintereptTouchEvent会被调用，如果onInterceptTouchEvent返回了true,表示在这边拦截事件，这时候，就会调用ViewGroup的onTouchEvent
，否则的话，就根据事件发生的位置，选择一组子元素（需要可见），处理事件，直到遍历了全部的子元素，然后子元素再调用dispatchTouchEvent。

    当一个View需要处理事件的时候，如果它设置了OnTouchListener ，那么OnTouchListener中onTouch方法会被回调，这时候，如果onTouchListner的onTouch返回了true,那么就代表，已经消费了这个事件，则事件不会传递到onTouchEvent，如果返回为false.则会继续调用onTouchEvent，所以onTouchListener的优先级最高，并且，onTouchEvent中会调用onClickListener，所以OnClickListener的优先级是最低的。
    当onTouchEvent或者是onToucListsner#onTouch方法返回为true的时候，dispatchOnTouchEvent就不会再继续被调用了。
    下面是点击事件产生过程相关元素的关系图(底层实现:http://www.cnblogs.com/samchen2009/p/3368158.html):



    
    当事件产生了以后，会按照下面的流程传递：
    
    顶级View接收到事件后，就会按照事件分发机制去分发事件，这边的顶级View的对象是一个ViewGroup。之后会详细讨论这个顶级View.
    一个事件序列，只能被一个ViewGroup拦截且消耗。
    
2.dispatchTouchEvent方法详解

    在详细解释这个方法之前，我们要先了解几个东西：
    1.位运算。在这个方法里面，大量使用了位运算，这样对于一些很少使用位运算的人来说，这个代码是有点晦涩难懂的，下面我们先简单地说下位运算的好处。    
    首先是与（&）运算
    比如，我们有一个对一个16bit的int的数值进行划分，其中最后个bit，表示的当前View的可见性，不为0则是可见，第8个bit，不为0代表可以获取焦点，比如现在有个值为：0x0101 意思就是可见，并且可以获取焦点
    那么我们要判断view是不是可见，那么我们就可以直接进行下面的操作
     0x0101 & 0xff  ,结果是0x01 那么，我们就可以拿这个值直接去判断了，
    使用位运算，我们可以让每个bit都有一可以表示一个Boolean值，也可以把一个数值的值，分成几个部分，将不同状态集合在一个变量当中。
    或运算可以让我们把状态赋予进去，比如我们现在为view可见0x0001希望这个变量承载一个可以获取焦点的flag(值为0x0100)，那么我们就只需要进行下面的操作：
    0x0001 | 0x0100 得到的值为0x0101 这样，我们就放入了一个数据进去了。
    非运算和与运算一起用可以让我们清空保存的变量，比如如下：
    我们现在改变了View的可见性了，设置为不可见，我们就要做下面的操作
    if( (flag & 0x01)!=0)//不为0那么就是说可见啊。
    {
        flag &=~0x01 ；//等价于flg&0xfe ，让最后一位为0
    }
    通过上面的代码，我们就把最后一位设置为0.这样子，我们就把view设为了不可见了。
    2.pointer 表示的应该就是点，经常表示的就是我们手指的触摸点 2个手指触摸，就有2个pointer
    3.TouchTarget
        TouchTarget是表示pointer（触摸点）和子View的关系

下面是dispatchTouchEvent的代码注释

public boolean dispatchTouchEvent(MotionEvent ev) {
//验证事件是否连续
if (mInputEventConsistencyVerifier != null) {
mInputEventConsistencyVerifier.onTouchEvent(ev, 1);
}
//这个变量用于记录事件是否被处理完
boolean handled = false;
//过滤掉一些不合法的事件：当前的View的窗口被遮挡了。
if (onFilterTouchEventForSecurity(ev)) {
//如果事件发生的View在的窗口，没有被遮挡
final int action = ev.getAction();
//重置前面为0 ，只留下后八位，用于判断相等时候，可以提高性能。
final int actionMasked = action & MotionEvent.ACTION_MASK;
//判断是不是Down事件，如果是的话，就要做初始化操作
if (actionMasked == MotionEvent.ACTION_DOWN) {
//如果是down事件，就要清空掉之前的状态，比如,重置手势判断什么的。
//比如，之前正在判断是不是一个单点的滑动，但是第二个down来了，就表示，不可能是单点的滑动，要重新开始判断触摸的手势
//清空掉mFirstTouchTarget
// Throw away all previous state when starting a new touch gesture.
// The framework may have dropped the up or cancel event for the previous gesture
// due to an app switch, ANR, or some other state change.
cancelAndClearTouchTargets(ev);
resetTouchState();
}

//检查是否拦截事件
final boolean intercepted;
//如果当前是Down事件，或者已经有处理Touch事件的目标了
if (actionMasked == MotionEvent.ACTION_DOWN
|| mFirstTouchTarget != null) {
//判断允不允许这个View拦截
//使用与运算作为判断，可以让我们在flag中，存储好几个标志
final boolean disallowIntercept = (mGroupFlags & FLAG_DISALLOW_INTERCEPT) != 0;
//如果说允许拦截事件
if (!disallowIntercept) {
//确定是不是拦截了
intercepted = onInterceptTouchEvent(ev);
//重新恢复Action，以免action在上面的步骤被人为地改变了
ev.setAction(action); // restore action in case it was changed
} else {
intercepted = false;
}
} else {
// There are no touch targets and this action is not an initial down
// so this view group continues to intercept touches.
//如果说，事件已经初始化过了，并且没有子View被分配处理，那么就说明，这个ViewGroup已经拦截了这个事件
intercepted = true;
}

// Check for cancelation.
//如果viewFlag被设置了PFLAG_CANCEL_NEXT_UP_EVENT ,那么就表示，下一步应该是Cancel事件
//或者如果当前的Action为取消，那么当前事件应该就是取消了。
final boolean canceled = resetCancelNextUpFlag(this)
|| actionMasked == MotionEvent.ACTION_CANCEL;

// Update list of touch targets for pointer down, if needed.
//如果需要（不是取消，也没有被拦截）的话，那么在触摸down事件的时候更新触摸目标列表
//split代表，当前的ViewGroup是不是支持分割MotionEvent到不同的View当中
final boolean split = (mGroupFlags & FLAG_SPLIT_MOTION_EVENTS) != 0;
//新的触摸对象，
TouchTarget newTouchTarget = null;
//是否把事件分配给了新的触摸
boolean alreadyDispatchedToNewTouchTarget = false;
//事件不是取消事件，也没有拦截那么就要判断
if (!canceled && !intercepted) {
//如果是个全新的Down事件
//或者是有新的触摸点
//或者是光标来回移动事件（不太明白什么时候发生）
if (actionMasked == MotionEvent.ACTION_DOWN
|| (split && actionMasked == MotionEvent.ACTION_POINTER_DOWN)
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
//这个事件的索引，也就是第几个事件，如果是down事件就是0
final int actionIndex = ev.getActionIndex(); // always 0 for down
//获取分配的ID的bit数量
final int idBitsToAssign = split ? 1 << ev.getPointerId(actionIndex)
: TouchTarget.ALL_POINTER_IDS;

// Clean up earlier touch targets for this pointer id in case they
// have become out of sync.
//清理之前触摸这个指针标识,以防他们的目标变得不同步。
removePointersFromTouchTargets(idBitsToAssign);

final int childrenCount = mChildrenCount;
//如果新的触摸对象为null（这个不是铁定的吗）并且当前ViewGroup有子元素
if (newTouchTarget == null && childrenCount != 0) {
final float x = ev.getX(actionIndex);
final float y = ev.getY(actionIndex);
// Find a child that can receive the event.
// Scan children from front to back.
//下面所做的工作，就是找到可以接收这个事件的子元素
final View[] children = mChildren;
//是否使用自定义的顺序来添加控件
final boolean customOrder = isChildrenDrawingOrderEnabled();
for (int i = childrenCount - 1; i >= 0; i--) {
//如果是用了自定义的顺序来添加控件，那么绘制的View的顺序和mChildren的顺序是不一样的
//所以要根据getChildDrawingOrder取出真正的绘制的View
//自定义的绘制，可能第一个会画到第三个，和第四个，第二个画到第一个，这样里面的内容和Children是不一样的
final int childIndex = customOrder ?
getChildDrawingOrder(childrenCount, i) : i;
final View child = children[childIndex];
//如果child不可以接收这个触摸的事件，或者触摸事件发生的位置不在这个View的范围内
if (!canViewReceivePointerEvents(child)
|| !isTransformedTouchPointInView(x, y, child, null)) {
continue;
}
//获取新的触摸对象，如果当前的子View在之前的触摸目标的列表当中就返回touchTarget
//子View不在之前的触摸目标列表那么就返回null
newTouchTarget = getTouchTarget(child);
if (newTouchTarget != null) {
// Child is already receiving touch within its bounds.
// Give it the new pointer in addition to the ones it is handling.
//如果新的触摸目标对象不为空，那么就把这个触摸的ID赋予它，这样子，
//这个触摸的目标对象的id就含有了好几个pointer的ID了

newTouchTarget.pointerIdBits |= idBitsToAssign;
break;
}
//如果子View不在之前的触摸目标列表中，先重置childView的标志，去除掉CACEL的标志
resetCancelNextUpFlag(child);
//调用子View的dispatchTouchEvent,并且把pointer的id 赋予进去
//如果说，子View接收并且处理了这个事件，那么就更新上一次触摸事件的信息，
//并且为创建一个新的触摸目标对象，并且绑定这个子View和Pointer的ID
if (dispatchTransformedTouchEvent(ev, false, child, idBitsToAssign)) {
// Child wants to receive touch within its bounds.
mLastTouchDownTime = ev.getDownTime();
mLastTouchDownIndex = childIndex;
mLastTouchDownX = ev.getX();
mLastTouchDownY = ev.getY();
newTouchTarget = addTouchTarget(child, idBitsToAssign);
alreadyDispatchedToNewTouchTarget = true;
break;
}
}
}
//如果newTouchTarget为null，就代表，这个事件没有找到子View去处理它，
//那么，如果之前已经有了触摸对象（比如，我点了一张图，另一个手指在外面图的外面点下去）
//那么就把这个之前那个触摸目标定为第一个触摸对象，并且把这个触摸（pointer）分配给最近添加的触摸目标
if (newTouchTarget == null && mFirstTouchTarget != null) {
// Did not find a child to receive the event.
// Assign the pointer to the least recently added target.
newTouchTarget = mFirstTouchTarget;
while (newTouchTarget.next != null) {
newTouchTarget = newTouchTarget.next;
}
newTouchTarget.pointerIdBits |= idBitsToAssign;
}
}
}

// Dispatch to touch targets.
//如果没有触摸目标
if (mFirstTouchTarget == null) {
// No touch targets so treat this as an ordinary view.
//那么就表示我们要自己在这个ViewGroup处理这个触摸事件了
handled = dispatchTransformedTouchEvent(ev, canceled, null,
TouchTarget.ALL_POINTER_IDS);
} else {
// Dispatch to touch targets, excluding the new touch target if we already
// dispatched to it.  Cancel touch targets if necessary.
TouchTarget predecessor = null;
TouchTarget target = mFirstTouchTarget;
//遍历TouchTargt树.分发事件，如果我们已经分发给了新的TouchTarget那么我们就不再分发给newTouchTarget
while (target != null) {
final TouchTarget next = target.next;
if (alreadyDispatchedToNewTouchTarget && target == newTouchTarget) {
handled = true;
} else {
//是否让child取消处理事件，如果为true，就会分发给child一个ACTION_CANCEL事件
final boolean cancelChild = resetCancelNextUpFlag(target.child)
|| intercepted;
//派发事件
if (dispatchTransformedTouchEvent(ev, cancelChild,
target.child, target.pointerIdBits)) {
handled = true;
}
//cancelChild也就是说，派发给了当前child一个ACTION_CANCEL事件，
//那么就移除这个child
if (cancelChild) {
//没有父节点，也就是当前是第一个TouchTarget
//那么就把头去掉
if (predecessor == null) {
mFirstTouchTarget = next;
} else {
//把下一个赋予父节点的上一个，这样当前节点就被丢弃了
predecessor.next = next;
}
//回收内存
target.recycle();
//把下一个赋予现在
target = next;
//下面的两行不执行了，因为我们已经做了链表的操作了。
//主要是我们不能执行predecessor=target，因为删除本节点的话，父节点还是父节点
continue;
}
}
//如果没有删除本节点，那么下一轮父节点就是当前节点，下一个节点也是下一轮的当前节点
predecessor = target;
target = next;
}
}

// Update list of touch targets for pointer up or cancel, if needed.
//遇到了取消事件、或者是单点触摸下情况下手指离开，我们就要更新触摸的状态
if (canceled
|| actionMasked == MotionEvent.ACTION_UP
|| actionMasked == MotionEvent.ACTION_HOVER_MOVE) {
resetTouchState();
} else if (split && actionMasked == MotionEvent.ACTION_POINTER_UP) {
//如果是多点触摸下的手指抬起事件，就要根据idBit从TouchTarget中移除掉对应的Pointer(触摸点)
final int actionIndex = ev.getActionIndex();
final int idBitsToRemove = 1 << ev.getPointerId(actionIndex);
removePointersFromTouchTargets(idBitsToRemove);
}
}

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