小米开源便签Notes-源码研究(2)-定时提醒的便签

本篇讲述小米便签中的定时提醒功能。
便签，可以理解为一件事情，一项任务，有个定时提醒的功能，还是蛮不错的~

小米便签定时功能，是当编辑便签的时候，有个菜单项，选了之后，就弹出一个“日期对话框”，
选择了日期，就设置了定时功能。

下面讲解技术实现的整体思路（很多地方我也不懂，不懂的就搜索）：

AndroidManifest.xml配置

<receiver android:name=".ui.AlarmInitReceiver" >
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />
</intent-filter>
</receiver>

<receiver
android:name="net.micode.notes.ui.AlarmReceiver"
android:process=":remote" >
</receiver>

<activity
android:name=".ui.AlarmAlertActivity"
android:label="@string/app_name"
android:launchMode="singleInstance"
android:theme="@android:style/Theme.Holo.Wallpaper.NoTitleBar" >
</activity>

定义了2个receiver和1个activity。

Broadcast Receiver（广播接收器）是Android中的四大组件之一。

AlarmInitReceiver的配置“android.intent.action.BOOT_COMPLETED”，表明
Android手机开机后，会发送android.intent.action.BOOT_COMPLETED广播，监听这个广播就能监听开机。
开机之后，就处理已有的便签，逐条比较日期，如果有到期的，就用AlarmManager提醒用户。

场景1.刚刚提到的，开机的时候，需要处理已有的便签。

public class AlarmInitReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
long currentDate = System.currentTimeMillis();
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);

if (c != null) {
if (c.moveToFirst()) {
do {
long alertDate = c.getLong(COLUMN_ALERTED_DATE);
Intent sender = new Intent(context, AlarmReceiver.class);
sender.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI, c.getLong(COLUMN_ID)));
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, sender, 0);
AlarmManager alermManager = (AlarmManager) context
.getSystemService(Context.ALARM_SERVICE);
alermManager.set(AlarmManager.RTC_WAKEUP, alertDate, pendingIntent);
} while (c.moveToNext());
}
c.close();
}
}
}

场景2：编辑便签的时候，需要设置日期。

NodeEditActivity的菜单事件

case R.id.menu_delete_remind:
mWorkingNote.setAlertDate(0, false);
break;

WorkingNote
public void setAlertDate(long date, boolean set) {
if (date != mAlertDate) {
mAlertDate = date;
mNote.setNoteValue(NoteColumns.ALERTED_DATE,
String.valueOf(mAlertDate));
}
if (mNoteSettingStatusListener != null) {
mNoteSettingStatusListener.onClockAlertChanged(date, set);
}
}

事件监听器，最终还是NodeEditActivity
public void onClockAlertChanged(long date, boolean set) {
/**
* User could set clock to an unsaved note, so before setting the alert
* clock, we should save the note first
*/
if (!mWorkingNote.existInDatabase()) {
saveNote();
}
if (mWorkingNote.getNoteId() > 0) {
Intent intent = new Intent(this, AlarmReceiver.class);
intent.setData(ContentUris.withAppendedId(Notes.CONTENT_NOTE_URI,
mWorkingNote.getNoteId()));
PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0,
intent, 0);
AlarmManager alarmManager = ((AlarmManager) getSystemService(ALARM_SERVICE));
showAlertHeader();
if (!set) {
alarmManager.cancel(pendingIntent);
} else {
alarmManager.set(AlarmManager.RTC_WAKEUP, date, pendingIntent);
}
} else {
/**
* There is the condition that user has input nothing (the note is
* not worthy saving), we have no note id, remind the user that he
* should input something
*/
Log.e(TAG, "Clock alert setting error");
showToast(R.string.error_note_empty_for_clock);
}
}

如果用户设置了时间，就通过AlarmManager放一个监听事项。

场景3：提醒广播的最终执行者
AlarmInitReceiver是负责，系统启动的时候，处理notes。
AlarmReceiver一直在等待“有note需要提醒用户”的广播。

public class AlarmReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
intent.setClass(context, AlarmAlertActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
context.startActivity(intent);
}
}
时间到期，提醒的活动是AlarmAlertActivity。
public class AlarmAlertActivity extends Activity implements OnClickListener,
OnDismissListener {

protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
requestWindowFeature(Window.FEATURE_NO_TITLE);

final Window win = getWindow();
win.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED);

if (!isScreenOn()) {
win.addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON
| WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON
| WindowManager.LayoutParams.FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
| WindowManager.LayoutParams.FLAG_LAYOUT_INSET_DECOR);
}

Intent intent = getIntent();

try {
mNoteId = Long.valueOf(intent.getData().getPathSegments().get(1));
mSnippet = DataUtils.getSnippetById(this.getContentResolver(),
mNoteId);
mSnippet = mSnippet.length() > SNIPPET_PREW_MAX_LEN ? mSnippet
.substring(0, SNIPPET_PREW_MAX_LEN)
+ getResources().getString(R.string.notelist_string_info)
: mSnippet;
} catch (IllegalArgumentException e) {
e.printStackTrace();
return;
}

mPlayer = new MediaPlayer();
if (DataUtils.visibleInNoteDatabase(getContentResolver(), mNoteId,
Notes.TYPE_NOTE)) {
showActionDialog();
playAlarmSound();
} else {
finish();
}
}
}

需要特别学习的Android机制和类库。
a.AlarmManager
AlarmManager，顾名思义，就是“提醒”，是Android中常用的一种系统级别的提示服务，在特定的时刻为我们广播一个指定的Intent。
简单的说就是我们设定一个时间，然后在该时间到来时，AlarmManager为我们广播一个我们设定的Intent。
通常我们使用PendingIntent，PendingIntent可以理解为Intent的封装包，简单的说就是在Intent上在加个指定的动作。
在使用Intent的时候，我们还需要在执行startActivity、startService或sendBroadcast才能使Intent有用。
而PendingIntent的话就是将这个动作包含在内了。
b.MediaPlayer播放声音。
c.RingtoneManager铃声。
d.PowerManager和WindowManager。
播放铃声的时候，首先判断PowerManager.isScreenOn判断屏幕是否"亮"，如果没亮需要做一些处理。
WindowManager允许app和窗口交互（The interface that apps use to talk to the window manager. ）。
应该就是在锁屏等情况，做一点特殊处理，还没有具体去细看。

PowerManager,电源管理~

写在最后：
研究过程中，遇到很多不很懂的代码，网上搜索学习下，基本就知道怎么回事了。
2011年，4年前就有过2个月时间的学习。
现在工作好几年了，各种技术都研究或者了解过。
现在，重新看Android应用开发，难度不是很大。
对Android有了整体的了解，看了几本书，就可以自己研究写代码了。
不懂的，网上找找资料，然后自己总结，时间长了，估计1~2年，就算是了熟练工了。
预计，到2016年下半年，我的Android水平就很不错了。
在武汉这种二线城市，如果让我搞Android开发，薪资在8k~15k左右吧~
也许~

参考资料：
Android开机广播android.intent.action.BOOT_COMPLETED http://my.oschina.net/onlytwo/blog/281892
AndroidManifest.xml文件详解（receiver） http://blog.csdn.net/think_soft/article/details/7583047
Android中Broadcast Receiver组件详解 http://blog.csdn.net/zuolongsnail/article/details/6450156
Android中的AlarmManager的使用 http://blog.csdn.net/wangxingwu_314/article/details/8060312
【Android笔记】MediaPlayer基本使用方式 http://blog.csdn.net/ddna/article/details/5176233#reply
Media开发之铃声设置(RingtoneManager) http://rocking-kaan-126-com.iteye.com/blog/1228215
Android判断屏幕锁屏的方法总结 http://www.2cto.com/kf/201404/296615.html
android 之 PowerManager 与电源管理 http://blog.csdn.net/xieqibao/article/details/6562256