$Android AlarmManager的用法詳解

　　在Android的Alarm機制中，使用AlarmManager可以實現類似鬧鍾這樣的定時任務。在畢業設計項目中要實現定時任務的功能，所以在這里先進行一下梳理。

　　（一）AlarmManager與Broadcast結合實現定時任務

　　AlarmManager主要可以發送定時廣播，然后在廣播接收器中執行任務的具體邏輯；還可以取消已經創建的定時任務、創建可以周期重復執行的定時任務等，將這幾個功能進行封裝，封裝成AlarmManagerUtil類如下：

import android.app.AlarmManager;
import android.app.PendingIntent;
import android.content.Context;
import android.content.Intent;
import android.util.Log;

/**
 * AlarmManager工具類
 *
 */

public class AlarmManagerUtil {
    // 獲取AlarmManager實例
    public static AlarmManager getAlarmManager(Context context) {
        return (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
    }

    // 發送定時廣播（執行廣播中的定時任務）
    // 參數：
    // context:上下文
    // requestCode:請求碼，用於區分不同的任務
    // type:alarm啟動類型
    // triggerAtTime:定時任務開啟的時間，毫秒為單位
    // cls:廣播接收器的class
    public static void sendAlarmBroadcast(Context context, int requestCode,
            int type, long triggerAtTime, Class cls) {
        AlarmManager mgr = getAlarmManager(context);

        Intent intent = new Intent(context, cls);
        PendingIntent pi = PendingIntent.getBroadcast(context, requestCode,
                intent, 0);

        mgr.set(type, triggerAtTime, pi);
    }

    // 取消指定requestCode的定時任務
    // 參數：
    // context:上下文
    // requestCode:請求碼，用於區分不同的任務
    // cls:廣播接收器的class
    public static void cancelAlarmBroadcast(Context context, int requestCode,
            Class cls) {
        AlarmManager mgr = getAlarmManager(context);

        Intent intent = new Intent(context, cls);
        PendingIntent pi = PendingIntent.getBroadcast(context, requestCode,
                intent, 0);

        mgr.cancel(pi);
        ToastUtil
                .showShort(context, "取消定時服務成功" + " @requestCode:" + requestCode);
        Log.d("取消定時服務成功", "@requestCode:" + requestCode);
    }

    // 周期性執行定時任務
    // 參數：
    // context:上下文
    // requestCode:請求碼，用於區分不同的任務
    // type:alarm啟動類型
    // startTime:開始的時間，毫秒為單位
    // cycleTime:定時任務的重復周期，毫秒為單位
    // cls:廣播接收器的class
    public static void sendRepeatAlarmBroadcast(Context context,
            int requestCode, int type, long startTime, long cycleTime, Class cls) {
        AlarmManager mgr = getAlarmManager(context);

        Intent intent = new Intent(context, cls);
        PendingIntent pi = PendingIntent.getBroadcast(context, requestCode,
                intent, 0);

        mgr.setRepeating(type, startTime, cycleTime, pi);
    }
}

　　其中使用到的其他兩個工具類都是項目中經常用到的，代碼如下：

　　ToastUtil：

/**
 * Toast提示顯示工具類
 * 
 */

import android.content.Context;
import android.widget.Toast;

public class ToastUtil {

    // 短時間顯示Toast信息
    public static void showShort(Context context, String info) {
        Toast.makeText(context, info, Toast.LENGTH_SHORT).show();
    }

    // 長時間顯示Toast信息
    public static void showLong(Context context, String info) {
        Toast.makeText(context, info, Toast.LENGTH_LONG).show();
    }

}

　　DateTimeUtil：

import java.text.DateFormat;
import java.text.DecimalFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Arrays;
import java.util.Calendar;
import java.util.Date;
import java.util.GregorianCalendar;

public class DateTimeUtil {
    // 獲取當前時間n[]之后的時間的日期時間字符串（N的單位為Calendar的那些表示時間的常量）
    public static String getNLaterDateTimeString(int nType, int n) {
        Date date = new Date();
        Calendar c = new GregorianCalendar();
        c.setTime(date);
        c.add(nType, n);

        return CalendarToString(c);
    }

    // millis to datetime
    public static String getDateTimeStringFromMillis(long millis) {
        Date date = new Date(millis);
        return (DateToString(date));
    }

    // 把日期時間字符串的時間轉換成毫秒值（RTC）
    public static long stringToMillis(String dateTime) {
        Calendar c = StringToGregorianCalendar(dateTime);

        return c.getTimeInMillis();
    }

    // 獲取兩個日期時間字符串表示的時間之間的毫秒差值
    public static long getDifMillis(String dateTime1, String dateTime2) {
        return (stringToMillis(dateTime1) - stringToMillis(dateTime2));
    }

    // 輸入一個表示日期或時間的整型數，輸出"01"或"23"這樣格式的字符串
    public static String getDoubleNumString(int n) {
        int num = n % 60;

        if (num < 10) {
            return "0" + num;
        } else {
            return num + "";
        }
    }

    // 獲取標准日期時間字符串的整型的日期值，如："2015-01-21 00:00:00"，返回：21
    public static int getDayOfMonth(String dateTime) {
        Calendar c = StringToGregorianCalendar(dateTime);
        int day = c.get(Calendar.DAY_OF_MONTH);

        return day;
    }

    // 獲取當前時間的日期時間字符串，格式："yyyy-MM-dd HH:mm:ss"
    public static String getCurrentDateTimeString() {
        Date date = new Date();
        return DateToString(date);
    }

    // 獲取當前的"yyyy-MM-dd"日期格式字符串
    public static String getCurrentDateString() {
        Date date = new Date();
        return DateToString(date).substring(0, 10);
    }

    // 獲取當前的"yyyy-MM"日期格式字符串
    public static String getCurrentMonthString() {
        Date date = new Date();
        return DateToString(date).substring(0, 7);
    }

    // 獲取當前的"HH:mm"時間格式字符串
    public static String getCurrentTimeString() {
        Date date = new Date();
        return DateToString(date).substring(11, 16);
    }

    // 獲取當前的"HH:mm:ss"時間格式字符串
    public static String getCurrentTimeLongString() {
        Date date = new Date();
        return DateToString(date).substring(11, 19);
    }

    // 由日期時間字符串生成“11月1日 星期一”這樣格式的字符串
    public static String getShortDateTimeOfWeek(String dateTime) {
        Calendar c = StringToGregorianCalendar(dateTime);

        int month = c.get(Calendar.MONTH) + 1;
        int day = c.get(Calendar.DAY_OF_MONTH);

        String[] weekStr = new String[] { "星期日", "星期一", "星期二", "星期三", "星期四",
                "星期五", "星期六" };
        String week = weekStr[c.get(Calendar.DAY_OF_WEEK) - 1];

        String result = month + "月" + day + "日" + "  " + week;

        return result;
    }

    // 由日期時間字符串生成“2015年11月1日 星期一”這樣格式的字符串
    public static String getDateTimeOfWeek(String dateTime) {
        Calendar c = StringToGregorianCalendar(dateTime);

        int year = c.get(Calendar.YEAR);
        int month = c.get(Calendar.MONTH) + 1;
        int day = c.get(Calendar.DAY_OF_MONTH);

        String[] weekStr = new String[] { "星期日", "星期一", "星期二", "星期三", "星期四",
                "星期五", "星期六" };
        String week = weekStr[c.get(Calendar.DAY_OF_WEEK) - 1];

        String result = year + "年" + month + "月" + day + "日" + "  " + week;

        return result;
    }

    // 由日期時間字符串生成“2015年11月1日 05:43”這樣格式的字符串
    public static String getDateTimeOfHourMinute(String dateTime) {
        String result = "";
        String date = dateTime.split(" ")[0];
        String time = dateTime.split(" ")[1];
        String[] dateArr = date.split("-");
        String[] timeArr = time.split(":");

        int year = Integer.parseInt(dateArr[0]);
        int month = Integer.parseInt(dateArr[1]);
        int day = Integer.parseInt(dateArr[2]);

        result = year + "年" + month + "月" + day + "日" + "  " + timeArr[0] + ":"
                + timeArr[1];

        return result;
    }

    // 用年月日生成日期字符串，month取值范圍：[0,13]
    public static String getDateString(int year, int month, int day) {
        String m;
        String d;

        if (month >= 9) {
            m = (month + 1) + "";
        } else {
            m = "0" + (month + 1);
        }

        if (day >= 10) {
            d = day + "";
        } else {
            d = "0" + day;
        }

        String dateString = year + "-" + m + "-" + d;
        return dateString;
    }

    // 用年月生成年月日期字符串，month取值范圍：[0,13]
    public static String getDateString(int year, int month) {
        String m;
        String d;

        if (month >= 9) {
            m = (month + 1) + "";
        } else {
            m = "0" + (month + 1);
        }

        String dateString = year + "-" + m;
        return dateString;
    }

    // 用時、分生成時間字符串
    public static String getTimeString(int hour, int minute) {
        String h;
        String m;

        if (hour >= 10) {
            h = hour + "";
        } else {
            h = "0" + hour;
        }

        if (minute >= 10) {
            m = minute + "";
        } else {
            m = "0" + minute;
        }

        return h + ":" + m;
    }

    // 用時、分、秒生成時間字符串
    public static String getTimeString(int hour, int minute, int second) {
        String h;
        String m;
        String c;

        if (hour >= 10) {
            h = hour + "";
        } else {
            h = "0" + hour;
        }

        if (minute >= 10) {
            m = minute + "";
        } else {
            m = "0" + minute;
        }

        if (second >= 10) {
            c = second + "";
        } else {
            c = "0" + second;
        }

        return h + ":" + m + ":" + c;
    }

    // 該內部類是用於對日期時間字符串數組進行排序的
    public class DateTimeString implements Comparable<DateTimeString> {
        private String mDateTimeStr;

        public DateTimeString(String dateTimeStr) {
            mDateTimeStr = dateTimeStr;
        }

        @Override
        public int compareTo(DateTimeString another) {
            return compareDateTimeString(mDateTimeStr.toString(),
                    another.toString());
        }

        @Override
        public String toString() {
            return mDateTimeStr;
        }

    }

    // 對日期時間字符串數組進行排序,返回排序后的數組（排序后的順序是從小到大）
    public static String[] sortDateTimeStringArray(String[] dateTimeStringArray) {
        // 將日期時間字符串數組轉換成DateTimeString類型數組，DateTimeString實現了Comparable接口，可以進行排序
        DateTimeString[] tmpArray = new DateTimeString[dateTimeStringArray.length];

        // 生成tmpArray數組
        int i = 0;
        DateTimeUtil tmpUtil = new DateTimeUtil();
        for (String str : dateTimeStringArray) {
            tmpArray[i++] = tmpUtil.new DateTimeString(str);
        }

        // 對tmpArray進行排序
        Arrays.sort(tmpArray);

        String[] result = new String[tmpArray.length];
        i = 0;
        for (DateTimeString str : tmpArray) {
            result[i++] = str.toString();
        }
        return result;
    }

    // 比較兩個日期時間字符串的大小，如果str1比str2早，則返回-1，如果相等返回0，否則返回1
    public static int compareDateTimeString(String str1, String str2) {
        Date d1 = StringToDate(str1);
        Date d2 = StringToDate(str2);
        if (d1.getTime() - d2.getTime() < 0) {
            return -1;
        } else if (d1.getTime() - d2.getTime() > 0) {
            return 1;
        } else {
            return 0;
        }

    }

    // 時間日期字符串轉換成Date對象
    // 注：dateTimeStr帶不帶前導0都是可以的，比如"2011-01-01 01:02:03"和"2011-1-1 1:2:3"都是合法的
    public static Date StringToDate(String dateTimeStr) {
        Date date = new Date();
        // DateFormat fmt = DateFormat.getDateTimeInstance();
        DateFormat fmt = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        try {
            date = fmt.parse(dateTimeStr);
            return date;
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return date;
    }

    // Date對象轉換成日期時間字符串
    public static String DateToString(Date date) {
        String dateTimeStr = null;
        // DateFormat fmt = DateFormat.getDateTimeInstance();
        DateFormat fmt = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        dateTimeStr = fmt.format(date);
        return dateTimeStr;
    }

    // 字符串轉換成Calendar
    public static Calendar StringToGregorianCalendar(String dateTimeStr) {
        Date date = StringToDate(dateTimeStr);
        Calendar calendar = new GregorianCalendar();

        calendar.setTime(date);
        return calendar;
    }

    // Calendar轉換成String
    public static String CalendarToString(Calendar calendar) {
        Date date = ((GregorianCalendar) calendar).getTime();
        return DateToString(date);
    }

    // 獲取日期時間格式字符串表示的兩日期時間之間相隔的天數（天數可為浮點型） AC
    public static double getDayNumDif(String str1, String str2) {
        // DateFormat fmt = DateFormat.getDateTimeInstance();
        DateFormat fmt = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        try {
            Date d1 = fmt.parse(str1);
            Date d2 = fmt.parse(str2);
            long dif = Math.abs(d1.getTime() - d2.getTime());
            double dayDif = (double) (dif) / 1000 / (24 * 60 * 60);

            // 保留兩位小數
            DecimalFormat df = new DecimalFormat("0.00");
            return Double.parseDouble(df.format(dayDif));
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return -1;
    }

    // 求算術平均值函數，保留2位小數
    public static double getAverage(double[] data) {
        double sum = 0;
        for (int i = 0; i < data.length; i++) {
            sum += data[i];
        }

        DecimalFormat df = new DecimalFormat("0.00");
        return Double.parseDouble(df.format(sum / data.length));
    }

    // 輸入一個時間日期字符串（格式：“yyyy-MM-dd HH:mm:ss”），輸出num天后的時間日期字符串（num可為浮點數）
    public static String getNDayLatterDateTime(String str, double num) {
        // 創建日期時間格式對象fmt
        // DateFormat fmt = DateFormat.getDateTimeInstance();
        DateFormat fmt = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        try {
            Date curDate = fmt.parse(str);
            GregorianCalendar calendar = new GregorianCalendar();
            calendar.setTime(curDate);

            calendar.add(Calendar.SECOND, (int) (num * (24 * 60 * 60)));

            Date newDate = calendar.getTime();
            String newDateStr = fmt.format(newDate);
            return newDateStr;
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return "";
    }

}

　　

　　（二）Demo

　　根據上面AlarmManagerUtil中的方法，下面要編寫一個Demo，主要的功能就是能創建和取消可以周期執行的定時任務，定時任務的創建是在服務中執行的，而任務的具體內容是在廣播接收器中執行的，並且在手機重啟后定時任務還能正常運作。

　　1、布局文件activity_main.xml：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >

    <Button
        android:id="@+id/start_service_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="開啟定時服務" />

    <Button
        android:id="@+id/cancel_service_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="取消定時服務" />

</LinearLayout>

　　2、MainActivity：

import java.util.Calendar;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;

public class MainActivity extends Activity implements OnClickListener {

    // 開啟服務按鈕
    private Button startServiceBtn;
    // 取消服務按鈕
    private Button cancelServiceBtn;

    // 模擬的task id
    private static int mTaskId = 0;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        startServiceBtn = (Button) findViewById(R.id.start_service_btn);
        cancelServiceBtn = (Button) findViewById(R.id.cancel_service_btn);

        startServiceBtn.setOnClickListener(this);
        cancelServiceBtn.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
        case R.id.start_service_btn:
            Intent i = new Intent(this, AlarmService.class);
            // 獲取20秒之后的日期時間字符串
            i.putExtra("alarm_time",
                    DateTimeUtil.getNLaterDateTimeString(Calendar.SECOND, 20));
            i.putExtra("task_id", mTaskId);
            startService(i);
            break;
        case R.id.cancel_service_btn:
            AlarmManagerUtil.cancelAlarmBroadcast(this, mTaskId,
                    AlarmReceiver.class);
            break;
        default:
            break;
        }
    }
}

　　3、創建一個服務AlarmService，為了讓不同的定時任務運行在不同的線程中，讓AlarmService繼承支持線程的IntentService類：

import java.util.Date;

import android.app.AlarmManager;
import android.app.IntentService;
import android.app.PendingIntent;
import android.app.Service;
import android.content.Intent;
import android.os.IBinder;
import android.os.SystemClock;
import android.util.Log;

public class AlarmService extends IntentService {

    // 從其他地方通過Intent傳遞過來的提醒時間
    private String alarmDateTime;

    public AlarmService() {
        super("AlarmService");
    }

    @Override
    protected void onHandleIntent(Intent intent) {
        alarmDateTime = intent.getStringExtra("alarm_time");
        // taskId用於區分不同的任務
        int taskId = intent.getIntExtra("task_id", 0);

        Log.d("AlarmService", "executed at " + new Date().toString()
                + " @Thread id：" + Thread.currentThread().getId());

        long alarmDateTimeMillis = DateTimeUtil.stringToMillis(alarmDateTime);

        AlarmManagerUtil.sendRepeatAlarmBroadcast(this, taskId,
                AlarmManager.RTC_WAKEUP, alarmDateTimeMillis, 10 * 1000,
                AlarmReceiver.class);

    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        Log.d("Destroy", "Alarm Service Destroy");
    }

}

　　4、創建廣播接收器AlarmReceiver：

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.text.method.DateTimeKeyListener;
import android.util.Log;
import android.widget.Toast;

public class AlarmReceiver extends BroadcastReceiver {

    @Override
    public void onReceive(Context context, Intent intent) {
        ToastUtil.showShort(context,
                "從服務啟動廣播：at " + DateTimeUtil.getCurrentDateTimeString());
        Log.d("Alarm", "從服務啟動廣播：at " + DateTimeUtil.getCurrentDateTimeString());
    }

}

　　5、為了讓定時服務在手機重啟后也能正常運行，再創建一個系統廣播接收器BootCompleteReceiver，監聽手機一旦開機完成就啟動服務AlarmService：

/**
 * 開機重新啟動服務AlarmService
 *
 */

public class BootCompleteReceiver extends BroadcastReceiver {
    // 模擬的task id
    private static int mTaskId = 0;

    @Override
    public void onReceive(Context context, Intent intent) {
        Log.d("定時服務", "開機啟動");
        ToastUtil.showShort(context, "定時服務開機啟動");
        Intent i = new Intent(context, AlarmService.class);
        // 獲取3分鍾之后的日期時間字符串
        i.putExtra("alarm_time",
                DateTimeUtil.getNLaterDateTimeString(Calendar.MINUTE, 3));
        i.putExtra("task_id", mTaskId);
        context.startService(i);
    }
}

　　6、最后是在AndroidManifest.xml文件中注冊服務、廣播接收器，申請相應的權限：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.servicebestpractice"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="14"
        android:targetSdkVersion="14" />

    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name=".MainActivity"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <service android:name=".AlarmService" >
        </service>

        <receiver android:name=".AlarmReceiver" >
        </receiver>
        <receiver android:name=".BootCompleteReceiver" >
            <intent-filter>
                <action android:name="android.intent.action.BOOT_COMPLETED" />
            </intent-filter>
        </receiver>
    </application>

</manifest>

 　　7、點擊“開啟定時服務”按鈕后一段時間，最后點擊“取消定時服務”按鈕后的運行結果截圖：

　　8、存在的問題：定時任務在手機上測試時，計時不精確，但在模擬器上是精確的。這個問題現在還沒有找到很好的解決方案。