|
|
/*
|
|
|
* 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.
|
|
|
*/
|
|
|
|
|
|
// 包声明，表明该类所在的包名为net.micode.notes.ui
|
|
|
package net.micode.notes.ui;
|
|
|
|
|
|
import android.app.AlarmManager;
|
|
|
import android.app.PendingIntent;
|
|
|
import android.content.BroadcastReceiver;
|
|
|
import android.content.ContentUris;
|
|
|
import android.content.Context;
|
|
|
import android.content.Intent;
|
|
|
import android.database.Cursor;
|
|
|
|
|
|
import net.micode.notes.data.Notes;
|
|
|
import net.micode.notes.data.Notes.NoteColumns;
|
|
|
|
|
|
// AlarmInitReceiver类继承自BroadcastReceiver，用于接收广播并处理与闹钟初始化相关的逻辑，比如根据条件设置闹钟提醒等操作
|
|
|
public class AlarmInitReceiver extends BroadcastReceiver {
|
|
|
|
|
|
// 定义一个字符串数组，用于指定从数据库查询时需要获取的列名，这里获取笔记的ID和提醒日期这两列信息
|
|
|
private static final String [] PROJECTION = new String [] {
|
|
|
NoteColumns.ID,
|
|
|
NoteColumns.ALERTED_DATE
|
|
|
};
|
|
|
|
|
|
// 定义常量，用于表示查询结果中笔记ID所在列的索引，方便后续从Cursor中获取对应数据，值为0表示第一列
|
|
|
private static final int COLUMN_ID = 0;
|
|
|
// 定义常量，用于表示查询结果中提醒日期所在列的索引，方便后续从Cursor中获取对应数据，值为1表示第二列
|
|
|
private static final int COLUMN_ALERTED_DATE = 1;
|
|
|
|
|
|
// 重写BroadcastReceiver的onReceive方法，当接收到广播时会被调用，在此方法中实现具体的业务逻辑
|
|
|
@Override
|
|
|
public void onReceive(Context context, Intent intent) {
|
|
|
// 获取当前的系统时间（以毫秒为单位），用于后续与笔记的提醒日期进行比较，判断哪些笔记需要设置闹钟提醒
|
|
|
long currentDate = System.currentTimeMillis();
|
|
|
|
|
|
// 通过ContentResolver发起一个数据库查询操作，从指定的笔记内容URI（Notes.CONTENT_NOTE_URI）中查询数据
|
|
|
// 查询的列由PROJECTION指定，查询条件是提醒日期大于当前日期并且笔记类型为普通笔记（Notes.TYPE_NOTE）
|
|
|
// 条件中的参数通过后面的字符串数组传入当前时间的值
|
|
|
// 最后一个参数null表示查询不需要排序等额外设置
|
|
|
Cursor c = context.getContentResolver().query(Notes.CONTENT_NOTE_URI,
|
|
|
PROJECTION,
|
|
|
NoteColumns.ALERTED_DATE + ">? AND " + NoteColumns.TYPE + "=" + Notes.TYPE_NOTE,
|
|
|
new String[] { String.valueOf(currentDate) },
|
|
|
null);
|
|
|
|
|
|
// 判断查询结果的Cursor是否为空，如果不为空，表示有满足条件的数据，进行后续操作
|
|
|
if (c!= null) {
|
|
|
// 将Cursor的指针移动到第一条数据位置，如果有数据则返回true，可以开始遍历数据
|
|
|
if (c.moveToFirst()) {
|
|
|
// 使用do-while循环来遍历查询结果集，确保至少会执行一次循环体中的操作
|
|
|
do {
|
|
|
// 从Cursor中获取提醒日期这一列的数据（通过之前定义的列索引COLUMN_ALERTED_DATE），得到具体的提醒时间戳
|
|
|
long alertDate = c.getLong(COLUMN_ALERTED_DATE);
|
|
|
// 创建一个Intent，用于指定当闹钟触发时要启动的组件，这里指定为AlarmReceiver类
|
|
|
Intent sender = new Intent(context, AlarmReceiver.class);
|
|
|
// 给Intent设置数据，将笔记的ID附加到对应的内容URI上，这样可以传递具体是哪个笔记的闹钟触发了
|
|
|
sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
|
|
|
// 创建一个PendingIntent，用于包装前面创建的Intent，以便交给AlarmManager使用，
|
|
|
// 这里的请求码设置为0，表示没有特定的请求标识，并且使用的是广播类型的PendingIntent
|
|
|
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
|
|
|
// 获取系统的AlarmManager服务，用于设置闹钟相关的操作
|
|
|
AlarmManager alermManager = (AlarmManager) context
|
|
|
.getSystemService(Context.ALARM_SERVICE);
|
|
|
// 通过AlarmManager设置一个闹钟，使用RTC_WAKEUP模式（表示在指定的绝对时间唤醒设备来触发闹钟），
|
|
|
// 指定提醒时间为前面获取的alertDate，并且关联对应的PendingIntent，当时间到达时会触发对应的广播
|
|
|
alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
|
|
|
} while (c.moveToNext()); // 判断是否还有下一条数据，如果有则继续循环执行操作，处理下一条满足条件的笔记数据
|
|
|
}
|
|
|
// 关闭Cursor，释放相关的资源，避免内存泄漏等问题
|
|
|
c.close();
|
|
|
}
|
|
|
}
|
|
|
} |
