一、引言
最开始学习事件分发机制的时 候,我看的是郭霖大神的博客(详情请点击),写的非常棒,也熟悉了事件分发机制在实际开发中该如何运用。但我并不满足仅仅知道what,我还想知道how、why,所以,我也开始了阅读源码之路。郭霖大神写事件分发博客的时候是2013年,那时候还是早期的Android源码,所以我这回选择了看API-24的源码,想了解一下随着版本的提升,谷歌工程师在事件分发机制中又做了哪些事情。虽然看起来更加费劲和耗时,但是最终的结果还是没有让我失望的,接下来我就和大家一起分享一下我的成果~本人现在还是一枚菜鸟,如果哪里有不对或者不严谨的,希望各位大神提出宝贵的建议
二、我们先看一个常见的问题
我们知道,在使用控件的时候,可以对控件设置点击事件监听(setOnClickListener),也可以设置触摸事件监听(setOnTouchListener)。那么,如果我们同时设置了这两个监听器,我们触摸控件的时候会触发哪个监听器呢?我们来做一个测试。
我写了一个很简单的Demo,布局中添加了一个Button,对Button设置了两种监听器
因为代码比较简单,布局文件只添加了一个button,所以我就只贴出来Activity的代码:
public class TestActivity extends Activity { private Button button; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_test); initView(); initEvent(); } private void initView() { button = (Button) findViewById(R.id.bton); } private void initEvent() { button.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { Log.i("JtyTest","调用了onClick方法"); } }); button.setOnTouchListener(new View.OnTouchListener() { @Override public boolean onTouch(View v, MotionEvent event) { Log.i("JtyTest","调用了onTouch方法"); return false; } }); } }
我们注意到,onTouch方法是有返回值的,这个返回值是什么作用呢?我们首先将返回值设置为false试试好的,我们点击一下Button
接着,我们将onTouch方法的返回值设置为true,然后再点击一下Button
从结果我们可以看出:对一个控件同时设置了OnClickListener和OnTouchListener,如果onTouch的返回值是false,onTouch方法会先执行;如果onTouch的返回值是true,在触摸时,只会执行onTouch方法。这是为什么呢?底层到底做了怎样的逻辑?下面我带大家从源码的角度分析一下View的事件分发机制。
三、找到事件分发机制的源码
首先,我们要找到,系统是在哪个地方调用了onTouch和onClick方法。我们先 找onClick方法:我们可以看到,onClick是在performClick()方法中调用的。
performClick()是在onTouchEvent()方法中调用的(因为代码块太大,只截了调用部分的图)
继续往上找,我们发现onTouchEvent()是在dispatchTouchEvent()方法中调用的(因为代码块太大,只截了调用部分的图)
接着,我们来看看onTouch方法:我们发现,onTouch方法也是在dispatchTouchEvent()方法中调用的(因为代码块太大,只截了调用部分的图)
通过查看onTouch和onClick的调用位置,我们可以发现,这两种事件,都是由dispatchTouchEvent()方法调用的。这里我们引入一个知识点:只要触摸到了任何一个控件,就一定会调用该控件的dispatchTouchEvent方法。dispatchTouchEvent()方法的名字翻译过来就是:分发触摸事件,这个方法就是View的事件分发机制的核心。ok,接下来我们就看看这个dispatchTouchEvent()方法内到底是怎样一个逻辑!
四、分析源码
如下是dispatchTouchEvent方法的源码(API-24的源码),我对代码进行了注释(有些是个人理解,有些是官方注释的翻译)如有理解错误的地方,欢迎各位进行批评指正
/** * 将触摸屏运动事件向下传递到目标View,如果该视图是目标View。 * * @param event 要调用的移动事件 * @return 如果事件由本View处理,则为true,否则为false。 */ public boolean dispatchTouchEvent(MotionEvent event) { //如果事件应该首先分发给有焦点的View if (event.isTargetAccessibilityFocus()) { //当前View没有焦点,不处理事件。 if (!isAccessibilityFocusedViewOrHost()) { return false; } //当前View有焦点并获得了事件,擦除事件的Flag,然后进行正常的事件分发 event.setTargetAccessibilityFocus(false); } boolean result = false; //这个变量用来表示当前View是否需要事件 //判断:输入事件一致性验证器存在,就检查触摸事件 //这个验证器实际上就是对触摸事件进行记录,并且以log的形式打印出来 if (mInputEventConsistencyVerifier != null) { mInputEventConsistencyVerifier.onTouchEvent(event, 0); } //获取触摸事件的类型,判断:如果是ACTION_DOWN,就停止嵌套滑动 //关于嵌套滑动,请去了解:嵌套滑动机制 final int actionMasked = event.getActionMasked(); if (actionMasked == MotionEvent.ACTION_DOWN) { stopNestedScroll(); } /**********核心逻辑从此处开始**********/ //判断:如果事件可以被分发,进入事件分发逻辑,如果事件不允许分发,就不进行分发 //if中的onFilterTouchEventForSecurity方法是来判断事件是否允许被分发的,我们会单独拿出来分析 if (onFilterTouchEventForSecurity(event)) { //判断:如果View时enable的,并且,事件被处理为拖动滚动条 if ((mViewFlags & ENABLED_MASK) == ENABLED && handleScrollBarDragging(event)) { result = true; } //如果 存在onTouchListener,并且,View是enable的,就执行一下onTouch方法 //onTouch方法返回的是true,那么result就是true ListenerInfo li = mListenerInfo; if (li != null && li.mOnTouchListener != null && (mViewFlags & ENABLED_MASK) == ENABLED && li.mOnTouchListener.onTouch(this, event)) { result = true; } //如果之前result不是true(上面两个if没有成立),就执行一下onTouchEvent方法 //如果onTouchEvent方法返回true,那么result就是true if (!result && onTouchEvent(event)) { result = true; } } /**********核心逻辑结束**********/ //判断:如果没有进行事件分发,并且输入事件一致性验证器存在,就告知验证器事件未处理 if (!result && mInputEventConsistencyVerifier != null) { mInputEventConsistencyVerifier.onUnhandledEvent(event, 0); } //判断:如果这是手势的结束,停止嵌套滑动 if (actionMasked == MotionEvent.ACTION_UP || actionMasked == MotionEvent.ACTION_CANCEL || (actionMasked == MotionEvent.ACTION_DOWN && !result)) { stopNestedScroll(); } return result; }
onFilterTouchEventForSecurity()方法:出于安全角度过滤事件这里很容易理解,如果我们的Window被其他窗体遮挡并且失去焦点了,那点击肯定无效了public boolean onFilterTouchEventForSecurity(MotionEvent event) { //判断:如果当前的Window是否被其他View遮挡失去焦点,就不允许事件分发 if ((mViewFlags & FILTER_TOUCHES_WHEN_OBSCURED) != 0 && (event.getFlags() & MotionEvent.FLAG_WINDOW_IS_OBSCURED) != 0) { return false; } return true; }
从源码可以看出,最主要的逻辑,就是判断事件是否允许分发(36-59行),如果允许就进行分发。在分发的时候,做了3个if判断,这里大家可能有些蒙,我再为大家复述一下步骤:
- 第一个if:如果控件是可用的,系统会去判断这个事件是不是一个拖拽滚动条的动作,如果是拖拽滚动条,就将事件做为拖拽动作来处理,并且将result设置为true,如果不是拖拽滚动条,就啥也不做
- 第二个if:如果控件是可用的,并且也有onTouchListener的实例,系统就会调用onTouch方法,如果onTouch方法返回的值是true,就将result设置为true
- 第三个if:如果result不是true,就执行onTouchEvent方法,如果onTouchEvent方法返回的是true,就将result设置为true
五、什么?你还是有点蒙?ok,放大招!
我们来画一个事件分发机制的流程图~
好,我们来参照流程图来捋一捋最开始的问题。如果我们的onTouch方法返回的是false,就会去执行onTouchEvent方法,我们onClick方法就被调用了;如果onTouch方法返回的是true,就不会去执行onTouch方法~这下我们心中的疑问就解决了
六、小结
通过本篇的分析,我们可以知道一些View事件分发的规律:
- 不管事件是否是拖拽滚动条的动作,onTouch方法都有机会执行(如果控件不可用或者没有onTouchListener的实例,就不会执行了)
- 执行onTouch方法之后是否去执行onTouchEvent方法,要看onTouch的返回值,如果onTouch方法的返回值为true,那么就不会去执行onTouchEvent
- 如果控件不可用,也会走onTouchEvent方法
ok~相信大家通过源码的分析和流程图,对View的事件分发机制的主要逻辑已经清楚了。但是我们肯定还有疑问,View的事件是谁分发给它的呢?没错,就是ViewGroup!那么,ViewGroup是以什么样的逻辑进行分发的呢?接下来,我们该上主出菜了:探索Android事件分发机制,带你通过源码分析事件分发流程——ViewGroup篇