按键事件在activity中的流程

android的事件有很多种，touch、key、mouse等。但是基本流程大概是一致的。本文将探寻activity中的事件流程，至于事件如何传递到activity，将另起篇幅介绍。

---

activity的事件入口

    public boolean dispatchKeyEvent(KeyEvent event) {
        onUserInteraction();
        Window win = getWindow();
        if (win.superDispatchKeyEvent(event)) {
            return true;
        }
        View decor = mDecor;
        if (decor == null) decor = win.getDecorView();
        return event.dispatch(this, decor != null 
                ? decor.getKeyDispatcherState() : null, this);
    }

以上代码是activity的dispatchKeyEvent()方法，该方法就是key事件的入口。至于其它的touch、mouse等事件，也都有类似的dispatch方法作为一类事件的入口。activity收到事件之后，会获取当前的window，将该事件传递给window。如果window的superDispatchKeyEvent()方法捕获该事件，则该事件传递结束。否则，将调用KeyEvent的dispatch()方法。

---

window的处理流程

    /**  
     * Used by custom windows, such as Dialog, to pass the key press event
     * further down the view hierarchy. Application developers should
     * not need to implement or call this.
     *
     */
    public abstract boolean superDispatchKeyEvent(KeyEvent event);

Window接口的superDispatchKeyEvent()的api说明，已经明确指出，事件会通过此方法进入view层级中。其具体实现是在PhoneWindow中。

    @Override
    public boolean superDispatchKeyEvent(KeyEvent event) {
        return mDecor.superDispatchKeyEvent(event);
    } 

这个mDecor是PhoneWindow的一个内部类，直接继承于FrameLayout。

    public boolean superDispatchKeyEvent(KeyEvent event) {
            if (super.dispatchKeyEvent(event)) {
                return true;
            }

            // Not handled by the view hierarchy, does the action bar want it
            // to cancel out of something special?
            if (event.getKeyCode() == KeyEvent.KEYCODE_BACK) {
                // Back cancels action modes first.
                // ... return true;

                // Next collapse any expanded action views.
                // ... return true;
            }

            return false;
        }

DecorView会按FrameLayout的方式处理该事件，此时，事件正式传递到了view层级中。如果FrameLayout未捕获该事件，并且是BACK按键时，DecorView会和ActionMode和ActionBar有简单交互。否则直接返回false。

---

View层级的事件处理
事件在View层级中传递，主要流程在ViewGroup和View中。先看ViewGroup的dispatchKeyEvent：

    public boolean dispatchKeyEvent(KeyEvent event) {
        // mInputEventConsistencyVerifier.onKeyEvent(event, 1);

        if ((mPrivateFlags & (PFLAG_FOCUSED | PFLAG_HAS_BOUNDS))
                == (PFLAG_FOCUSED | PFLAG_HAS_BOUNDS)) {
            if (super.dispatchKeyEvent(event)) {
                return true;
            }
        } else if (mFocused != null && (mFocused.mPrivateFlags & PFLAG_HAS_BOUNDS)
                == PFLAG_HAS_BOUNDS) {
            if (mFocused.dispatchKeyEvent(event)) {
                return true;
            }
        }

        // mInputEventConsistencyVerifier.onUnhandledEvent(event, 1);

        return false;
    }

如果ViewGroup自身已经获得焦点，则调用View的dispatchKeyEvent()；否则将查找焦点子View，将事件传递给焦点子View处理。

再看View的dispatchKeyEvent()

    public boolean dispatchKeyEvent(KeyEvent event) {                                   
        // mInputEventConsistencyVerifier.onKeyEvent(event, 0);

        // Give any attached key listener a first crack at the event.
        //noinspection SimplifiableIfStatement                           
        ListenerInfo li = mListenerInfo;
        if (li != null && li.mOnKeyListener != null && (mViewFlags & ENABLED_MASK) == ENABLED
                && li.mOnKeyListener.onKey(this, event.getKeyCode(), event)) {    
            return true;                                                 
        }                                                                

        if (event.dispatch(this, mAttachInfo != null
                ? mAttachInfo.mKeyDispatchState : null, this)) {         
            return true;                                                 
        }                                                                

        // mInputEventConsistencyVerifier.onUnhandledEvent(event, 0);   
        return false;                                                    
    } 

如果View设置了KeyListener，并且是enable状态，则该事件先由KeyListener处理。KeyListener返回true，则事件结束。否则调用KeyEvent的dispatch()方法。这个dispatch()方法的第一个参数是KeyEvent.Callback，它有2个方法onKeyDown()和onKeyUp()。View和Activity都实现了这个接口。dispatch方法将判断按键是up还是down，然后传递分发给callback。View在onKeyDown()和onKeyUp()中，主要处理了enter按键，设置和取消了press状态，触发click事件，并在一定条件下，触发long press状态。如果在Callback中返回true，则事件结束；否则，事件流程回溯到起点activity的dispatchKeyEvent()中的第二部分。即调用的KeyEvent的dispatch()方法，事件将进入activity的onKeyDown()和onKeyUp()中。这2个函数是在应用中可以接收到事件的最后机会。

事件流程总结
activity中先在dispatch函数中接收到事件，交由window处理，window则再转给DecorView，进入view层级处理。View层级中直接将事件转发给当前焦点view处理，而焦点view则依次转给自己的OnKeyListener回调、onKeyDown、onKeyUp处理。如果焦点view未处理，则回到了activity的dispatch函数，进入第二步流程onKeyDown、onKeyUp处理。这中间的节点是应用开发可以控制到的。至于事件如何进入activity、ime和activity如何事件交互，且看后续文章。