/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 *
 * 版权声明：本文件由MiCode开源社区开发，遵循Apache License, Version 2.0协议；
 * 您仅在遵守协议的前提下使用本文件，完整协议可通过以下链接获取：
 * http://www.apache.org/licenses/LICENSE-2.0
 * 注：未书面明确要求时，本软件按"原样"提供，不附带任何明示或暗示的保证。
 */

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任务同步服务类（后台服务组件）
 * 负责管理同步任务的启动、取消，并通过广播通知外部同步状态（如是否同步中、进度信息）
 */
public class GTaskSyncService extends Service {
    // 服务意图中传递的动作类型键名
    public final static String ACTION_STRING_NAME = "sync_action_type";
    // 动作类型：启动同步
    public final static int ACTION_START_SYNC = 0;
    // 动作类型：取消同步
    public final static int ACTION_CANCEL_SYNC = 1;
    // 动作类型：无效操作
    public final static int ACTION_INVALID = 2;
    // 同步状态广播的Action名称（用于发送同步状态通知）
    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 = "";

    /**
     * 启动同步任务（内部方法）
     * 检查是否已有同步任务运行，若无则创建新任务并执行
     */
    private void startSync() {
        if (mSyncTask == null) {  // 避免重复启动同步任务
            // 创建异步任务实例，传入服务上下文和完成监听器
            mSyncTask = new GTaskASyncTask(this, new GTaskASyncTask.OnCompleteListener() {
                @Override
                public void onComplete() {
                    // 同步完成后：清空任务实例 -> 发送广播 -> 停止服务自身
                    mSyncTask = null;
                    sendBroadcast("");  // 发送同步结束的广播（进度消息为空）
                    stopSelf();         // 停止当前服务
                }
            });
            sendBroadcast("");  // 发送同步开始的广播（进度消息为空）
            mSyncTask.execute();  // 执行异步同步任务（触发后台同步逻辑）
        }
    }

    /**
     * 取消当前同步任务（内部方法）
     * 若存在运行中的同步任务，则调用其取消方法
     */
    private void cancelSync() {
        if (mSyncTask != null) {
            mSyncTask.cancelSync();  // 触发异步任务的取消逻辑
        }
    }

    /**
     * 服务创建时的回调方法
     * 初始化成员变量（确保服务启动时无残留任务）
     */
    @Override
    public void onCreate() {
        mSyncTask = null;  // 清空同步任务实例
    }

    /**
     * 处理服务启动命令的回调方法
     * 根据意图中传递的动作类型（启动/取消同步）执行对应操作
     * @param intent 启动服务的意图（可能携带动作类型参数）
     * @param flags 启动标志（如START_FLAG_REDELIVERY）
     * @param startId 服务启动的唯一ID
     * @return 服务重启策略（此处返回START_STICKY，意外终止后自动重启）
     */
    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        Bundle bundle = intent.getExtras();  // 获取意图携带的参数包
        if (bundle != null && bundle.containsKey(ACTION_STRING_NAME)) {
            // 根据动作类型执行操作
            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);
    }

    /**
     * 系统内存不足时的回调方法
     * 释放资源，取消当前同步任务以避免内存溢出
     */
    @Override
    public void onLowMemory() {
        if (mSyncTask != null) {
            mSyncTask.cancelSync();  // 内存不足时强制取消同步任务
        }
    }

    /**
     * 绑定服务时的回调方法（本服务不支持绑定）
     * @param intent 绑定意图
     * @return 始终返回null（表示不支持绑定）
     */
    public IBinder onBind(Intent intent) {
        return null;
    }

    /**
     * 发送同步状态广播（通知外部当前同步状态）
     * @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);  // 是否同步中（任务存在则为true）
        intent.putExtra(GTASK_SERVICE_BROADCAST_PROGRESS_MSG, msg);  // 传递进度消息
        sendBroadcast(intent);  // 发送广播
    }

    /**
     * 静态方法：外部调用启动同步服务
     * @param activity 启动服务的Activity上下文（用于设置GTaskManager的Activity引用）
     */
    public static void startSync(Activity activity) {
        GTaskManager.getInstance().setActivityContext(activity);  // 设置GTaskManager的Activity（用于获取认证令牌）
        Intent intent = new Intent(activity, GTaskSyncService.class);  // 创建启动服务的意图
        intent.putExtra(GTaskSyncService.ACTION_STRING_NAME, GTaskSyncService.ACTION_START_SYNC);  // 传递启动同步动作
        activity.startService(intent);  // 启动服务
    }

    /**
     * 静态方法：外部调用取消同步服务
     * @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;  // 返回全局进度变量
    }
}