Develop -- Training(十) -- 共享文件

设置文件共享

通过 FileProvider 来设置文件共享， FileProvider 是在 v4 的支持库中的。

指定 FileProvider

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp">
    <application
        ...>
        <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="com.example.myapp.fileprovider"
            android:grantUriPermissions="true"
            android:exported="false">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/filepaths" />
        </provider>
        ...
    </application>
</manifest>

在 manifest 清单文件中添加 provider 节点元素，指定 FileProvider 类。

android:authorities 属性：指定权威的 URI 通过 FileProvider 来生成你想要的 URIs 的内容。

一般情况 android:authorities 的组成： 包名 + fileprovider 来组成的

< meta-data > 里的 android:name 属性：指向指定要共享的目录的XML文件

< meta-data > 里的 android:resource 属性：是文件的路径和名称

指定可共享目录

在 res/xml/ 目录下创建 filepaths.xml 文件

<paths>
    <files-path path="images/" name="myimages" />
</paths>

< files-path > 标签分享的目录是在应用程序的内部存储的 files/ 目录

path 属性：共享 files/ 下的 images/ 子目录

name 属性：告诉 FileProvider 在 files/images/ 子目录下添加路径段 myimages 内容的URI中的文件

注意： XML 文件是唯一可以指定要共享的目录，不能以编程方式添加目录。

content://com.example.myapp.fileprovider/myimages/default_image.jpg

共享文件（相当于服务器端）

通过 startActivityForResult（） 中的 intent 包含着 ACTION_PICK 来传递数据。

设置一个可以选择的 Activity，意图过滤器要匹配 ACTION_PICK，类别是 CATEGORY_DEFAULT 和 CATEGORY_OPENABLE，也可以选择指定 MIME Type。

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    ...
        <application>
        ...
            <activity
                android:name=".FileSelectActivity"
                android:label="@"File Selector" >
                <intent-filter>
                    <action
                        android:name="android.intent.action.PICK"/>
                    <category
                        android:name="android.intent.category.DEFAULT"/>
                    <category
                        android:name="android.intent.category.OPENABLE"/>
                    <data android:mimeType="text/plain"/>
                    <data android:mimeType="image/*"/>
                </intent-filter>
            </activity>

定义选择 Activity 的返回 code

public class MainActivity extends Activity {
    // The path to the root of this app's internal storage
    private File mPrivateRootDir;
    // The path to the "images" subdirectory
    private File mImagesDir;
    // Array of files in the images subdirectory
    File[] mImageFiles;
    // Array of filenames corresponding to mImageFiles
    String[] mImageFilenames;
    // Initialize the Activity
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        ...
        // Set up an Intent to send back to apps that request a file
        mResultIntent =
                new Intent("com.example.myapp.ACTION_RETURN_FILE");
        // Get the files/ subdirectory of internal storage
        mPrivateRootDir = getFilesDir();
        // Get the files/images subdirectory;
        mImagesDir = new File(mPrivateRootDir, "images");
        // Get the files in the images subdirectory
        mImageFiles = mImagesDir.listFiles();
        // Set the Activity's result to null to begin with
        setResult(Activity.RESULT_CANCELED, null);
        /*
         * Display the file names in the ListView mFileListView.
         * Back the ListView with the array mImageFilenames, which
         * you can create by iterating through mImageFiles and
         * calling File.getAbsolutePath() for each File
         */
         ...
    }
    ...
}

当你访问客户端程序的共享文件时，需要授予权限。这个权限是暂时的，当接收应用程序的任务堆栈完成后自动失效。

 // 临时授予读取权限到内容URI 
 mResultIntent.addFlags （Intent.FLAG_GRANT_READ_URI_PERMISSION ）; 

注意：调用setFlags（）是安全地访问权限授予使用临时访问权限文件的唯一途径。避免调用 Context.grantUriPermission（）的文件的内容URI的方法，因为这种方法授予访问，你只能通过调用撤销Context.revokeUriPermission（） 。

请求共享文件（相当于客户端）

通过 startActivityForResult（） 来请求，然后通过 onActivityResult（）来处理请求结果。

public  class  MainActivity  extends  Activity  { 
    private  Intent mRequestFileIntent ; 
    private  ParcelFileDescriptor mInputPFD ; 
    ... 
    @Override 
    protected  void onCreate ( Bundle savedInstanceState )  { 
        super . onCreate ( savedInstanceState ); 
        setContentView ( R . layout . activity_main ); 
        mRequestFileIntent =  new  Intent ( Intent . ACTION_PICK ); 
        mRequestFileIntent . setType ( "image/jpg" ); 
        ... 
    } 
    ... 
    protected  void requestFile ()  { 
        /** 
         *当用户请求一个文件时，发送意向到
         *服务器应用程序。
         *文件。
         * / 
            startActivityForResult （mRequestFileIntent ， 0 ）; 
        ... 
    } 
    ... 
}

 @Override
    public void onActivityResult(int requestCode, int resultCode,
            Intent returnIntent) {
        // If the selection didn't work
        if (resultCode != RESULT_OK) {
            // Exit without doing anything else
            return;
        } else {
            // Get the file's content URI from the incoming Intent
            Uri returnUri = returnIntent.getData();
            /*
             * Try to open the file for "read" access using the
             * returned URI. If the file isn't found, write to the
             * error log and return.
             */
            try {
                /*
                 * Get the content resolver instance for this context, and use it
                 * to get a ParcelFileDescriptor for the file.
                 */
                mInputPFD = getContentResolver().openFileDescriptor(returnUri, "r");
            } catch (FileNotFoundException e) {
                e.printStackTrace();
                Log.e("MainActivity", "File not found.");
                return;
            }
            // Get a regular file descriptor for the file
            FileDescriptor fd = mInputPFD.getFileDescriptor();
            ...
        }
    }

该方法openFileDescriptor（） 返回一个ParcelFileDescriptor该文件。从这个对象，客户端应用程序获取一个的FileDescriptor对象，它可以再使用读取文件。

获取文件信息

判断文件的 MIME Type 类型

    /*
     * Get the file's content URI from the incoming Intent, then
     * get the file's MIME type
     */
    Uri returnUri = returnIntent.getData();
    String mimeType = getContentResolver().getType(returnUri);

查询文件的名称和大小， FileProvider 有个 query（） 可以查询出文件的相关信息。
DISPLAY_NAME：返回 String 类型。文件名称。
SIZE：返回 Long 类型。文件大小。

 /*
     * Get the file's content URI from the incoming Intent,
     * then query the server app to get the file's display name
     * and size.
     */
    Uri returnUri = returnIntent.getData();
    Cursor returnCursor =
            getContentResolver().query(returnUri, null, null, null, null);
    /*
     * Get the column indexes of the data in the Cursor,
     * move to the first row in the Cursor, get the data,
     * and display it.
     */
    int nameIndex = returnCursor.getColumnIndex(OpenableColumns.DISPLAY_NAME);
    int sizeIndex = returnCursor.getColumnIndex(OpenableColumns.SIZE);
    returnCursor.moveToFirst();
    TextView nameView = (TextView) findViewById(R.id.filename_text);
    TextView sizeView = (TextView) findViewById(R.id.filesize_text);
    nameView.setText(returnCursor.getString(nameIndex));
    sizeView.setText(Long.toString(returnCursor.getLong(sizeIndex)));