例子：选择一个联系人
在这个例子里，你将要创建一个新的子Activity来响应联系人数据的PICK_ACTION动作。它显示联系人数据库中每个联系人，允许用户选择其中一个，在关闭之前返回它的URI给调用方的Activity。
值得注意的是，这个例子有点做作。Android已经提供了一个Intent Filter来从一个列表中挑选一个联系人，而且被隐式Intent（包含着content://contacts/people/的URI）触发。这个练习的目的是演示这种形式，即使这个特定的实现并不有用。
1. 创建一个新的ContactPicker工程，包含ContactPicker Activity。
package com.paad.contactpicker;
import android.app.Activity;
import android.content.Intent;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.provider.Contacts.People;
import android.view.View;
import android.widget.AdapterView;
import android.widget.ListView;
import android.widget.SimpleCursorAdapter;
import android.widget.AdapterView.OnItemClickListener;
public class ContactPicker extends Activity {
@Override
public void onCreate(Bundle icicle) {
super.onCreate(icicle);
setContentView(R.layout.main);
}
}
2. 修改main.xml layout资源，包含一个ListView控件。这个控件用来显示联系人。
<?xml version=”1.0” encoding=”utf-8”?>
<LinearLayout xmlns:android=”http://schemas.android.com/apk/res/android”
android:orientation=”vertical”
android:layout_width=”fill_parent”
android:layout_height=”fill_parent”>
<ListView
android:id=”@+id/contactListView”
android:layout_width=”fill_parent”
android:layout_height=”wrap_content”
/>
</LinearLayout>
3. 创建一个新的listitemlayout.xml layout资源，包含一个TextView。它用来显示ListView中的单个联系人。
<?xml version=”1.0” encoding=”utf-8”?>
<LinearLayout
xmlns:android=”http://schemas.android.com/apk/res/android”
android:orientation=”vertical”
android:layout_width=”fill_parent”
android:layout_height=”fill_parent”>
<TextView
android:id=”@+id/itemTextView”
android:layout_width=”fill_parent”
android:layout_height=”wrap_content”
android:padding=”10px”
android:textSize=”16px”
android:textColor=”#FFF”
/>
</LinearLayout>
4. 返回到ContactPicker Activity中。重写onCreate方法，从隐式Intent中释放path数据。
@Override
public void onCreate(Bundle icicle) {
super.onCreate(icicle);
setContentView(R.layout.main);
Intent intent = getIntent();
String dataPath = intent.getData().toString();
4.1. 为储存在联系人列表中的人创建一个新的URI，并且使用一个SimpleCursorAdapter将其与ListView绑定。
SimpleCursorAdapter允许你通过Content Provider设定游标数据给View。在这里使用时没有什么提示，但在这章的后面会有更多的解释。
final Uri data = Uri.parse(dataPath + “people/”);
final Cursor c = managedQuery(data, null, null, null, null);
String[] from = new String[] {People.NAME};
int[] to = new int[] { R.id.itemTextView };
SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, R.layout.listitemlayout, c, from, to);
ListView lv = (ListView)findViewById(R.id.contactListView);
lv.setAdapter(adapter);
4.2. 给ListView添加一个ItemClickListener 。从列表中选择一个联系人时，必须返回一个path给调用方Activity。
lv.setOnItemClickListener(new OnItemClickListener() {
public void onItemClick(AdapterView<?> parent, View view, int pos， long id) {
// Move the cursor to the selected item
c.moveToPosition(pos);
// Extract the row id.
int rowId = c.getInt(c.getColumnIndexOrThrow(“_id”));
// Construct the result URI.
Uri outURI = Uri.parse(data.toString() + rowId);
Intent outData = new Intent();
outData.setData(outURI);
setResult(Activity.RESULT_OK, outData);
finish();
}
});
4.3. 关闭onCreate方法.
5. 修改应用程序的manifest，替换Activity的intent-filter标签，增加对联系人数据应用PICK动作的支持。
<?xml version=”1.0” encoding=”utf-8”?>
<manifest xmlns:android=”http://schemas.android.com/apk/res/android”
package=”com.paad.contactpicker”>
<application android:icon=”@drawable/icon”>
<activity android:name=”ContactPicker”
android:label=”@string/app_name”>
<intent-filter>
<action android:name=”android.intent.action.PICK”/>
<category android:name=”android.intent.category.DEFAULT”/>
<data android:path=”contacts” android:scheme=”content”>
</data>
</intent-filter>
</activity>
</application>
</manifest>
6. 这就完成子Activity。为了测试它，创建一个新的测试ContentPickerTester Activity。创建一个新的layout资源（contentpickertester ），包含一个TextView显示选择的联系人，一个Button用来启动子Activity。
<?xml version=”1.0” encoding=”utf-8”?>
<LinearLayout
xmlns:android=”http://schemas.android.com/apk/res/android”
android:orientation=”vertical”
android:layout_width=”fill_parent”
android:layout_height=”fill_parent”>
<TextView
android:id=”@+id/selected_contact_textview”
android:layout_width=”fill_parent”
android:layout_height=”wrap_content”
/>
<Button
android:id=”@+id/pick_contact_button”
android:layout_width=”fill_parent”
android:layout_height=”wrap_content”
android:text=”Pick Contact”
/>
</LinearLayout>
7. 重写ContentPickerTester的onCreate方法，给Button增加一个Click listener，这样，它就能通过指定PICK_ACTION和联系人数据库URI(content://contacts/)来隐式启动一个子Activity。
package com.paad.contactpicker;
import android.app.Activity;
import android.content.Intent;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.provider.Contacts.People;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.TextView;
public class ContentPickerTester extends Activity {
public static final int PICK_CONTACT = 1;
@Override
public void onCreate(Bundle icicle)
{
super.onCreate(icicle);
setContentView(R.layout.contentpickertester);
Button button = (Button)findViewById(R.id.pick_contact_button);
button.setOnClickListener(new OnClickListener()
{
public void onClick(View _view)
{
Intent intent = new Intent(Intent.ACTION_PICK, Uri.parse(“content://contacts/”));
startActivityForResult(intent, PICK_CONTACT);
}
});
}
}
8. 当子Activity返回时，使用返回值来将选择的联系人姓名填入TextView。
@Override
public void onActivityResult(int reqCode, int resCode, Intent data) {
super.onActivityResult(reqCode, resCode, data);
switch(reqCode)
{
case (PICK_CONTACT) :
{
if (resCode == Activity.RESULT_OK)
{
Uri contactData = data.getData();
Cursor c = managedQuery(contactData, null, null, null, null);
c.moveToFirst();
String name;
name = c.getString(c.getColumnIndexOrThrow(People.NAME));
TextView tv;
tv = (TextView)findViewById(R.id.selected_contact_textview);
tv.setText(name);
}
break;
}
}
}
9. 当你的测试类完成后，简单地把它增加到应用程序的manifest中。你还需要增加一个uses-permission标签，添加READ_CONTACTS权限，来运行应用程序读取联系人数据库。
<?xml version=”1.0” encoding=”utf-8”?>
<manifest xmlns:android=”http://schemas.android.com/apk/res/android”
package=”com.paad.contactpicker”>
<application android:icon=”@drawable/icon”>
<activity android:name=”.ContactPicker”
android:label=”@string/app_name”>
<intent-filter>
<action android:name=”android.intent.action.PICK”/>
<category android:name=”android.intent.category.DEFAULT”/>
<data android:path=”contacts” android:scheme=”content”/>
</intent-filter>
</activity>
<activity android:name=”.ContentPickerTester”
android:label=”Contact Picker Test”>
<intent-filter>
<action android:name=”android.intent.action.MAIN”/>
<category android:name=”android.intent.category.LAUNCHER”/>
</intent-filter>
</activity>
</application>
<uses-permission android:name=”android.permission.READ_CONTACTS”/>
</manifest>
当你的Activity运行时，按下按钮。ContactPicker Activity如图5-1所示：
图5-1
一旦你选择了一个联系人，父Activity会返回到前台，并且显示选择的联系人姓名，如图5-2所示。
图5-2
