其实 Android 事件分发机制在早几年一直都困扰着我,那时候处理事件分发的自定义 View 脑子都是一片白,老感觉处理不好。后来自己看了 android 源码,也阅读了很多大牛的文章才算彻底明白,总之掌握 Android 事件分发机制是必不可少的,而 Android 事件分发机制绝对不是三言两语就能说得清的。
而今天由于我们自定义 View 进阶的需要,自己也是筹备了很久。目前虽然网上相关的文章也不少,很多也写得非常详细,但是多数文章只是讲了讲理论,然后配合 Log 打印一下结果而已。而我准备不仅带着大家从源码的角度进行分析,还需要理论结合实践写几个关于这方面的效果,这样相信我们会有更深的理解。阅读源码讲究由浅入深,循序渐进,我们就不像其他文章一样搞混合了,先讲 View 的 Touch 事件分发,然后再讲 ViewGroup 的事件分发,最后再写个几次效果。我们一贯的套路都是理论结合实践,由浅入深
先来看几个效果,如前几次我们写自定义评分控件的 RatingBar 复写了 onTouchEvent(),这里只是举个例子:
public class RatingBar extends View {
public RatingBar(Context context) {
super(context);
}
public RatingBar(Context context, @Nullable AttributeSet attrs) {
super(context, attrs);
}
public RatingBar(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
}
@Override
public boolean onTouchEvent(MotionEvent event) {
Log.d("TAG", "onTouchEvent execute -> " + event.getAction());
return super.onTouchEvent(event);
}
}
如果想要给这个控件注册一个点击事件,只需要调用:
mRatingBar.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Log.d("TAG","onClick execute");
}
});
如果想给这个按钮再添加一个touch事件,只需要调用:
mRatingBar.setOnTouchListener(new View.OnTouchListener() {
@Override
public boolean onTouch(View v, MotionEvent event) {
Log.d("TAG", "onTouch execute -> " + event.getAction());
return false;
}
});
上面的代码如果运行起来,哪一个会先执行呢? 如果是靠猜,那么我们来试一下就知道了,运行程序点击,打印结果如下:
可以看到,onTouch 是优先于优先于 onTouchEvent 优先于 onClick 执行的,并且 onTouch 和 onTouchEvent 执行了两次,一次是 ACTION_DOWN ,一次是 ACTION_UP (你还可能会有多次 ACTION_MOVE 的执行,如果你在上面触摸)。因此事件传递的顺序是先经过 onTouch ,然后经过 onTouchEvent ,再传递到 onClick 。
如果留心观察你会发现 setOnTouchListener 是有返回值的,如果返回 ture ,再次运行一下会怎样?
我们发现,onTouchEvent 和 onClick 方法不再执行了!为什么会这样呢?你可以先理解成 onTouch 方法返回 true 就认为这个事件被 onTouch 消费掉了,因而不会再继续 onTouchEvent 和 onClick 。到目前位置如果你清楚了,那么面试的时候基本靠背,那么自己写效果的时候基本靠蒙。我们肯定不能局限于这个装态,接下了我们就带着疑问从源码的角度分析一下,为什么会出现上述情况?
首先我们需要知道,你点击或者或者触摸任何一个 View 都会调用 View 的 dispatchTouchEvent() 方法,我们就从这里开始分析源码:
public boolean dispatchTouchEvent(MotionEvent event) {
// 省略部分代码 ...
boolean result = false;
// 省略部分代码 ...
if (onFilterTouchEventForSecurity(event)) {
//noinspection SimplifiableIfStatement
ListenerInfo li = mListenerInfo;
if (li != null && li.mOnTouchListener != null
&& (mViewFlags & ENABLED_MASK) == ENABLED
&& li.mOnTouchListener.onTouch(this, event)) {
result = true;
}
if (!result && onTouchEvent(event)) {
result = true;
}
}
// 返回 result
return result;
}
省略掉部分代码之后,这个方法就变得非常的简洁了,只有短短几行代码!我们可以看到,在这个方法内,首先是进行了一个判断,如果li != null,mOnTouchListener != null,(mViewFlags & ENABLED_MASK) == ENABLED 和 mOnTouchListener.onTouch(this, event) 这三个条件都为真,result 就是 true,否则就去执行 onTouchEvent(event) 方法并返回。
那么 ListenerInfo 到底是什么?我们可以看下源码,这其实就是有关 View 所有事件的一个集合类,如 OnFocusChangeListener , OnScrollChangeListener , OnClickListener 、、、
static class ListenerInfo {
/**
* Listener used to dispatch focus change events.
* This field should be made private, so it is hidden from the SDK.
* {@hide}
*/
protected OnFocusChangeListener mOnFocusChangeListener;
/**
* Listeners for layout change events.
*/
private ArrayList<OnLayoutChangeListener> mOnLayoutChangeListeners;
protected OnScrollChangeListener mOnScrollChangeListener;
/**
* Listeners for attach events.
*/
private CopyOnWriteArrayList<OnAttachStateChangeListener> mOnAttachStateChangeListeners;
/**
* Listener used to dispatch click events.
* This field should be made private, so it is hidden from the SDK.
* {@hide}
*/
public OnClickListener mOnClickListener;
/**
* Listener used to dispatch long click events.
* This field should be made private, so it is hidden from the SDK.
* {@hide}
*/
protected OnLongClickListener mOnLongClickListener;
/**
* Listener used to dispatch context click events. This field should be made private, so it
* is hidden from the SDK.
* {@hide}
*/
protected OnContextClickListener mOnContextClickListener;
/**
* Listener used to build the context menu.
* This field should be made private, so it is hidden from the SDK.
* {@hide}
*/
protected OnCreateContextMenuListener mOnCreateContextMenuListener;
private OnKeyListener mOnKeyListener;
private OnTouchListener mOnTouchListener;
private OnHoverListener mOnHoverListener;
private OnGenericMotionListener mOnGenericMotionListener;
private OnDragListener mOnDragListener;
private OnSystemUiVisibilityChangeListener mOnSystemUiVisibilityChangeListener;
OnApplyWindowInsetsListener mOnApplyWindowInsetsListener;
}
先看一下条件 li.mOnTouchListener 这个变量是在哪里赋值的呢?我们寻找之后在View里发现了如下方法:
/**
* Register a callback to be invoked when a touch event is sent to this view.
* @param l the touch listener to attach to this view
*/
public void setOnTouchListener(OnTouchListener l) {
getListenerInfo().mOnTouchListener = l;
}
ListenerInfo getListenerInfo() {
if (mListenerInfo != null) {
return mListenerInfo;
}
mListenerInfo = new ListenerInfo();
return mListenerInfo;
}
第二个条件 mOnTouchListener 正是在 setOnTouchListener 方法里赋值的,也就是说只要我们给控件注册了 touch 事件,mListenerInfo 和 mListenerInfo.mOnTouchListener 就一定被赋值了。
第三个条件(mViewFlags & ENABLED_MASK) == ENABLED是判断当前点击的控件是否是enable的,默认都是enable的,因此这个条件恒定为 true 。
第四个条件就比较关键了,mOnTouchListener.onTouch(this, event),其实也就是去回调控件注册 touch 事件时的 onTouch 方法。也就是说如果我们在 onTouch 方法里返回true,就会让这三个条件全部成立,从而 result 是 true , 那么 onTouchEvent 就不会被执行 。如果我们在 onTouch 方法里返回 false,就会去执行 onTouchEvent() 方法。
现在我们可以结合前面的例子来分析一下了,首先在 dispatchTouchEvent 中最先执行的就是 onTouch 方法,因此 onTouch 肯定是要优先于 onTouchEvent 方法,也是印证了刚刚的打印结果。而如果在 onTouch 方法里返回了 true,不会再执行 onTouchEvent 。但是到目前位置我们还没有看到 onClick 执行,但是我们可以猜到,onClick的调用肯定是在onTouchEvent(event)方法中的!那我们马上来看下onTouchEvent的源码,如下所示:
public boolean onTouchEvent(MotionEvent event) {
// 省略部分代码
if (((viewFlags & CLICKABLE) == CLICKABLE ||
(viewFlags & LONG_CLICKABLE) == LONG_CLICKABLE) ||
(viewFlags & CONTEXT_CLICKABLE) == CONTEXT_CLICKABLE) {
switch (action) {
case MotionEvent.ACTION_UP:
boolean prepressed = (mPrivateFlags & PFLAG_PREPRESSED) != 0;
if ((mPrivateFlags & PFLAG_PRESSED) != 0 || prepressed) {
performClick();
}
mIgnoreNextUpEvent = false;
break;
// 省略部分代码
}
return true;
}
return false;
}
public boolean performClick() {
final boolean result;
final ListenerInfo li = mListenerInfo;
if (li != null && li.mOnClickListener != null) {
playSoundEffect(SoundEffectConstants.CLICK);
li.mOnClickListener.onClick(this);
result = true;
} else {
result = false;
}
sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);
return result;
}
相较于刚才的 dispatchTouchEvent 方法,onTouchEvent 方法复杂了很多,不过没关系,我们只挑重点看就可以了。switch 中如果当前的事件是抬起手指,则会进入到 MotionEvent.ACTION_UP 这个 case 当中。在经过种种判断之后,会执行到 performClick() 方法,可以看到,只要 mListenerInfo.mOnClickListener 不是 null,就会去调用它的 onClick 方法,那 mListenerInfo.mOnClickListener 又是在哪里赋值的呢?我们大概能猜到肯定在 setOnclickLstener 方法中:
public void setOnClickListener(@Nullable OnClickListener l) {
if (!isClickable()) {
setClickable(true);
}
getListenerInfo().mOnClickListener = l;
}
ListenerInfo getListenerInfo() {
if (mListenerInfo != null) {
return mListenerInfo;
}
mListenerInfo = new ListenerInfo();
return mListenerInfo;
}
View 的 Touch 事件分发我们就讲到这里了,下一节我将带着大家一起了解 ViewGroup 的事件分发和事件拦截,在源码的基础上写几个效果,我想应该可以说就堪称完美了。
所有分享大纲:Android进阶之旅 - 自定义View篇