/*
 * 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.Activity;
import android.app.Service;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.os.IBinder;

/**
 * Google Tasks 同步服务
 * <p>
 * 负责管理本地笔记与 Google Tasks 之间的后台同步操作。
 * 通过异步任务执行同步，支持同步状态广播和进度更新。
 * </p>
 */
public class GTaskSyncService extends Service {
    /** Intent 附加参数名称，用于指定同步操作类型 */
    public final static String ACTION_STRING_NAME = "sync_action_type";

    /** 启动同步操作的 Action 值 */
    public final static int ACTION_START_SYNC = 0;

    /** 取消同步操作的 Action 值 */
    public final static int ACTION_CANCEL_SYNC = 1;

    /** 无效的 Action 值 */
    public final static int ACTION_INVALID = 2;

    /** 同步服务广播名称 */
    public final static String GTASK_SERVICE_BROADCAST_NAME = "net.micode.notes.gtask.remote.gtask_sync_service";

    /** 广播附加参数名称，用于标识是否正在同步 */
    public final static String GTASK_SERVICE_BROADCAST_IS_SYNCING = "isSyncing";

    /** 广播附加参数名称，用于传递同步进度消息 */
    public final static String GTASK_SERVICE_BROADCAST_PROGRESS_MSG = "progressMsg";

    /** 同步异步任务实例 */
    private static GTaskASyncTask mSyncTask = null;

    /** 同步进度消息 */
    private static String mSyncProgress = "";

    /**
     * 启动同步操作
     * <p>
     * 创建并执行 GTaskASyncTask 异步任务，监听同步完成事件。
     * 同步完成后发送广播并停止服务。
     * </p>
     */
    private void startSync() {
        // 检查是否已有同步任务在运行
        if (mSyncTask == null) {
            mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() {
                public void onComplete() {
                    // 清空同步任务引用
                    mSyncTask = null;
                    // 发送同步完成广播
                    sendBroadcast("");
                    // 停止服务
                    stopSelf();
                }
            });
            // 发送同步开始广播
            sendBroadcast("");
            // 执行异步同步任务
            mSyncTask.execute();
        }
    }

    /**
     * 取消同步操作
     * <p>
     * 如果存在正在运行的同步任务，则调用其 cancelSync() 方法取消同步。
     * </p>
     */
    private void cancelSync() {
        if (mSyncTask != null) {
            // 取消异步同步任务
            mSyncTask.cancelSync();
        }
    }

    /**
     * 服务创建时的回调
     * <p>
     * 初始化同步任务为 null。
     * </p>
     */
    @Override
    public void onCreate() {
        mSyncTask = null;
    }

    /**
     * 服务启动命令的回调
     * <p>
     * 根据 Intent 中的 Action 类型执行相应的同步操作。
     * 支持 ACTION_START_SYNC 和 ACTION_CANCEL_SYNC 两种操作。
     * </p>
     * 
     * @param intent 启动服务的 Intent，包含 Action 类型参数
     * @param flags 启动标志
     * @param startId 启动 ID
     * @return START_STICKY 表示服务被杀死后会自动重启
     */
    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        Bundle bundle = intent.getExtras();
        // 检查 Intent 是否包含 Action 参数
        if (bundle != null && bundle.containsKey(ACTION_STRING_NAME)) {
            // 根据 Action 类型执行相应操作
            switch (bundle.getInt(ACTION_STRING_NAME, ACTION_INVALID)) {
                case ACTION_START_SYNC:
                    startSync();
                    break;
                case ACTION_CANCEL_SYNC:
                    cancelSync();
                    break;
                default:
                    break;
            }
            return START_STICKY;
        }
        return super.onStartCommand(intent, flags, startId);
    }

    /**
     * 系统内存不足时的回调
     * <p>
     * 取消正在进行的同步操作以释放资源。
     * </p>
     */
    @Override
    public void onLowMemory() {
        if (mSyncTask != null) {
            // 取消同步任务以释放内存
            mSyncTask.cancelSync();
        }
    }

    /**
     * 绑定服务的回调
     * <p>
     * 本服务不支持绑定，返回 null。
     * </p>
     * 
     * @param intent 绑定服务的 Intent
     * @return null，表示不支持绑定
     */
    public IBinder onBind(Intent intent) {
        return null;
    }

    /**
     * 发送同步状态广播
     * <p>
     * 向应用发送广播，包含当前同步状态和进度消息。
     * </p>
     * 
     * @param msg 同步进度消息
     */
    public void sendBroadcast(String msg) {
        // 更新同步进度消息
        mSyncProgress = msg;
        Intent intent = new Intent(GTASK_SERVICE_BROADCAST_NAME);
        // 添加是否正在同步的标志
        intent.putExtra(GTASK_SERVICE_BROADCAST_IS_SYNCING, mSyncTask != null);
        // 添加进度消息
        intent.putExtra(GTASK_SERVICE_BROADCAST_PROGRESS_MSG, msg);
        // 发送广播
        sendBroadcast(intent);
    }

    /**
     * 启动同步服务
     * <p>
     * 设置 Activity 上下文到 GTaskManager，然后启动同步服务执行同步操作。
     * </p>
     * 
     * @param activity Activity 上下文，用于获取 Google 账户认证信息
     */
    public static void startSync(Activity activity) {
        // 设置 Activity 上下文用于账户认证
        GTaskManager.getInstance().setActivityContext(activity);
        Intent intent = new Intent(activity, GTaskSyncService.class);
        intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_START_SYNC);
        // 启动同步服务
        activity.startService(intent);
    }

    /**
     * 取消同步服务
     * <p>
     * 启动同步服务并发送取消同步的命令。
     * </p>
     * 
     * @param context 应用上下文
     */
    public static void cancelSync(Context context) {
        Intent intent = new Intent(context, GTaskSyncService.class);
        intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_CANCEL_SYNC);
        // 启动服务发送取消命令
        context.startService(intent);
    }

    /**
     * 检查是否正在同步
     * 
     * @return 如果正在同步返回 true，否则返回 false
     */
    public static boolean isSyncing() {
        return mSyncTask != null;
    }

    /**
     * 获取同步进度消息
     * 
     * @return 当前同步进度消息字符串
     */
    public static String getProgressString() {
        return mSyncProgress;
    }
}
