Calendar 简析

Calendar的主入口是AllInOneActivity,所有视图其实都是需要这个AllInOneActivity的,视图之间的差别体现在各自的fragment中。AllInOneActivity相当于一个派发者。

AllInOneActivity中定义了actionbar的布局样式以及菜单项目,初始化了各种视图所需要的Fragment,定义了各种菜单以及按钮的响应事件处理方式(比如menu菜单),以及事件处理机制handleEvent。

日历的代码中处理各种视图的模块,包括月、周、日、日程各种fragment为入口,比如:
月视图以/month/MonthByWeekFragment.java为入口
周视图、日视图以/DayFragment.java为入口
日程以/agenda/AgendaFragment.java为入口
设置模块/CalendarSettingsActivity.java为入口
日程编辑和新建部分,/event/EditEventFragment.java为入口
单条日程信息的显示部分/EventInfoActivity.java为入口
Alerts日程消息通知部分/alert/AlertActivity.java为入口。

而日历代码中被反复调用的最频繁的是如下的几个文件:
Utils.java
工具函数,具体日期的数字显示值的获取就是通过它,各个账户颜色的取值也是通过它,公历的一些转换也是它。
CalendarController.java
日历在主体上只有一个AllInOneActivity.java,然后分别是各种Fragment。这就需要一个中介来统一处理他们的关系,AllInOneActivity和Fragment之间,以及不同的Fragment之间的通信(主要是事件),都是通过CalendarController这个类来完成的。

当在某个Fragment中想要发出一个事件的时候,该Fragment会用到自己实例化的CalendarController对象(mController),例如下面的样子:

mController.sendEvent(this, EventType.GO_TO, time, time, -1, ViewType.CURRENT);
/**
     * Helper for sending non-calendar-event events
     *
     * @param sender object of the caller
     * @param eventType one of {@link EventType}
     * @param start start time
     * @param end end time
     * @param eventId event id
     * @param viewType {@link ViewType}
     */
    public void sendEvent(Object sender, long eventType, Time start, Time end, long eventId,
            int viewType) {
        sendEvent(sender, eventType, start, end, start, eventId, viewType, EXTRA_GOTO_TIME, null,
                null);
    }

这里的sendEvent函数有很多参数,但是他们最终都会调用 CalendarController中重载了的public void sendEvent(Object sender, final EventInfo event),而之前的那些零散的参数都被封装在了这两个参数里。

sendEvent函数最终是要把EventInfo(事件信息)传递给事件处理对象(eventHandler),一个事件的处理对象可能还不止一个,因此需要遍历一次所有存在的事件处理对象,并调用这些对象的handleEvent(event)函数。

            if (DEBUG) {
                Log.d(TAG, "sendEvent: Dispatching to " + eventHandlers.size() + " handlers");
            }
            // Dispatch to event handler(s)
            if (mFirstEventHandler != null) {
                // Handle the 'first' one before handling the others
                EventHandler handler = mFirstEventHandler.second;
                if (handler != null && (handler.getSupportedEventTypes() & event.eventType) != 0
                        && !mToBeRemovedEventHandlers.contains(mFirstEventHandler.first)) {
                    handler.handleEvent(event);
                    handled = true;
                }
            }
            for (Iterator<Entry<Integer, EventHandler>> handlers =
                    eventHandlers.entrySet().iterator(); handlers.hasNext();) {
                Entry<Integer, EventHandler> entry = handlers.next();
                int key = entry.getKey();
                if (mFirstEventHandler != null && key == mFirstEventHandler.first) {
                    // If this was the 'first' handler it was already handled
                    continue;
                }
                EventHandler eventHandler = entry.getValue();
                if (eventHandler != null
                        && (eventHandler.getSupportedEventTypes() & event.eventType) != 0) {
                    if (mToBeRemovedEventHandlers.contains(key)) {
                        continue;
                    }
                    eventHandler.handleEvent(event);
                    handled = true;
                }
            }

那么事件处理对象,基本上都是通过自己的CalendarController成员变量mController发送事件的类本身也是事件处理对象,也就是我们熟悉的AllInOneActivity、MonthByWeekFragment、AgendaFragment、DayFragment。

这些类都继承了EventHandler这个接口(也就是事件处理对象的原型),并实现了其中的void handleEvent(EventInfo event);方法。EventHandler这个接口是在CalendarController中定义的,如下:

public interface EventHandler {
        long getSupportedEventTypes();
        void handleEvent(EventInfo event);

        /**
         * This notifies the handler that the database has changed and it should
         * update its view.
         */
        void eventsChanged();
    }

刚才提到了遍历事件处理对象,也给出了遍历的那段代码,可以看到其实实在遍历这个集合eventHandlers,eventHandlers中的成员是通过public void registerEventHandler(int key, EventHandler eventHandler)方法得到的。但是AllInOneActivity比较特殊,调用的是CalendarController的registerFirstEventHandler方法。

之所以要区分于其他,是因为整个日历的架构中要求优先调用AllInOneActivity的handleEvent。假如mFirstEventHandler不为空,则最先处理他,registerFirstEventHandler也在方法之类调用了registerEventHandler,这样AllInOneActivity就有优先和普通两种身份。
不管是registerFirstEventHandler还是registerEventHandler都有一个key参数,key是标识是不是同一个handler的键。

可以看到AllInOneActivity能处理的事件也只有三种,跳转、查看日程、更新日历title上的日期。对于其他的handler,能处理的可能更少。

我们来看看其他的handler支持哪些事件。可能还没有找出所有的handler。

MonthByWeekFragment

public long getSupportedEventTypes() {

    return EventType.GO_TO | EventType.EVENTS_CHANGED;

}

DayFragment

public long getSupportedEventTypes() {

    return EventType.GO_TO | EventType.EVENTS_CHANGED;

}

AgendaFragment

public long getSupportedEventTypes() {

    return EventType.GO_TO | EventType.EVENTS_CHANGED | ((mUsedForSearch)?EventType.SEARCH:0);

}

这个类实现了一个重要的接口——CalendarController.EventHandler,它的父类是AbstractCalendarActivity。

先来看AbstractCalendarActivity,它是AllInOneActivity, EditEventActivity, SelectVisibleCalendarsActivity这三个类的父类。其内容很简单:

public abstract class AbstractCalendarActivity extends Activity {

    protected AsyncQueryService mService;

    public synchronized AsyncQueryService getAsyncQueryService() {
        if (mService == null) {
            mService = new AsyncQueryService(this);
        }
        return mService;
    }
}

包含一个AsyncQueryService变量和对应的get方法,并且get方法还是加锁的,保证了AsyncQueryService对象的唯一性。
· 这是一个辅助类,是用来在后台Service中执行ContentResolver调用的。它将因为调用方(活动)被杀而导致调用丢失的可能性降至最低。

· 它被设计用来将AsyncQueryHandler在后台线程调用ContentResolver的方式简单的迁移到Calendar中。

· 这个类支持增删改查和批量操作,它也支持延迟处理和时限内取消操作。注意一个应用中只有一个队列来序列化所有调用。

上面说了,本质上AsyncQueryService是个Handler,但它又要在后台Service中执行操作,这个Service就是AsyncQueryServiceHelper,AsyncQueryServiceHelper是IntentService的子类。

所以,AsyncQueryService的基本操作模式是,外部调用其添删改查方法时,它把方法参数和自身的引用交给一个IntentService,由这个IntentService来实际执行添删改查操作。执行完后,IntentSerice会给Handler回送消息。而在AsyncQueryService的handlerMessage中,它会根据操作类别回调不同的方法,例如onDeleteComplete。

因此,在使用AsyncQueryService时,我们需要实现自己的子类,重写onDeleteComplete等方法,就可以实现自动在后台服务中做数据操作,操作结束后在主线程回调操作结果。

注意一点,上面的AbstractCalendarActivity中的AsyncQueryService对象是直接实例化的,没有重写任何回调方法。因为这个对象只在EditEventHelper中用到了:

public EditEventHelper(Context context) {
    mService = ((AbstractCalendarActivity)context).getAsyncQueryService();
}
mService.startBatch(mService.getNextToken(), null, android.provider.CalendarContract.AUTHORITY,ops, Utils.UNDO_DELAY);

只需要编辑后台数据,无需回调显示到视图上。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,651评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,468评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,931评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,218评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,234评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,198评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,084评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,926评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,341评论 1 311
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,563评论 2 333
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,731评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,430评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,036评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,676评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,829评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,743评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,629评论 2 354

推荐阅读更多精彩内容

  • java 接口的意义-百度 规范、扩展、回调 抽象类的意义-乐视 为其子类提供一个公共的类型封装子类中得重复内容定...
    交流电1582阅读 2,226评论 0 11
  • Swift1> Swift和OC的区别1.1> Swift没有地址/指针的概念1.2> 泛型1.3> 类型严谨 对...
    cosWriter阅读 11,097评论 1 32
  • 一 Activity 1 Activity 生命周期 1.1 Activity 的四种状态 running 当前...
    _执_念__阅读 10,371评论 0 91
  • 1,java 接口的意义: 规范,扩展,回调 规范:比如,有两个及上的的类拥有相同的方法,但是实现功能不一样,就可...
    漫唐阅读 966评论 0 6
  • 面试题一:Java1.equals与==的区别:==是判断两个变量或实例是不是指向同一个内存空间 equals是判...
    请叫我财迷阅读 1,033评论 0 2