原生Calendar代码:

5.0Calendar源码.rar

提取的JavaDoc:

Calendar的javadoc.rar

1. AsyncQueryService和AsyncQueryServiceHelper。

  Calendar的主入口是AllInOneActivity,这个类实现了一个重要的接口——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对象的唯一性。

  那么这个AsyncQueryService对象是干什么用的?从名字可以看出,这是一个“异步查询服务”,但它并不继承自Service,而是继承自Handler。这个类的注释很详细,总结如下:

  • 这是一个辅助类,是用来在后台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);

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

  AsyncQueryService的结构并不复杂,但其中有一些细节值得学习:

  1. 使用AtomicInteger类和它的getAndIncrement方法,获得数据操作的token。关于原子操作的介绍见Java 理论与实践: 流行的原子

  2. AsyncQueryService传递给AsyncQueryServiceHelper的Handler引用没有直接用this,而是用的mHander,便于测试。

    private Handler mHandler = this; // can be overridden for testing

    // @VisibleForTesting

    protected void setTestHandler(Handler handler) {

    mHandler = handler;

    }

  3. AsyncQueryServiceHelper实例化了一个静态常量的队列来存储数据操作信息,因此这个队列对于应用是唯一的。注意这里使用了PriorityQueue,它会按操作的计划时间来自动对其排序,这是因为OperationInfo类实现了Comparable接口。

  4. 后台查询得到Cursor对象后,主动调用了一次cursor.getCount()方法,这样可以让主线程中对Cursor中数据的访问加快:

                 try {
    cursor = resolver.query(args.uri, args.projection, args.selection,
    args.selectionArgs, args.orderBy);
    /*
    * Calling getCount() causes the cursor window to be
    * filled, which will make the first access on the main
    * thread a lot faster
    */
    if (cursor != null) {
    cursor.getCount();
    }
    } catch (Exception e) {
    Log.w(TAG, e.toString());
    cursor = null;
    }
04-30 05:03