Android（OPhone） 学习笔记1 - 搜索API的使用

 

       今天我刚开始学习OPhone 手机开发，首先我下载了最新的OPhone 2.0 SDK，在其下sample文件夹里面有几个例子，其中一个就是有关搜索API的使用例子。于是，我就拿来研究一下。

   一、整体结构
首先我们来学习一下Search API Demo 这个例子，打开SearchAPIDemo文件，可以看到如下结构。

二、界面设计
该程序具备分析查询字段、使用搜索函数、列出搜索结果的功能。既然有搜索功能，界面上就需要一个文本输入框和按钮，以及一个带滚动功能的搜索结果显示。界面的配置在main.xml中实现。

三、重要代码
SearchAPIDemoActivity.java的部分代码如下：

我们来分析一下，难点在//send mail button下面，貌似写得很复杂。这里有一个Button的强制类型转换，它实际上是下面语句。
final Button button = (Button) findViewById(R.id.button_id); //新建一个按钮
button.setOnClickListener(new View.OnClickListener() {  //设置按钮响应事件
public void onClick(View v) {
searchWord();
}
});
按钮事件的函数如下：

该段代码很简单，即搜索字段非空时，执行搜索；搜索结束时，将滚动条移到起始位置。不过我们可以从中学习到控件的引用方法： (控件类型)findViewId(R.id.资源)。

接下来我们进入具体的搜索功能函数：
private void doSearch(String word) {

Cursor cursor = getContentResolver().query(Uri.parse(SearchProvider.CONTENT_URI), null, word, null, null);
textView.setText("Search word: " + word+ "/n/nSearch result: " );
while (cursor.moveToNext()) {
textView.append("/n/nITEM " + cursor.getPosition() + "/n");
Bundle extras = new Bundle();
extras = cursor.respond(extras);
showField(extras, SearchProvider.FIELD_ID);
showField(extras, SearchProvider.FIELD_TITLE);
showField(extras, SearchProvider.FIELD_TIME);
showField(extras, SearchProvider.FIELD_MIME);
showField(extras, SearchProvider.FIELD_CONTACTS_NAME);
showField(extras, SearchProvider.FIELD_EMAIL_SENDER);
showField(extras, SearchProvider.FIELD_EMAIL_RECEIVER);
showField(extras, SearchProvider.FIELD_EMAIL_SUBJECT);
showField(extras, SearchProvider.FIELD_SMS_SENDER);
showField(extras, SearchProvider.FIELD_MMS_SENDER);
showField(extras, SearchProvider.FIELD_MMS_RECEIVER);
showField(extras, SearchProvider.FIELD_FILE_SIZE);
showField(extras, SearchProvider.FIELD_CALL_NAME);
showField(extras, SearchProvider.FIELD_CALL_DURATION);
showField(extras, SearchProvider.FIELD_CALL_TYPE);
}
}
和helloworld程序一样，一开始需要定义搜索指针。cursor的respond方法作为用户和cursor的通信方式，将数据放在extras中。接下来用了很多showField方法，这个方法将extras的各个field提取出来。




这是搜索12获得的结果，有12580的呼叫记录。