Rexsee API介紹：SMS短信讀取

Rexsee是一個開源的移動Web開發平臺，深度支持Android。目前已擴展了接近2000個API，能夠經過js直接實現Android原生功能。

在此，將陸續梳理部分簡單的對象與事件說明，並將源碼貼出來。有興趣的TX也能夠在Rexsee的社區直接查看詳細內容： http://www.rexsee.com/CN/helpReference.php

基於rexsee擴展的rexseeSMS，經過JS實現短信讀取相關功能，如：

【函數】 JsonArray getContentUris()

【說明】 讀取短信相關的全部數據庫表的Uri地址。

【返回】 Json對象字符串，能夠用eval('('+json+')')轉換爲JavaScript對象。

【參數】 無

【示例】

alert(rexseeSMS.getContentUris());

【函數】 JsonObjectArray get(int number)

【說明】 讀取若干條短信。

【返回】 Json對象數組字符串，能夠用eval('('+json+')')轉換爲JavaScript對象數組，注意，其中body字段是escape過的，使用前須要unescape。

【參數】 number：要讀取的短信條數。

【示例】

alert(rexseeSMS.get(10));
alert(unescape(eval('('+rexseeSMS.get(1)+')')[0].body));

其它還有：

• getUnread(int number)：讀取若干條未讀短信；
• getRead(int number)：讀取若干條已讀短信；
• getInbox(int number)：從收件箱讀取若干條短信；
• getSent(int number)：讀取若干條已發短信；
• getByThread(int threadID)：讀取會話中全部短信；
• getThreads(int number)：讀取若干條會話；
• getData(String selection, int number)：根據條件讀取若干條短信。

詳細源碼：

/* 
* 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.communication;  
 
import rexsee.core.browser.JavascriptInterface;  
import rexsee.core.browser.RexseeBrowser;  
import rexsee.core.utilities.Escape;  
import android.content.ContentResolver;  
import android.content.Context;  
import android.database.Cursor;  
import android.net.Uri;  
 
public class RexseeSMS implements JavascriptInterface {  
 
       private static final String INTERFACE_NAME = "SMS";  
       @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 RexseeSMS(childBrowser);  
       }  
 
       public static final String CONTENT_URI_SMS = "content://sms";  
       public static final String CONTENT_URI_SMS_INBOX = "content://sms/inbox";  
       public static final String CONTENT_URI_SMS_SENT = "content://sms/sent";  
       public static final String CONTENT_URI_SMS_CONVERSATIONS = "content://sms/conversations";  
 
       public static String[] SMS_COLUMNS = new String[]{  
                       "_id", //0   
                       "thread_id", //1   
                       "address", //2  
                       "person", //3  
                       "date", //4  
                       "body", //5  
                       "read", //6; 0:not read 1:read; default is 0  
                       "type", //7;  0:all 1:inBox 2:sent 3:draft 4:outBox  5:failed 6:queued  
                       "service_center" //8  
       };  
       public static String[] THREAD_COLUMNS = new String[]{  
                       "thread_id",  
                       "msg_count",  
                       "snippet",  
       };  
 
       private final Context mContext;  
       private final RexseeBrowser mBrowser;  
 
       public RexseeSMS(RexseeBrowser browser) {  
               mBrowser = browser;  
               mContext = browser.getContext();  
       }  
 
       //JavaScript Interface  
       public String getContentUris() {  
               String rtn = "{";  
               rtn += "\"sms\":\"" + CONTENT_URI_SMS + "\"";  
               rtn += ",\"inbox\":\"" + CONTENT_URI_SMS_INBOX + "\"";  
               rtn += ",\"sent\":\"" + CONTENT_URI_SMS_SENT + "\"";  
               rtn += ",\"conversations\":\"" + CONTENT_URI_SMS_CONVERSATIONS + "\"";  
               rtn += "}";  
               return rtn;  
       }  
 
       public String get(int number) {  
               return getData(null, number);  
       }  
       public String getUnread(int number) {  
               return getData("type=1 AND read=0", number);  
       }  
       public String getRead(int number) {  
               return getData("type=1 AND read=1", number);  
       }  
       public String getInbox(int number) {  
               return getData("type=1", number);  
       }  
       public String getSent(int number) {  
               return getData("type=2", number);  
       }  
       public String getByThread(int thread) {  
               return getData("thread_id=" + thread, 0);  
       }  
       public String getData(String selection, int number) {  
               Cursor cursor = null;  
               ContentResolver contentResolver = mContext.getContentResolver();  
               try {  
                       if (number > 0) {  
                               cursor = contentResolver.query(Uri.parse(CONTENT_URI_SMS), SMS_COLUMNS, selection, null, "date desc limit " + number);  
                       } else {  
                               cursor = contentResolver.query(Uri.parse(CONTENT_URI_SMS), SMS_COLUMNS, selection, null, "date desc");  
                       }  
                       if (cursor == null || cursor.getCount() == 0) return "[]";  
                       String rtn = "";  
                       for (int i = 0; i < cursor.getCount(); i++) {  
                               cursor.moveToPosition(i);  
                               if (i > 0) rtn += ",";  
                               rtn += "{";  
                               rtn += "\"_id\":" + cursor.getString(0);  
                               rtn += ",\"thread_id\":" + cursor.getString(1);  
                               rtn += ",\"address\":\"" + cursor.getString(2) + "\"";  
                               rtn += ",\"person\":\"" + ((cursor.getString(3) == null) ? "" : cursor.getString(3)) + "\"";  
                               rtn += ",\"date\":" + cursor.getString(4);  
                               rtn += ",\"body\":\"" + Escape.escape(cursor.getString(5)) + "\"";  
                               rtn += ",\"read\":" + ((cursor.getInt(6) == 1) ? "true" : "false");  
                               rtn += ",\"type\":" + cursor.getString(7);  
                               rtn += ",\"service_center\":" + cursor.getString(8);  
                               rtn += "}";  
                       }  
                       return "[" + rtn + "]";  
               } catch (Exception e) {  
                       mBrowser.exception(getInterfaceName(), e);  
                       return "[]";  
               }  
       }  
       public String getThreads(int number) {  
               Cursor cursor = null;  
               ContentResolver contentResolver = mContext.getContentResolver();  
               try {  
                       if (number > 0) {  
                               cursor = contentResolver.query(Uri.parse(CONTENT_URI_SMS_CONVERSATIONS), THREAD_COLUMNS, null, null, "thread_id desc limit " + number);  
                       } else {  
                               cursor = contentResolver.query(Uri.parse(CONTENT_URI_SMS_CONVERSATIONS), THREAD_COLUMNS, null, null, "thread_id desc");  
                       }  
                       if (cursor == null || cursor.getCount() == 0) return "[]";  
                       String rtn = "";  
                       for (int i = 0; i < cursor.getCount(); i++) {  
                               cursor.moveToPosition(i);  
                               if (i > 0) rtn += ",";  
                               rtn += "{";  
                               rtn += "\"thread_id\":" + cursor.getString(0);  
                               rtn += ",\"msg_count\":" + cursor.getString(1);  
                               rtn += ",\"snippet\":\"" + Escape.escape(cursor.getString(2)) + "\"";  
                               rtn += "}";  
                       }  
                       return "[" + rtn + "]";  
               } catch (Exception e) {  
                       mBrowser.exception(getInterfaceName(), e);  
                       return "[]";  
               }  
       }  
 
}