rexseeReliableSubmit
返回手册目录
【函数】boolean add(String key, int priority, String url, String encoding, String message, long expireTime, String expireAction)
【说明】在离线提交队列中增加一个条目。
【返回】成功返回true,失败返回false(通常因为关键字重复)。
【参数】 key:条目关键字,如果提交的是文件,则代表上传名称,相当于<input type=file name=uploadname>中的uploadname。
priority:条目优先级,整数,值越大优先级越高。
url:要提交到的目的URL。
encoding:解析服务器返回信息时使用的编码。
message:要提交的信息,如果是文本,应是"name1=value1&name2=value2......"的POST字符串格式,如果是文件,应是以"file://"开头的文件路径。
expireTime:分钟数,系统将使用当前时间加上该分钟数计算出过期时间,一旦超过过期时间尚未提交成功,将放弃提交。
expireAction:过期时的动作,是一个 notification参数,参见rexseeNotificatioin。
【示例】
alert(rexseeReliableSubmit.add('test',0,'http://www.rexsee.com/rexsee/reliableSubmit.php','GBK','key=test&content=测试',600,''));
运行示例

【函数】boolean exists(String key)
【说明】当前离线提交队列中是否存在key指向的条目。
【返回】true或false。
【参数】key:条目关键字,如果是提交文件,则代表上传名称,相当于<input type=file name=uploadname>中的uploadname。
【示例】
alert(rexseeReliableSubmit.exists('test'));
运行示例

【函数】int size()
【说明】当前离线提交队列中的条目数。
【返回】离线提交队列中的条目数。
【参数】
【示例】
alert(rexseeReliableSubmit.size());
运行示例

【函数】JsonObject get(String key)
【说明】读取离线提交队列中是key指向的条目的内容。
【返回】 条目内容,是一个JSON字符串,代表一个对象,使用"eval('('+json+')')"可以转换为真正的JavaScript对象。
{
key:条目关键字,如果提交的是文件,则代表上传名称,相当于<input type=file name=uploadname>中的uploadname。
date: 时间戳,用户添加条目的时间。
url: 提交目的地的URL。
encoding: 解析服务器响应时要使用的编码格式。
message: 要提交的信息,如果是文本,应是"name1=value1&name2=value2......"的POST字符串格式,如果是文件,应是以"file://"开头的文件路径。
priority: 优先级。
expireDate: 时间戳,过期时间。
expireAction: 过期时的动作,是一个 notification参数,参见rexseeNotificatioin。
tries: 已经尝试的次数。
lastTry: 时间戳,最后尝试时间,0表示尚未尝试。
status: 状态,0表示等待,1表示成功,2表示过期。
response: 服务器回应的动作,是一个 notification参数,参见rexseeNotificatioin。
}
【参数】key:条目关键字,如果是提交文件,则代表上传名称,相当于<input type=file name=uploadname>中的uploadname。
【示例】
alert(rexseeReliableSubmit.get('test'));
运行示例

【函数】void triesToSubmit(String sql)
【说明】立即尝试提交根据sql语句从提交队列数据库表中查询出的所有条目。
【返回】
【参数】sql:SQL查询语句。

【函数】void tries(String key)
【说明】立即尝试提交根据key指向的条目,和triesToSubmit("SELECT * from message WHERE key='" + key + "';")等价。
【返回】
【参数】key:条目关键字。
【示例】
rexseeReliableSubmit.tries('test');
运行示例

【函数】void tries()
【说明】立即尝试提交等待状态的所有条目,和triesToSubmit("SELECT * from message WHERE status=0 ORDER BY priority DESC;")等价。
【返回】
【参数】key:条目关键字。
【示例】
rexseeReliableSubmit.tries();
运行示例

【函数】JsonArray getKeys(int status, boolean byPriority)
【说明】当前离线提交队列中指定状态的所有条目的关键字的列表。
【返回】所有条目的关键字的列表,是一个JSON字符串,代表一个数组,,使用"eval('('+json+')')"可以转换为真正的JavaScript数组对象。
【参数】status:指定的状态,-1为所有状态,0为等待状态,1为成功状态,2为过期状态。
byPriority:是否按照优先级排序。
【示例】
alert(rexseeReliableSubmit.getKeys(-1,true));
运行示例

【函数】JsonArray getKeys()
【函数】JsonArray getWaitingKeys()
【函数】JsonArray getDoneKeys()
【函数】JsonArray getExpiredKeys()
【说明】分别等价于getKeys(-1,true)、getKeys(0,true)、getKeys(1,true)和getKeys(2,true)。
【返回】关键字列表,是一个JSON字符串。
【参数】

【函数】void remove(String key)
【说明】从提交队列中删除key指向的条目。
【返回】
【参数】key:条目关键字。
【示例】
rexseeReliableSubmit.remove('test');
rexseeDialog.toast('Removed.');
运行示例

【函数】void removeWaiting()
【函数】void removeDone()
【函数】void removeExpired()
【说明】分别从离线提交队列中删除状态为等待、成功和过期的条目。
【返回】
【参数】
【示例】
rexseeReliableSubmit.removeExpired();
rexseeDialog.toast('Removed.');
运行示例

【函数】void setDurationAndTimeout(int durationMinutes, int timeOutSeconds)
【说明】设定离线提交的尝试周期和提交时网络超时时间。
【返回】
【参数】durationMinutes:尝试周期,分钟。
timeoutSeconds:超时时间,秒。
【示例】 设为15分钟和15秒:
rexseeReliableSubmit.setDurationAndTimeout(15,15);
rexseeDialog.toast('Updated.');
运行示例 设为5分钟和30秒(默认):
rexseeReliableSubmit.setDurationAndTimeout(5,30);
rexseeDialog.toast('Updated.');
运行示例

【函数】int getDuration()
【说明】读取尝试提交的周期。
【返回】尝试周期,分钟数。
【参数】
【示例】
alert(rexseeReliableSubmit.getDuration());
运行示例

【函数】String getTimeout()
【说明】读取超时时间。
【返回】超时时间,秒数。
【参数】
【示例】
alert(rexseeReliableSubmit.getTimeout());
运行示例
返回手册目录