|
|
/*
|
|
|
* 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.
|
|
|
*/
|
|
|
|
|
|
// AlarmInitReceiver.java - 闹钟初始化广播接收器
|
|
|
// 主要功能：在设备启动后重新注册所有未触发的便签闹钟提醒
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
|
// ======================= 导入区域 =======================
|
|
|
// Android闹钟相关
|
|
|
import android.app.AlarmManager; // 闹钟管理器，用于设置系统闹钟
|
|
|
import android.app.PendingIntent; // 待定意图，用于延迟执行
|
|
|
// Android广播相关
|
|
|
import android.content.BroadcastReceiver; // 广播接收器基类
|
|
|
import android.content.ContentUris; // URI工具，用于构建带ID的URI
|
|
|
import android.content.Context; // 上下文
|
|
|
import android.content.Intent; // 意图
|
|
|
// Android数据库相关
|
|
|
import android.database.Cursor; // 数据库查询结果游标
|
|
|
|
|
|
// 应用内部数据模型
|
|
|
import net.micode.notes.data.Notes; // Notes主类
|
|
|
import net.micode.notes.data.Notes.NoteColumns; // 便签表列定义
|
|
|
|
|
|
// ======================= 闹钟初始化广播接收器 =======================
|
|
|
/**
|
|
|
* AlarmInitReceiver - 闹钟初始化广播接收器
|
|
|
* 继承自BroadcastReceiver，接收系统启动完成广播
|
|
|
* 主要功能：设备重启后重新注册所有未来的闹钟提醒
|
|
|
*
|
|
|
* AndroidManifest.xml中注册：
|
|
|
* <receiver android:name=".ui.AlarmInitReceiver" android:exported="true">
|
|
|
* <intent-filter>
|
|
|
* <action android:name="android.intent.action.BOOT_COMPLETED" />
|
|
|
* </intent-filter>
|
|
|
* </receiver>
|
|
|
*/
|
|
|
public class AlarmInitReceiver extends BroadcastReceiver {
|
|
|
|
|
|
// ======================= 数据库查询配置 =======================
|
|
|
|
|
|
/**
|
|
|
* 查询投影数组 - 指定从数据库查询哪些字段
|
|
|
* 优化查询性能，只获取需要的字段
|
|
|
*/
|
|
|
private static final String [] PROJECTION = new String [] {
|
|
|
NoteColumns.ID, // 0 - 便签ID，用于构建PendingIntent
|
|
|
NoteColumns.ALERTED_DATE // 1 - 提醒时间，用于设置闹钟
|
|
|
};
|
|
|
|
|
|
// 字段索引常量 - 提高代码可读性和维护性
|
|
|
private static final int COLUMN_ID = 0; // ID字段索引
|
|
|
private static final int COLUMN_ALERTED_DATE = 1; // 提醒时间字段索引
|
|
|
|
|
|
// ======================= 广播接收回调方法 =======================
|
|
|
|
|
|
/**
|
|
|
* onReceive - 广播接收回调方法
|
|
|
* 当接收到android.intent.action.BOOT_COMPLETED广播时调用
|
|
|
* 执行流程：
|
|
|
* 1. 查询所有未来需要提醒的便签
|
|
|
* 2. 为每个便签重新注册系统闹钟
|
|
|
* 3. 关闭数据库游标
|
|
|
*
|
|
|
* @param context 广播接收器的上下文
|
|
|
* @param intent 接收到的广播意图（包含BOOT_COMPLETED动作）
|
|
|
*/
|
|
|
@Override
|
|
|
public void onReceive(Context context, Intent intent) {
|
|
|
// 1. 获取当前时间戳，用于查询未来提醒
|
|
|
long currentDate = System.currentTimeMillis();
|
|
|
|
|
|
// 2. 查询数据库，获取所有未来需要提醒的便签
|
|
|
// 查询条件：提醒时间 > 当前时间 且 类型为普通便签
|
|
|
Cursor c = context.getContentResolver().query(
|
|
|
Notes.CONTENT_NOTE_URI, // 便签表内容URI
|
|
|
PROJECTION, // 查询字段：ID和提醒时间
|
|
|
NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,
|
|
|
new String[] { String.valueOf(currentDate) }, // 查询参数：当前时间
|
|
|
null); // 排序方式（null表示默认）
|
|
|
|
|
|
// 3. 检查查询结果是否有效
|
|
|
if (c != null) {
|
|
|
// 4. 遍历查询结果，为每个便签设置闹钟
|
|
|
if (c.moveToFirst()) {
|
|
|
do {
|
|
|
// 4.1 获取便签的提醒时间
|
|
|
long alertDate = c.getLong(COLUMN_ALERTED_DATE);
|
|
|
|
|
|
// 4.2 创建AlarmReceiver的Intent
|
|
|
// AlarmReceiver是实际处理闹钟触发的广播接收器
|
|
|
Intent sender = new Intent(context, AlarmReceiver.class);
|
|
|
|
|
|
// 4.3 设置Intent的数据URI，包含便签ID
|
|
|
// URI格式：content://micode_notes/note/{noteId}
|
|
|
sender.setData(ContentUris.withAppendedId(
|
|
|
Notes.CONTENT_NOTE_URI,
|
|
|
c.getLong(COLUMN_ID)
|
|
|
));
|
|
|
|
|
|
// 4.4 创建PendingIntent
|
|
|
// 参数说明：
|
|
|
// - context: 上下文
|
|
|
// - requestCode: 请求码（0表示默认）
|
|
|
// - intent: 要执行的Intent
|
|
|
// - flags: 标志位（0表示默认）
|
|
|
PendingIntent pendingIntent = PendingIntent.getBroadcast(
|
|
|
context,
|
|
|
0,
|
|
|
sender,
|
|
|
0
|
|
|
);
|
|
|
|
|
|
// 4.5 获取系统闹钟管理器
|
|
|
AlarmManager alarmManager = (AlarmManager) context
|
|
|
.getSystemService(Context.ALARM_SERVICE);
|
|
|
|
|
|
// 4.6 设置系统闹钟
|
|
|
// 参数说明：
|
|
|
// - AlarmManager.RTC_WAKEUP: 使用实时时钟，触发时唤醒设备
|
|
|
// - alertDate: 触发时间（毫秒时间戳）
|
|
|
// - pendingIntent: 触发时执行的PendingIntent
|
|
|
alarmManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
|
|
|
|
|
|
} while (c.moveToNext()); // 继续处理下一个便签
|
|
|
}
|
|
|
// 5. 关闭游标，释放数据库资源
|
|
|
c.close();
|
|
|
}
|
|
|
}
|
|
|
} |
