Rexsee API介绍：Android定时任务Alarm，附基本的闹钟功能示例
利用Rexsee扩展的Alarm可以快速实现关于任务定时的相关功能，基本的闹钟事件如下
【函数】 void set(String argu)
【说明】 设置闹钟。
【返回】 无
【参数】 argu：型如“key1=value1;key2=value2;......”的参数表。首先，该参数表支持rexseeNotification.show()函数的所有参数，用于显示通知（调用rexseeNotification.show()），请参见rexseeNotification。另外，该参数表增加了以下参数：
- forcerepeat：true或false。当该闹钟是由推送信息而非页面设定时，如果id和之前的推送信息的id重复，由该参数决定是否强制重新执行，默认为false，即不会重复执行任何id重复的推送信息。
- command：闹钟响时要执行的命令，目前支持的命令包括：
- notification：发送通知，默认值。
- startApplication：启动程序。
- cleanApplicationData：清除本程序的业务数据（私有内存中的所有数据）。
- notificationimmediately：true或false，无论命令是否notification，该参数都允许系统在设置闹钟的第一时间先发送一个通知，然后在指定的时间延迟后再执行命令，默认为false。
- notificationafterexec：true或false，无论命令是否notification，该参数都允许系统在执行完命令后发送一个通知，默认为false。
- alermname：闹钟的名称，默认为"defaultAlerm"。
- alermfirsttime：时间戳，第一次闹钟响（即执行命令）的时间，如果设为0或其他小于当前时间的时间戳，命令将立即执行，默认为立即执行。
- alermrepeatinterval：毫秒数，第一次闹钟响之后，间隔该时间后重复执行命令，如果小于零，将不会重复执行。
- startApplicationUrl：如果命令为startApplication，程序启动后访问的URL地址。
【示例】
rexseeAlarm.set('command=startApplication;startApplicationUrl=http://www.rexsee.com/rexsee/alarmClock.html;alermName=test;alermfirsttime='+(rexseeAlarm.getCurrentTime()+5000)+';title=闹钟测试;message=闹钟测试内容;url=http://www.rexsee.com/rexsee/alarmClock.html');
rexseeDialog.toast('设置完毕！');
【函数】 JsonObjectArray get()
【说明】 读取所有的闹钟信息。
【返回】 JSON对象数组，使用eval('('+json+')')转换为JavaScript对象数组。
【参数】 无
【示例】
alert(rexseeAlarm.get());
【函数】 void cancel(String name)
【说明】 取消闹钟。
【返回】 无
【参数】 name：闹钟名称。
【示例】
rexseeAlarm.cancel('test');
rexseeDialog.toast('取消完毕！');
rexseeAlarm.java源码如下：
/*
* Copyright (C) 2011 The Rexsee Open Source Project
*
* Licensed under the Rexsee License, Version 1.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.rexsee.com/CN/legal/license.html
*
* 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.
*/
package rexsee.core.alarm;
import rexsee.core.browser.JavascriptInterface;
import rexsee.core.browser.RexseeBrowser;
import rexsee.core.device.NotificationArgumentsSheet;
import rexsee.core.device.RexseeNotification;
import rexsee.core.receiver._Receiver;
import android.app.AlarmManager;
import android.app.PendingIntent;
import android.content.Context;
import android.content.Intent;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
public class RexseeAlarm implements JavascriptInterface {
private static final String INTERFACE_NAME = "Alarm";
@Override
public String getInterfaceName() {
return mBrowser.application.resources.prefix + INTERFACE_NAME;
}
@Override
public JavascriptInterface getInheritInterface(RexseeBrowser childBrowser) {
return this;
}
@Override
public JavascriptInterface getNewInterface(RexseeBrowser childBrowser) {
return new RexseeAlarm(childBrowser);
}
public static final String ALARM_ACTION = "action.alarm.id_";
public static final String ALARM_EXTRA_ARGU = "argu";
public static final String DATABASE_ALARM = "alarm.db";
public static final String TABLE_ALARM = "alarm";
private final Context mContext;
private final RexseeBrowser mBrowser;
public RexseeAlarm(RexseeBrowser browser) {
mBrowser = browser;
mContext = browser.getContext();
}
public RexseeAlarm(Context context) {
mBrowser = null;
mContext = context;
}
private static void _setAlarm(Context context, AlarmManager mgr, String body, boolean save) {
NotificationArgumentsSheet argu = (new NotificationArgumentsSheet()).parseArguments(body);
if (argu.notificationimmediately) {
(new RexseeNotification(context)).show(argu);
}
if (argu.getAlermFirstTime() > System.currentTimeMillis()) {
Intent intent = new Intent(context, _Receiver.class);
intent.setAction(ALARM_ACTION + argu.alermname);
intent.putExtra(ALARM_EXTRA_ARGU, body);
PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
mgr.cancel(pendingIntent);
long interval = argu.getAlermRepeatInterval();
if (interval > 0) {
mgr.setRepeating(AlarmManager.RTC_WAKEUP, argu.getAlermFirstTime(), interval, pendingIntent);
} else {
mgr.set(AlarmManager.RTC_WAKEUP, argu.getAlermFirstTime(), pendingIntent);
}
if (save) {
SQLiteDatabase db = context.openOrCreateDatabase(DATABASE_ALARM, Context.MODE_PRIVATE, null);
try {
db.execSQL("CREATE TABLE if not exists " + TABLE_ALARM + " (name TEXT, argu TEXT, Primary key(name));");
db.execSQL("DELETE FROM " + TABLE_ALARM + " WHERE name='" + argu.alermname + "';");
db.execSQL("INSERT INTO " + TABLE_ALARM + " VALUES ('" + argu.alermname + "', '" + body + "');");
} catch (Exception e) {
}
db.close();
}
} else {
exec(context, body);
}
}
private static void _deleteAlarm(Context context, String name) {
SQLiteDatabase db = context.openOrCreateDatabase(DATABASE_ALARM, Context.MODE_PRIVATE, null);
try {
db.execSQL("DELETE FROM " + TABLE_ALARM + " WHERE name='" + name + "';");
} catch (Exception e) {
}
db.close();
}
public static void exec(Context context, String body) {
NotificationArgumentsSheet argu = (new NotificationArgumentsSheet()).parseArguments(body);
if (argu.getAlermRepeatInterval() <= 0) {
_deleteAlarm(context, argu.alermname);
}
(new RexseeRemoteCommand(context, body)).exec();
}
public static void updateAlarm(Context context) {
SQLiteDatabase db = context.openOrCreateDatabase(DATABASE_ALARM, Context.MODE_PRIVATE, null);
AlarmManager mgr = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
try {
db.execSQL("CREATE TABLE if not exists " + TABLE_ALARM + " (name TEXT, argu TEXT, Primary key(name));");
Cursor cursor = db.rawQuery("SELECT * from " + TABLE_ALARM + ";", null);
if (cursor != null && cursor.getCount() != 0) {
for (int i = 0; i < cursor.getCount(); i++) {
cursor.moveToPosition(i);
_setAlarm(context, mgr, cursor.getString(1), false);
}
}
cursor.close();
} catch (Exception e) {
}
db.close();
}
//JavaScript Interface
public void set(String body) {
_setAlarm(mContext, (AlarmManager) mContext.getSystemService(Context.ALARM_SERVICE), body, true);
}
public String get() {
SQLiteDatabase db = mContext.openOrCreateDatabase(DATABASE_ALARM, Context.MODE_PRIVATE, null);
String rtn = "";
try {
Cursor cursor = db.rawQuery("SELECT * from " + TABLE_ALARM + ";", null);
if (cursor != null && cursor.getCount() != 0) {
for (int i = 0; i < cursor.getCount(); i++) {
cursor.moveToPosition(i);
if (i > 0) rtn += ",";
rtn += "{";
rtn += "\"name\":\"" + cursor.getString(0) + "\"";
rtn += ",\"argu\":\"" + cursor.getString(1) + "\"";
rtn += "}";
}
}
cursor.close();
} catch (Exception e) {
if (mBrowser != null) mBrowser.exception(getInterfaceName(), e);
}
db.close();
return "[" + rtn + "]";
}
public void cancel(String name) {
Intent intent = new Intent(mContext, _Receiver.class);
intent.setAction(ALARM_ACTION + name);
PendingIntent pendingIntent = PendingIntent.getBroadcast(mContext, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT);
AlarmManager mgr = (AlarmManager) mContext.getSystemService(Context.ALARM_SERVICE);
mgr.cancel(pendingIntent);
_deleteAlarm(mContext, name);
}
public long getCurrentTime() {
return System.currentTimeMillis();
}
public long getMillisPerHour() {
return 3600 * 1000;
}
public long getMillisPerDay() {
return 3600 * 1000 * 24;
}
}
仅对Rexsee的源码和函数事件做了整理，相关的demo或源码解析可以在Rexsee社区了解，目前Rexsee已提供了近2000个扩展，覆盖Android原生功能超过90%，且全部开放： http://www.rexsee.com/
