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的呼叫记录。