/* * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net) * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package net.micode.notes.gtask.remote; import android.app.Notification; import android.app.NotificationManager; import android.app.PendingIntent; import android.content.Context; import android.content.Intent; import android.os.AsyncTask; import net.micode.notes.R; import net.micode.notes.ui.NotesListActivity; import net.micode.notes.ui.NotesPreferenceActivity; /** *
Google任务异步同步任务类。
*设计意图:使用AsyncTask实现Google任务的异步同步操作,避免阻塞主线程,并提供用户友好的通知反馈。
*核心职责:
*关键关联:
*同步完成监听器接口。
*设计意图:提供Google任务同步完成后的回调机制。
*/ public interface OnCompleteListener { /** * 同步完成时调用的方法 */ void onComplete(); } /** * 上下文对象,用于访问系统服务和资源 */ private Context mContext; /** * 通知管理器,用于显示同步进度和结果通知 */ private NotificationManager mNotifiManager; /** * Google任务管理器,用于执行实际的同步逻辑 */ private GTaskManager mTaskManager; /** * 同步完成监听器,用于处理同步完成后的回调 */ private OnCompleteListener mOnCompleteListener; /** * 构造方法,初始化Google任务异步同步任务。 * * @param context 上下文对象,用于访问系统服务和资源 * @param listener 同步完成监听器,用于处理同步完成后的回调 */ public GTaskASyncTask(Context context, OnCompleteListener listener) { mContext = context; mOnCompleteListener = listener; mNotifiManager = (NotificationManager) mContext .getSystemService(Context.NOTIFICATION_SERVICE); mTaskManager = GTaskManager.getInstance(); } /** * 取消正在进行的同步操作。 */ public void cancelSync() { mTaskManager.cancelSync(); } /** * 发布同步进度信息。 * * @param message 进度信息消息 */ public void publishProgess(String message) { publishProgress(new String[] { message }); } // private void showNotification(int tickerId, String content) { // Notification notification = new Notification(R.drawable.notification, mContext // .getString(tickerId), System.currentTimeMillis()); // notification.defaults = Notification.DEFAULT_LIGHTS; // notification.flags = Notification.FLAG_AUTO_CANCEL; // PendingIntent pendingIntent; // if (tickerId != R.string.ticker_success) { // pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext, // NotesPreferenceActivity.class), 0); // // } else { // pendingIntent = PendingIntent.getActivity(mContext, 0, new Intent(mContext, // NotesListActivity.class), 0); // } // notification.setLatestEventInfo(mContext, mContext.getString(R.string.app_name), content, // pendingIntent); // mNotifiManager.notify(GTASK_SYNC_NOTIFICATION_ID, notification); // } /** *显示同步通知。
*业务逻辑:根据同步状态创建并显示相应的通知,支持成功、失败、取消等不同状态。
*通知点击行为: *
在后台线程执行同步操作。
*业务逻辑:初始化同步进度通知,调用GTaskManager执行实际的同步逻辑。
* * @param unused 未使用的参数 * @return 同步结果状态码,对应GTaskManager中的STATE_*常量 */ @Override protected Integer doInBackground(Void... unused) { publishProgess(mContext.getString(R.string.sync_progress_login, NotesPreferenceActivity .getSyncAccountName(mContext))); return mTaskManager.sync(mContext, this); } /** *更新同步进度。
*业务逻辑:显示当前同步进度通知,如果在服务环境下,还会发送广播通知。
* * @param progress 进度信息数组,其中第一个元素为进度消息 */ @Override protected void onProgressUpdate(String... progress) { showNotification(R.string.ticker_syncing, progress[0]); if (mContext instanceof GTaskSyncService) { ((GTaskSyncService) mContext).sendBroadcast(progress[0]); } } /** *处理同步结果。
*业务逻辑:根据同步结果显示相应的通知,更新最后同步时间,并调用完成监听器。
*同步结果处理: *