/*
 * Copyright (c) 2010-2011, The MiCode Open Source Community (www.micode.net)
 * 这段注释表明文件的版权信息，版权属于2010-2011年间的MiCode开源社区。
 */

/* 以下注释是关于Apache License 2.0的声明 */
/* ...（与前文相同，省略了详细的Apache License注释内容） */

package net.micode.notes.gtask.remote;
// 这行代码声明了当前类所在的包名为net.micode.notes.gtask.remote。

import android.app.Activity;
// 导入Android框架中的Activity类，用于表示应用中的一个单一屏幕，包含用户界面的一个窗口。
import android.app.Service;
// 导入Android框架中的Service类，用于执行后台操作而不提供用户界面。
import android.content.Context;
// 导入Android框架中的Context类，它允许访问特定资源和类以及调用应用级操作，如启动活动、广播和接收意图等。
import android.content.Intent;
// 导入Android框架中的Intent类，它用于在不同组件之间进行消息传递。
import android.os.Bundle;
// 导入Android框架中的Bundle类，它用于传递数据集，例如从活动到另一个活动。
import android.os.IBinder;
// 导入Android框架中的IBinder接口，它是远程服务的基石，用于进程间通信（IPC）。

public class GTaskSyncService extends Service {
// 声明了一个名为GTaskSyncService的类，它继承自Android框架中的Service类。

    // 声明了一些静态常量，用于同步操作的类型和广播名称等。
    // ...（省略了静态常量的详细声明）

    // 声明了一个静态的GTaskASyncTask类型的变量mSyncTask，用于表示当前的同步任务。
    // ...（省略了其他静态变量的声明）

    // 私有方法startSync，用于开始同步操作。
    // ...（省略了startSync方法的详细实现）

    // 私有方法cancelSync，用于取消当前的同步操作。
    // ...（省略了cancelSync方法的详细实现）

    @Override
    public void onCreate() {
    // 重写了Service类中的onCreate方法，当服务被创建时调用。这里将mSyncTask重置为null。
        mSyncTask = null;
    }

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
    // 重写了Service类中的onStartCommand方法，当服务被启动时调用。
    // 这里根据传入的Intent中的动作来决定是开始同步还是取消同步，并返回START_STICKY表示如果服务被杀死后会重新创建。
        // ...（省略了onStartCommand方法的详细实现）
    }

    @Override
    public void onLowMemory() {
    // 重写了Service类中的onLowMemory方法，当设备内存低时调用。这里取消当前的同步任务以释放资源。
        if (mSyncTask != null) {
            mSyncTask.cancelSync();
        }
    }

    @Override
    public IBinder onBind(Intent intent) {
    // 重写了Service类中的onBind方法，用于返回一个IBinder对象以允许其他应用绑定到这个服务。
    // 这里返回null表示这个服务不支持绑定。
        return null;
    }

    // 公有方法sendBroadcast，用于发送一个包含同步进度信息的广播。
    // ...（省略了sendBroadcast方法的详细实现）

    // 公有静态方法startSync，用于从Activity中启动同步服务。
    // ...（省略了startSync方法的详细实现）

    // 公有静态方法cancelSync，用于从任何Context中取消同步服务。
    // ...（省略了cancelSync方法的详细实现）

    // 公有静态方法isSyncing，用于检查当前是否有同步任务正在进行。
    // ...（省略了isSyncing方法的详细实现）

    // 公有静态方法getProgressString，用于获取当前的同步进度信息。
    // ...（省略了getProgressString方法的详细实现）
}