Android View 事件分发机制 源码解析 （上）

一直想写事件分发机制的文章，不管咋样，也得自己研究下事件分发的源码，写出心得~

首先我们先写个简单的例子来测试View的事件转发的流程~

1、案例

为了更好的研究View的事件转发，我们自定以一个MyButton继承Button，然后把跟事件传播有关的方法进行复写，然后添加上日志~

MyButton

1. package com.example.zhy_event03;
2. import android.content.Context;
3. import android.util.AttributeSet;
4. import android.util.Log;
5. import android.view.MotionEvent;
6. import android.widget.Button;
7. public class MyButton extends Button
8. {
9. private static final String TAG = MyButton.class.getSimpleName();
10. public MyButton(Context context, AttributeSet attrs)
11. {
12. super(context, attrs);
13. }
14. @Override
15. public boolean onTouchEvent(MotionEvent event)
16. {
17. int action = event.getAction();
18. switch (action)
19. {
20. case MotionEvent.ACTION_DOWN:
21. Log.e(TAG, "onTouchEvent ACTION_DOWN");
22. break;
23. case MotionEvent.ACTION_MOVE:
24. Log.e(TAG, "onTouchEvent ACTION_MOVE");
25. break;
26. case MotionEvent.ACTION_UP:
27. Log.e(TAG, "onTouchEvent ACTION_UP");
28. break;
29. default:
30. break;
31. }
32. return super.onTouchEvent(event);
33. }
34. @Override
35. public boolean dispatchTouchEvent(MotionEvent event)
36. {
37. int action = event.getAction();
38. switch (action)
39. {
40. case MotionEvent.ACTION_DOWN:
41. Log.e(TAG, "dispatchTouchEvent ACTION_DOWN");
42. break;
43. case MotionEvent.ACTION_MOVE:
44. Log.e(TAG, "dispatchTouchEvent ACTION_MOVE");
45. break;
46. case MotionEvent.ACTION_UP:
47. Log.e(TAG, "dispatchTouchEvent ACTION_UP");
48. break;
49. default:
50. break;
51. }
52. return super.dispatchTouchEvent(event);
53. }
54. }

在onTouchEvent和dispatchTouchEvent中打印了日志~

然后把我们自定义的按钮加到主布局文件中；

布局文件：

1. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
2. xmlns:tools="http://schemas.android.com/tools"
3. android:layout_width="match_parent"
4. android:layout_height="match_parent"
5. tools:context=".MainActivity" >
6. <com.example.zhy_event03.MyButton
7. android:id="@+id/id_btn"
8. android:layout_width="wrap_content"
9. android:layout_height="wrap_content"
10. android:text="click me" />
11. </LinearLayout>

最后看一眼MainActivity的代码

1. package com.example.zhy_event03;
2. import android.app.Activity;
3. import android.os.Bundle;
4. import android.util.Log;
5. import android.view.MotionEvent;
6. import android.view.View;
7. import android.view.View.OnTouchListener;
8. import android.widget.Button;
9. public class MainActivity extends Activity
10. {
11. protected static final String TAG = "MyButton";
12. private Button mButton ;
13. @Override
14. protected void onCreate(Bundle savedInstanceState)
15. {
16. super.onCreate(savedInstanceState);
17. setContentView(R.layout.activity_main);
18. mButton = (Button) findViewById(R.id.id_btn);
19. mButton.setOnTouchListener(new OnTouchListener()
20. {
21. @Override
22. public boolean onTouch(View v, MotionEvent event)
23. {
24. int action = event.getAction();
25. switch (action)
26. {
27. case MotionEvent.ACTION_DOWN:
28. Log.e(TAG, "onTouch ACTION_DOWN");
29. break;
30. case MotionEvent.ACTION_MOVE:
31. Log.e(TAG, "onTouch ACTION_MOVE");
32. break;
33. case MotionEvent.ACTION_UP:
34. Log.e(TAG, "onTouch ACTION_UP");
35. break;
36. default:
37. break;
38. }
39. return false;
40. }
41. });
42. }
43. }

在MainActivity中，我们还给MyButton设置了OnTouchListener这个监听~

好了，跟View事件相关一般就这三个地方了，一个onTouchEvent，一个dispatchTouchEvent，一个setOnTouchListener;

下面我们运行，然后点击按钮，查看日志输出：

1. 08-31 06:09:39.030: E/MyButton(879): dispatchTouchEvent ACTION_DOWN
2. 08-31 06:09:39.030: E/MyButton(879): onTouch ACTION_DOWN
3. 08-31 06:09:39.049: E/MyButton(879): onTouchEvent ACTION_DOWN
4. 08-31 06:09:39.138: E/MyButton(879): dispatchTouchEvent ACTION_MOVE
5. 08-31 06:09:39.138: E/MyButton(879): onTouch ACTION_MOVE
6. 08-31 06:09:39.147: E/MyButton(879): onTouchEvent ACTION_MOVE
7. 08-31 06:09:39.232: E/MyButton(879): dispatchTouchEvent ACTION_UP
8. 08-31 06:09:39.248: E/MyButton(879): onTouch ACTION_UP
9. 08-31 06:09:39.248: E/MyButton(879): onTouchEvent ACTION_UP

我有意点击的时候蹭了一下，不然不会触发MOVE，手抖可能会打印一堆MOVE的日志~~~

好了，可以看到，不管是DOWN，MOVE，UP都会按照下面的顺序执行：

1、dispatchTouchEvent

2、 setOnTouchListener的onTouch

3、onTouchEvent

下面就跟随日志的脚步开始源码的探索~

2、dispatchTouchEvent

首先进入View的dispatchTouchEvent

1. /**
2. * Pass the touch screen motion event down to the target view, or this
3. * view if it is the target.
4. *
5. * @param event The motion event to be dispatched.
6. * @return True if the event was handled by the view, false otherwise.
7. */
8. public boolean dispatchTouchEvent(MotionEvent event) {
9. if (!onFilterTouchEventForSecurity(event)) {
10. return false;
11. }
12. if (mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED &&
13. mOnTouchListener.onTouch(this, event)) {
14. return true;
15. }
16. return onTouchEvent(event);
17. }

直接看13行：首先判断mOnTouchListener不为null，并且view是enable的状态，然后 mOnTouchListener.onTouch(this, event)返回true，这三个条件如果都满足，直接return true ; 也就是下面的onTouchEvent(event）不会被执行了；

那么mOnTouchListener是和方神圣，我们来看看：

1. /**
2. * Register a callback to be invoked when a touch event is sent to this view.
3. * @param l the touch listener to attach to this view
4. */
5. public void setOnTouchListener(OnTouchListener l) {
6. mOnTouchListener = l;
7. }

其实就是我们在Activity中设置的setOnTouchListener。

也就是说：如果我们设置了setOnTouchListener，并且return true，那么View自己的onTouchEvent就不会被执行了，当然了，本例我们return false，我们还得往下探索 ;

已经解决一个常见的问题：View的onTouchListener和onTouchEvent的调用关系，相信大家应该已经明白了~let's go；继续往下。

3、View的onTouchEvent:

接下来是View的onTouchEvent:

1. /**
2. * Implement this method to handle touch screen motion events.
3. *
4. * @param event The motion event.
5. * @return True if the event was handled, false otherwise.
6. */
7. public boolean onTouchEvent(MotionEvent event) {
8. final int viewFlags = mViewFlags;
9. if ((viewFlags & ENABLED_MASK) == DISABLED) {
10. // A disabled view that is clickable still consumes the touch
11. // events, it just doesn't respond to them.
12. return (((viewFlags & CLICKABLE) == CLICKABLE ||
13. (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE));
14. }
15. if (mTouchDelegate != null) {
16. if (mTouchDelegate.onTouchEvent(event)) {
17. return true;
18. }
19. }
20. if (((viewFlags & CLICKABLE) == CLICKABLE ||
21. (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)) {
22. switch (event.getAction()) {
23. case MotionEvent.ACTION_UP:
24. boolean prepressed = (mPrivateFlags & PREPRESSED) != 0;
25. if ((mPrivateFlags & PRESSED) != 0 || prepressed) {
26. // take focus if we don't have it already and we should in
27. // touch mode.
28. boolean focusTaken = false;
29. if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {
30. focusTaken = requestFocus();
31. }
32. if (!mHasPerformedLongPress) {
33. // This is a tap, so remove the longpress check
34. removeLongPressCallback();
35. // Only perform take click actions if we were in the pressed state
36. if (!focusTaken) {
37. // Use a Runnable and post this rather than calling
38. // performClick directly. This lets other visual state
39. // of the view update before click actions start.
40. if (mPerformClick == null) {
41. mPerformClick = new PerformClick();
42. }
43. if (!post(mPerformClick)) {
44. performClick();
45. }
46. }
47. }
48. if (mUnsetPressedState == null) {
49. mUnsetPressedState = new UnsetPressedState();
50. }
51. if (prepressed) {
52. mPrivateFlags |= PRESSED;
53. refreshDrawableState();
54. postDelayed(mUnsetPressedState,
55. ViewConfiguration.getPressedStateDuration());
56. } else if (!post(mUnsetPressedState)) {
57. // If the post failed, unpress right now
58. mUnsetPressedState.run();
59. }
60. removeTapCallback();
61. }
62. break;
63. case MotionEvent.ACTION_DOWN:
64. if (mPendingCheckForTap == null) {
65. mPendingCheckForTap = new CheckForTap();
66. }
67. mPrivateFlags |= PREPRESSED;
68. mHasPerformedLongPress = false;
69. postDelayed(mPendingCheckForTap, ViewConfiguration.getTapTimeout());
70. break;
71. case MotionEvent.ACTION_CANCEL:
72. mPrivateFlags &= ~PRESSED;
73. refreshDrawableState();
74. removeTapCallback();
75. break;
76. case MotionEvent.ACTION_MOVE:
77. final int x = (int) event.getX();
78. final int y = (int) event.getY();
79. // Be lenient about moving outside of buttons
80. int slop = mTouchSlop;
81. if ((x < 0 - slop) || (x >= getWidth() + slop) ||
82. (y < 0 - slop) || (y >= getHeight() + slop)) {
83. // Outside button
84. removeTapCallback();
85. if ((mPrivateFlags & PRESSED) != 0) {
86. // Remove any future long press/tap checks
87. removeLongPressCallback();
88. // Need to switch from pressed to not pressed
89. mPrivateFlags &= ~PRESSED;
90. refreshDrawableState();
91. }
92. }
93. break;
94. }
95. return true;
96. }
97. return false;
98. }

代码还是比较长的，

10-15行，如果当前View是Disabled状态且是可点击则会消费掉事件（return true);可以忽略，不是我们的重点；

17-21行，如果设置了mTouchDelegate，则会将事件交给代理者处理，直接return true，如果大家希望自己的View增加它的touch范围，可以尝试使用TouchDelegate，这里也不是重点，可以忽略；

接下来到我们的重点了：

23行的判断：如果我们的View可以点击或者可以长按，则，注意IF的范围，最终一定return true ;

if (((viewFlags & CLICKABLE) == CLICKABLE ||
                (viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE)) {
           //...
            return true;
        }

接下来就是   switch (event.getAction())了，判断事件类型，DOWN,MOVE,UP等；

我们按照例子执行的顺序，先看  case MotionEvent.ACTION_DOWN （71-78行）:

1、MotionEvent.ACTION_DOWN

75行：给mPrivateFlags设置一个PREPRESSED的标识

76行：设置mHasPerformedLongPress=false；表示长按事件还未触发；

77行：发送一个延迟为ViewConfiguration.getTapTimeout()的延迟消息，到达延时时间后会执行CheckForTap()里面的run方法：

1、ViewConfiguration.getTapTimeout()为115毫秒；

2、CheckForTap

1. private final class CheckForTap implements Runnable {
2. public void run() {
3. mPrivateFlags &= ~PREPRESSED;
4. mPrivateFlags |= PRESSED;
5. refreshDrawableState();
6. if ((mViewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) {
7. postCheckForLongClick(ViewConfiguration.getTapTimeout());
8. }
9. }
10. }

在run方法里面取消mPrivateFlags的PREPRESSED，然后设置PRESSED标识，刷新背景，如果View支持长按事件，则再发一个延时消息，检测长按；

1. private void postCheckForLongClick(int delayOffset) {
2. mHasPerformedLongPress = false;
3. if (mPendingCheckForLongPress == null) {
4. mPendingCheckForLongPress = new CheckForLongPress();
5. }
6. mPendingCheckForLongPress.rememberWindowAttachCount();
7. postDelayed(mPendingCheckForLongPress,
8. ViewConfiguration.getLongPressTimeout() - delayOffset);
9. }

1. class CheckForLongPress implements Runnable {
2. private int mOriginalWindowAttachCount;
3. public void run() {
4. if (isPressed() && (mParent != null)
5. && mOriginalWindowAttachCount == mWindowAttachCount) {
6. if (performLongClick()) {
7. mHasPerformedLongPress = true;
8. }
9. }
10. }

可以看到，当用户按下，首先会设置标识为PREPRESSED

如果115后，没有抬起，会将View的标识设置为PRESSED且去掉PREPRESSED标识，然后发出一个检测长按的延迟任务，延时为：ViewConfiguration.getLongPressTimeout() - delayOffset（500ms -115ms），这个115ms刚好时检测额PREPRESSED时间；也就是用户从DOWN触发开始算起，如果500ms内没有抬起则认为触发了长按事件：

1、如果此时设置了长按的回调，则执行长按时的回调，且如果长按的回调返回true;才把mHasPerformedLongPress置为ture；

2、否则，如果没有设置长按回调或者长按回调返回的是false；则mHasPerformedLongPress依然是false;

好了DOWN就分析完成了；大家回个神，下面回到VIEW的onTouchEvent中的ACTION_MOVE:

2、MotionEvent.ACTION_MOVE

86到105行：

87-88行：拿到当前触摸的x,y坐标；

91行判断当然触摸点有没有移出我们的View，如果移出了：

1、执行removeTapCallback(); 

2、然后判断是否包含PRESSED标识，如果包含，移除长按的检查：removeLongPressCallback();

3、最后把mPrivateFlags中PRESSED标识去除，刷新背景；

1. private void removeTapCallback() {
2. if (mPendingCheckForTap != null) {
3. mPrivateFlags &= ~PREPRESSED;
4. removeCallbacks(mPendingCheckForTap);
5. }
6. }

这个是移除，DOWN触发时设置的PREPRESSED的检测；即当前触发时机在DOWN触发不到115ms时，你就已经移出控件外了；

如果115ms后，你才移出控件外，则你的当前mPrivateFlags一定为PRESSED且发送了长按的检测；

就会走上面的2和3；首先移除removeLongPressCallback（）
 private void removeLongPressCallback() {
        if (mPendingCheckForLongPress != null) {
          removeCallbacks(mPendingCheckForLongPress);
        }
    }

然后把mPrivateFlags中PRESSED标识去除，刷新背景；

好了，MOVE我们也分析完成了，总结一下：只要用户移出了我们的控件：则将mPrivateFlags取出PRESSED标识，且移除所有在DOWN中设置的检测，长按等；

下面再回个神，回到View的onTouchEvent的ACTION_UP：

3、MotionEvent.ACTION_UP

26到69行：

27行：判断mPrivateFlags是否包含PREPRESSED

28行：如果包含PRESSED或者PREPRESSED则进入执行体，也就是无论是115ms内或者之后抬起都会进入执行体。

36行：如果mHasPerformedLongPress没有被执行，进入IF

38行：removeLongPressCallback（）；移除长按的检测

45-50行：如果mPerformClick如果mPerformClick为null，初始化一个实例，然后立即通过handler添加到消息队列尾部，如果添加失败则直接执行 performClick();添加成功，在mPerformClick的run方法中就是执行performClick（）；

终于执行了我们的click事件了，下面看一下performClick()方法：

1. public boolean performClick() {
2. sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);
3. if (mOnClickListener != null) {
4. playSoundEffect(SoundEffectConstants.CLICK);
5. mOnClickListener.onClick(this);
6. return true;
7. }
8. return false;
9. }

if (mOnClickListener != null) {    
            mOnClickListener.onClick(this);
            return true;
        }

久违了~我们的mOnClickListener ；

别激动，还没结束，回到ACTION_UP，

58行：如果prepressed为true，进入IF体：

为mPrivateFlags设置表示为PRESSED，刷新背景，125毫秒后执行mUnsetPressedState

否则：mUnsetPressedState.run();立即执行；也就是不管咋样，最后mUnsetPressedState.run()都会执行；

看看这个UnsetPressedState主要干什么:

private final class UnsetPressedState implements Runnable {
        public void run() {
            setPressed(false);
        }
    }

public void setPressed(boolean pressed) {
        if (pressed) {
            mPrivateFlags |= PRESSED;
        } else {
            mPrivateFlags &= ~PRESSED;
        }
        refreshDrawableState();
        dispatchSetPressed(pressed);
    }

把我们的mPrivateFlags中的PRESSED取消，然后刷新背景，把setPress转发下去。

ACTION_UP的最后一行：removeTapCallback()，如果mPendingCheckForTap不为null，移除;

4、总结

好了，代码跨度还是相当大的，下面需要总结下：

1、整个View的事件转发流程是：

View.dispatchEvent->View.setOnTouchListener->View.onTouchEvent

在dispatchTouchEvent中会进行OnTouchListener的判断，如果OnTouchListener不为null且返回true，则表示事件被消费，onTouchEvent不会被执行；否则执行onTouchEvent。

2、onTouchEvent中的DOWN,MOVE,UP

DOWN时：

a、首先设置标志为PREPRESSED，设置mHasPerformedLongPress=false ;然后发出一个115ms后的mPendingCheckForTap；

b、如果115ms内没有触发UP，则将标志置为PRESSED，清除PREPRESSED标志，同时发出一个延时为500-115ms的，检测长按任务消息；

c、如果500ms内（从DOWN触发开始算），则会触发LongClickListener:

此时如果LongClickListener不为null，则会执行回调，同时如果LongClickListener.onClick返回true，才把mHasPerformedLongPress设置为true;否则mHasPerformedLongPress依然为false;

MOVE时：

主要就是检测用户是否划出控件，如果划出了：

115ms内，直接移除mPendingCheckForTap；

115ms后，则将标志中的PRESSED去除，同时移除长按的检查：removeLongPressCallback();

UP时：

a、如果115ms内，触发UP，此时标志为PREPRESSED，则执行UnsetPressedState，setPressed(false);会把setPress转发下去，可以在View中复写dispatchSetPressed方法接收；

b、如果是115ms-500ms间，即长按还未发生，则首先移除长按检测，执行onClick回调；

c、如果是500ms以后，那么有两种情况：

i.设置了onLongClickListener，且onLongClickListener.onClick返回true，则点击事件OnClick事件无法触发；

ii.没有设置onLongClickListener或者onLongClickListener.onClick返回false，则点击事件OnClick事件依然可以触发；

d、最后执行mUnsetPressedState.run()，将setPressed传递下去，然后将PRESSED标识去除；

最后问个问题，然后再运行个例子结束：

1、setOnLongClickListener和setOnClickListener是否只能执行一个

不是的，只要setOnLongClickListener中的onClick返回false，则两个都会执行；返回true则会屏幕setOnClickListener

最后我们给MyButton同时设置setOnClickListener和setOnLongClickListener，运行看看：

1. package com.example.zhy_event03;
2. import android.app.Activity;
3. import android.os.Bundle;
4. import android.util.Log;
5. import android.view.MotionEvent;
6. import android.view.View;
7. import android.view.View.OnClickListener;
8. import android.view.View.OnLongClickListener;
9. import android.view.View.OnTouchListener;
10. import android.widget.Button;
11. import android.widget.Toast;
12. public class MainActivity extends Activity
13. {
14. protected static final String TAG = "MyButton";
15. private Button mButton ;
16. @Override
17. protected void onCreate(Bundle savedInstanceState)
18. {
19. super.onCreate(savedInstanceState);
20. setContentView(R.layout.activity_main);
21. mButton = (Button) findViewById(R.id.id_btn);
22. mButton.setOnTouchListener(new OnTouchListener()
23. {
24. @Override
25. public boolean onTouch(View v, MotionEvent event)
26. {
27. int action = event.getAction();
28. switch (action)
29. {
30. case MotionEvent.ACTION_DOWN:
31. Log.e(TAG, "onTouch ACTION_DOWN");
32. break;
33. case MotionEvent.ACTION_MOVE:
34. Log.e(TAG, "onTouch ACTION_MOVE");
35. break;
36. case MotionEvent.ACTION_UP:
37. Log.e(TAG, "onTouch ACTION_UP");
38. break;
39. default:
40. break;
41. }
42. return false;
43. }
44. });
45. mButton.setOnClickListener(new OnClickListener()
46. {
47. @Override
48. public void onClick(View v)
49. {
50. Toast.makeText(getApplicationContext(), "onclick",Toast.LENGTH_SHORT).show();
51. }
52. });
53. mButton.setOnLongClickListener(new OnLongClickListener()
54. {
55. @Override
56. public boolean onLongClick(View v)
57. {
58. Toast.makeText(getApplicationContext(), "setOnLongClickListener",Toast.LENGTH_SHORT).show();
59. return false;
60. }
61. });
62. }
63. }

效果图：

可以看到LongClickListener已经ClickListener都触发了~

最后，本篇博文完成了对View的事件分发机制的整个流程的说明，并且对源码进行了分析；

当然了，View结束，肯定到我们的ViewGroup了，请点击：Android ViewGroup事件分发机制