編寫:jdneo - 原文:http://developer.android.com/training/beam-files/receive-files.html
Android Beam文件傳輸將文件拷貝至接收設備上的某個特殊目錄。同時使用Android Media Scanner掃描拷貝的文件，并在MediaStore provider中為媒體文件添加對應的條目記錄。本課將展示當文件拷貝完成時要如何響應，以及在接收設備上應該如何定位拷貝的文件。
當Android Beam文件傳輸將文件拷貝至接收設備后，它會發(fā)布一個包含Intent的通知，該Intent擁有：ACTION_VIEW，首個被傳輸文件的MIME類型，以及一個指向第一個文件的URI。用戶點擊該通知后，Intent會被發(fā)送至系統(tǒng)。為了使我們的應用程序能夠響應該Intent，我們需要為響應的Activity所對應的<activity>標簽添加一個<intent-filter>標簽，在<intent-filter>標簽中，添加以下子標簽：
<action android:name="android.intent.action.VIEW" />
該標簽用來匹配從通知發(fā)出的Intent，這些Intent具有ACTION_VIEW這一Action。
<category android:name="android.intent.category.CATEGORY_DEFAULT" />
該標簽用來匹配不含有顯式Category的Intent對象。
<data android:mimeType="mime-type" />
該標簽用來匹配一個MIME類型。僅僅指定那些我們的應用能夠處理的類型。
下例展示了如何添加一個intent filter來激活我們的activity：
<activity
android:name="com.example.android.nfctransfer.ViewActivity"
android:label="Android Beam Viewer" >
...
<intent-filter>
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.DEFAULT"/>
...
</intent-filter>
</activity>Note：Android Beam文件傳輸不是含有ACTION_VIEW的Intent的唯一可能發(fā)送者。在接收設備上的其它應用也有可能會發(fā)送含有該Action的intent。我們馬上會進一步討論這一問題。
要讀取Android Beam文件傳輸所拷貝到設備上的文件，需要請求READ_EXTERNAL_STORAGE權(quán)限。例如：
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />如果希望將文件拷貝至應用程序自己的存儲區(qū)，那么需要的權(quán)限改為WRITE_EXTERNAL_STORAGE，另外，WRITE_EXTERNAL_STORAGE權(quán)限包含了READ_EXTERNAL_STORAGE權(quán)限。
Note：對于Android 4.2.2（API Level 17）及之前版本的系統(tǒng)，READ_EXTERNAL_STORAGE權(quán)限僅在用戶選擇要讀文件時才是強制需要的。而在今后的版本中會在所有情況下都需要該權(quán)限。為保證應用程序在未來的穩(wěn)定性，建議在Manifest清單文件中聲明該權(quán)限。
由于我們的應用對于自身的內(nèi)部存儲區(qū)域具有控制權(quán)，因此當要將文件拷貝至應用程序自身的的內(nèi)部存儲區(qū)域時，不需要聲明寫權(quán)限。
Android Beam文件傳輸一次性將所有文件拷貝到目標設備的一個目錄中，Android Beam文件傳輸通知所發(fā)出的Intent中含有指向了第一個被傳輸?shù)奈募腢RI。然而，我們的應用程序也有可能接收到除了Android Beam文件傳輸之外的某個來源所發(fā)出的含有ACTION_VIEW這一Action的Intent。為了明確應該如何處理接收的Intent，我們要檢查它的Scheme和Authority。
可以調(diào)用Uri.getScheme()獲得URI的Scheme，下例展示了如何確定Scheme并對URI進行相應的處理：
public class MainActivity extends Activity {
...
// A File object containing the path to the transferred files
private File mParentPath;
// Incoming Intent
private Intent mIntent;
...
/*
* Called from onNewIntent() for a SINGLE_TOP Activity
* or onCreate() for a new Activity. For onNewIntent(),
* remember to call setIntent() to store the most
* current Intent
*
*/
private void handleViewIntent() {
...
// Get the Intent action
mIntent = getIntent();
String action = mIntent.getAction();
/*
* For ACTION_VIEW, the Activity is being asked to display data.
* Get the URI.
*/
if (TextUtils.equals(action, Intent.ACTION_VIEW)) {
// Get the URI from the Intent
Uri beamUri = mIntent.getData();
/*
* Test for the type of URI, by getting its scheme value
*/
if (TextUtils.equals(beamUri.getScheme(), "file")) {
mParentPath = handleFileUri(beamUri);
} else if (TextUtils.equals(
beamUri.getScheme(), "content")) {
mParentPath = handleContentUri(beamUri);
}
}
...
}
...
}如果接收的Intent包含一個File URI，則該URI包含了一個文件的絕對文件名，它包括了完整的路徑和文件名。對Android Beam文件傳輸來說，目錄路徑指向了其它被傳輸文件的位置（如果有其它傳輸文件的話），要獲得該目錄路徑，需要取得URI的路徑部分（URI中除去“file:”前綴的部分），根據(jù)路徑創(chuàng)建一個File對象，然后獲取這個File的父目錄：
...
public String handleFileUri(Uri beamUri) {
// Get the path part of the URI
String fileName = beamUri.getPath();
// Create a File object for this filename
File copiedFile = new File(fileName);
// Get a string containing the file's parent directory
return copiedFile.getParent();
}
...如果接收的Intent包含一個Content URI，這個URI可能指向的是存儲于MediaStore Content Provider的目錄和文件名。我們可以通過檢測URI的Authority值來判斷它是否是來自于MediaStore的Content URI。一個MediaStore的Content URI可能來自Android Beam文件傳輸也可能來自其它應用程序，但不管怎么樣，我們都能根據(jù)該Content URI獲得一個目錄路徑和文件名。
我們也可以接收一個含有ACTION_VIEW這一Action的Intent，它包含的Content URI針對于Content Provider，而不是MediaStore，這種情況下，該Content URI不包含MediaStore的Authority，且這個URI一般不指向一個目錄。
Note：對于Android Beam文件傳輸，接收在含有ACTION_VIEW的Intent中的Content URI時，若第一個接收的文件MIME類型為“audio/”，“image/”或者“video/*”，Android Beam文件傳輸會在它存儲傳輸文件的目錄內(nèi)運行Media Scanner，以此為媒體文件添加索引。同時Media Scanner將結(jié)果寫入MediaStore的Content Provider，之后它將第一個文件的Content URI回遞給Android Beam文件傳輸。這個Content URI就是我們在通知Intent中所接收到的。要獲得第一個文件的目錄，需要使用該Content URI從MediaStore中獲取它。
為了確定是否能從Content URI中獲取文件目錄，可以通過調(diào)用Uri.getAuthority()獲取URI的Authority，以此確定與該URI相關(guān)聯(lián)的Content Provider。其結(jié)果有兩個可能的值：
表明該URI關(guān)聯(lián)了被MediaStore記錄的一個文件或者多個文件?？梢詮?a rel="nofollow" >MediaStore中獲取文件的全名，目錄名就自然可以從文件全名中獲取。
其他值
來自其他Content Provider的Content URI?？梢燥@示與該Content URI相關(guān)聯(lián)的數(shù)據(jù)，但是不要嘗試去獲取文件目錄。
要從MediaStore的Content URI中獲取目錄，我們需要執(zhí)行一個查詢操作，它將Uri參數(shù)指定為收到的ContentURI，將MediaColumns.DATA列作為投影（Projection）。返回的Cursor對象包含了URI所代表的文件的完整路徑和文件名。該目錄路徑下還包含了由Android Beam文件傳輸傳送到該設備上的其它文件。
下面的代碼展示了如何測試Content URI的Authority，并獲取傳輸文件的路徑和文件名：
...
public String handleContentUri(Uri beamUri) {
// Position of the filename in the query Cursor
int filenameIndex;
// File object for the filename
File copiedFile;
// The filename stored in MediaStore
String fileName;
// Test the authority of the URI
if (!TextUtils.equals(beamUri.getAuthority(), MediaStore.AUTHORITY)) {
/*
* Handle content URIs for other content providers
*/
// For a MediaStore content URI
} else {
// Get the column that contains the file name
String[] projection = { MediaStore.MediaColumns.DATA };
Cursor pathCursor =
getContentResolver().query(beamUri, projection,
null, null, null);
// Check for a valid cursor
if (pathCursor != null &&
pathCursor.moveToFirst()) {
// Get the column index in the Cursor
filenameIndex = pathCursor.getColumnIndex(
MediaStore.MediaColumns.DATA);
// Get the full file name including path
fileName = pathCursor.getString(filenameIndex);
// Create a File object for the filename
copiedFile = new File(fileName);
// Return the parent directory of the file
return new File(copiedFile.getParent());
} else {
// The query didn't work; return null
return null;
}
}
}
...更多關(guān)于從Content Provider獲取數(shù)據(jù)的知識，請參考：Retrieving Data from the Provider。
掃碼關(guān)注鍍金池微信號
手機訂課，優(yōu)惠多多