引言
http://www.oschina.net/question/54100_28547
http://www.apkbus.com/android-18748-1-1.html
上篇我們介紹了Intents和Intent Filters的理論部分,主要是介紹了:activities、services、broadcastreceivers三種組件的Intent機制兩種Intent(顯式和隱式)及它們如何去匹配目的組件、Intent對象包含哪些信息、Intent Filters的action & category & data。
Intent的重要性,我不再著重介紹了,但我還是要說:Intent能夠使應用程序突破沙盒與外界交流,者這使得Android的世界變得豐富多彩!本篇將用實例來介紹,如何應用Intent,而且繼續用SMS方面的例子來闡述。本文的主要內容如下:
- 例子(需求)描述
- STEP1、添加用于顯示通訊錄的布局文件
- STEP2、添加Button的點擊事件
- STEP3、添加通訊錄活動
- STEP4、解析通訊錄返回的數據
- STEP5、在清單文件AndroidManifest.xml中注冊通訊錄活動和讀取Contact數據庫的權限
- 總結
例子(需求)描述
用手機發過SMS的人都知道:
- 用戶可以先編輯短信,然后再去通訊錄中選擇相應的人并發生給他。
- 用戶可以在短信內容中插入通訊錄中聯系人的號碼。
我們的這個例子就是要說明如何實現這個功能。要實現這個功能,即是創建一個新的Activity選擇(ACTION_PICK)通訊錄中的數據,它會顯示通訊錄中的所有聯系人并讓用戶選擇,然后關閉并返回一個聯系人的URI給短信程序。下面介紹如何一步一步實現類似的功能,而且是在之前Android 開發之旅:短信的收發及在android模擬器之間實踐(一)中發送SMS的例子(TextMessage)基礎上加上從通訊錄中選擇聯系人的功能。
STEP1、添加用于顯示通訊錄的布局文件
我們用一個ListView來顯示整個通訊錄,其中用TextView顯示每一記錄。它們的xml文件分別為contact.xml、listitemlayout,如下所示:
====================================contact.xml
01 |
<?xmlversion="1.0"encoding="utf-8"?> |
03 |
<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android" |
05 |
android:orientation="vertical" |
07 |
android:layout_width="fill_parent" |
09 |
android:layout_height="fill_parent" |
13 |
<ListViewandroid:id="@+id/contactListView" |
15 |
android:layout_width="fill_parent" |
17 |
android:layout_height="wrap_content" |
=================================== listitemlayout
01 |
<?xmlversion="1.0"encoding="utf-8"?> |
03 |
<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android" |
05 |
android:orientation="vertical"android:layout_width="fill_parent" |
07 |
android:layout_height="fill_parent"> |
09 |
<TextViewandroid:id="@+id/itemTextView"android:layout_width="wrap_content" |
11 |
android:layout_height="wrap_content"android:padding="10px" |
13 |
android:textSize="16px"android:textColor="#FFF" /> |
為了能夠打開通訊錄,我們還需要在TextMessage程序中加入一個Button btnContact,通過點擊btnContact激活顯示通訊錄的活動。這只需在main.xml文件中加入如下代碼:
1 |
<Buttonandroid:layout_width="wrap_content" |
2 |
android:layout_height="wrap_content" |
3 |
android:text="@string/btnContact" |
4 |
android:id="@+id/btnContact" /> |
記得還有在values/strings.xml中相應的加入<stringname="btnContact">contact</string>。
STEP2、添加Button的點擊事件
在上面準備工作做完之后,我們需要監聽btnContact的點擊事件,當用戶點擊btnContact時,跳轉顯示通訊錄界面,當用戶選擇一個聯系人之后,返回SMS程序的主界面。這里就要用到了偉大的Intent啦!
01 |
btnContact = (Button) findViewById(R.id.btnContact); |
03 |
btnContact.setOnClickListener(new View.OnClickListener() { |
07 |
publicvoid onClick(View v) { |
11 |
Intent intent = new Intent(Intent.ACTION_PICK, |
13 |
ContactsContract.Contacts.CONTENT_URI); |
15 |
startActivityForResult(intent, PICK_CONTACT); |
STEP3、添加通訊錄活動
添加一個類文件,類名為ContactPick(表示通訊錄活動名)繼承Activity。它的主要功能就是獲取從SMS主程序傳遞來的Intent并提取數據;然后去查詢通訊錄數據庫,取出數據并填充到STEP1中定義的ListView;最后,還需要添加當用戶選擇一個聯系人的事件onItemClick,將結果返回給SMS主程序,這里也用到了我們偉大的Intent啦!代碼如下:
01 |
package skynet.com.cnblogs.www; |
04 |
import android.app.Activity; |
06 |
import android.content.Intent; |
08 |
import android.database.Cursor; |
10 |
import android.net.Uri; |
12 |
import android.os.Bundle; |
14 |
import android.provider.ContactsContract; |
16 |
import android.view.View; |
18 |
import android.widget.AdapterView; |
20 |
import android.widget.ListView; |
22 |
importandroid.widget.SimpleCursorAdapter; |
24 |
import android.widget.AdapterView.OnItemClickListener; |
27 |
publicclass ContactPick extends Activity { |
29 |
/** Called when the activity is first created. */ |
33 |
publicvoid onCreate(Bundle savedInstanceState) { |
35 |
super.onCreate(savedInstanceState); |
37 |
setContentView(R.layout.main); |
40 |
Intent orgIntent=getIntent(); |
42 |
Uri queryUri=orgIntent.getData(); |
44 |
final Cursor c = managedQuery(queryUri, |
55 |
String[] fromColumns=new String[]{ContactsContract.Contacts.DISPLAY_NAME}; |
57 |
int[] toLayoutIDs = newint[] { R.id.itemTextView }; |
59 |
SimpleCursorAdapter adapter = newSimpleCursorAdapter(this, |
61 |
R.layout.listitemlayout, c, fromColumns, toLayoutIDs); |
63 |
ListView lv = (ListView) findViewById(R.id.contactListView); |
65 |
lv.setAdapter(adapter); |
67 |
lv.setOnItemClickListener(new OnItemClickListener() { |
71 |
publicvoid onItemClick(AdapterView<?> parent, View view, int pos, |
75 |
c.moveToPosition(pos); |
77 |
int rowId = c.getInt(c.getColumnIndexOrThrow(ContactsContract.Contacts._ID)); |
79 |
Uri outURI = Uri.parse(ContactsContract.Contacts.CONTENT_URI.toString() + rowId); |
81 |
Intent outData = new Intent(); |
83 |
outData.setData(outURI); |
85 |
setResult(Activity.RESULT_OK,outData); |
STEP4、解析通訊錄返回的數據
從通訊錄活動返回之后,我們從返回的Intent中提取數據并填充到填寫電話號碼的EditView中。代碼主要如下:
02 |
publicvoid onActivityResult(int reqCode, int resCode, Intent data) { |
04 |
super.onActivityResult(reqCode, resCode, data); |
09 |
case (PICK_CONTACT): { |
11 |
if (resCode == Activity.RESULT_OK) { |
15 |
Uri contactData = data.getData(); |
17 |
Cursor c = managedQuery(contactData, null, null, null, null); |
21 |
name = c.getString(c.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME)); |
25 |
tv = (TextView)findViewById(R.id.edtPhoneNo); |
STEP5、在清單文件AndroidManifest.xml中注冊通訊錄活動和讀取Contact數據庫的權限
主要工作基本做完了,現在我們只需要注冊通訊錄活動和讀取Contact數據的權限了。完整的清單文件代碼如下:
01 |
<?xmlversion="1.0"encoding="utf-8"?> |
02 |
<manifestxmlns:android="http://schemas.android.com/apk/res/android" |
03 |
package="skynet.com.cnblogs.www"android:versionCode="1" |
04 |
android:versionName="1.0"> |
08 |
<activityandroid:name=".TextMessage"android:label="@string/app_name"> |
12 |
<actionandroid:name="android.intent.action.MAIN"/> |
13 |
<categoryandroid:name="android.intent.category.LAUNCHER"/> |
19 |
<activityandroid:name=".ContactPick"android:label="@string/app_name"> |
20 |
<actionandroid:name="android.intent.action.PICK"/> |
21 |
<categoryandroid:name="android.intent.category.DEFAULT"/> |
27 |
<uses-permissionandroid:name="android.permission.SEND_SMS"/> |
28 |
<uses-permissionandroid:name="android.permission.READ_CONTACTS"/> |
注意通訊錄活動的Intent Filters,它的
action是
android.intent.action.PICK;
category是
android.intent.category.DEFAULT。現在我們分析一下這個Intent Filter:
- <actionandroid:name="android.intent.action.PICK"/>:使用戶能夠可以在通訊錄列表中選擇一個,然后將選擇的聯系人的 URL返回給調用者。
- <categoryandroid:name="android.intent.category.DEFAULT"/>:這是默認的category,如果不知道category系統會自動加上。這個屬性是讓使其能夠被像Context.startActivity()等找到。要說明的的是,如果列舉了多個category,這個活動僅會去處理那些Intent中都包含了所有列舉的category的組件。
我們還可以在清單文件中看到TextMessage活動的Intent Filter:
2 |
<actionandroid:name="android.intent.action.MAIN"/> |
3 |
<categoryandroid:name="android.intent.category.LAUNCHER"/> |
它指
TextMessage活動定是真個程序的入口并且
TextMessage會列舉在Launcher即啟動列表中。
程序運行結果如下圖所示:

圖1、主界面

圖2、點擊contact按鈕之后

圖3、選擇一個聯系人之后
總結
我們用發短信中選擇聯系人的例子說明Intent和Intent Filter,這里體現了兩個活動之間如何通過Intent和Intent Filter來交互,這也是我們在編寫Android應用程序的時候經常遇到了。本文除了上述的主要內容之外,還涉及別的知識點,下面列舉幾個個人認為比較有用的知識點: