纠结了好久的文件上传与下载功能,最近终于完美解决。心路历程简直不想提了,说多了都是泪。可能也是自己的知识掌握还不够吧,毕竟,很少做android方面的。

其实,在网上也找了很多关于这方面的资料,但是,可能和我理解的有些出入,项目中也是不能够很好的应用,导致花费了大量的时间。所以,有必要记录一下,怎么说呢?就是希望我踩过的坑能给大家一些帮助。

我自己的项目实例也是结合网上的一些资料,然后运用到自己的项目中的,其实我们需要注意的就是一些细节的地方,今天就先讲关于OKhttp实现文件上传:

咱们还是先看效果再继续往下说:

Android OkGo上传多文件 okhttp上传_文件传参

如果对效果还算是比较满意,那我们继续往下看,东西不多,就是要注意细节咯!

1. xml布局

相信这个就不用我多说了,我的布局也很简单,看到上面的图估计就能猜到。这里就不把代码贴出来了,简单说一下,两个文本框(界面上的 “文献综述内容” 和 “附件”),两个编辑框(就是你看到的两个输入框),两个按钮(选择文件的 “浏览”和 “确定”),轻松搞定。

还有就是读取文件的权限不要忘了。

2. activity中的实现

看到布局之后,想必操作你也是了然于胸了吧,我们需要给 “浏览” 这个按钮设置点击事件的监听,点击它后,需要打开我们的文件夹:

//打开文件选择器
    private void showFileChooser() {
        Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
        // 设置你要打开的文件type
        intent.setType("application/*");
        intent.addCategory(Intent.CATEGORY_OPENABLE);
        startActivityForResult(intent, 1);
    }

对于,你要设置的setType,可以看看这个参考手册,我这里主要是为了选择文本类的文件,所以我才这么设置的,如果你支持所有类型,也可以改为  intent.setType( "*/*" ),这个看你自己的需要了。

然后,在它的后面别忘了:

@Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        Log.w(TAG,"返回的数据:"+data);
        if (resultCode == Activity.RESULT_OK) {
            Uri uri = data.getData();
            //使用第三方应用打开
            if ("file".equalsIgnoreCase(uri.getScheme())){
                path = uri.getPath();
                file = new File(path);
                uploadfile = file.getName();
                mc_annex.setText(uploadfile);
                Log.w(TAG,"getName==="+uploadfile);
                Toast.makeText(this,path+"11111",Toast.LENGTH_SHORT).show();
                return;
            }
            //4.4以后
            if (Build.VERSION.SDK_INT > Build.VERSION_CODES.KITKAT) {
                // 获取文件路径  
                path = getPath(this, uri);
                Log.w(TAG,path);
                file = new File(path);
                // 获得文件名
                uploadfile = file.getName();
                // 这里是为了选中文件后,编辑框内容变成我选中的文件名
                // 直接 mc_annex.setText(file.getName()); 也行
                mc_annex.setText(uploadfile);
                Log.w(TAG,"getName==="+uploadfile);
                Toast.makeText(this,path,Toast.LENGTH_SHORT).show();
            } else {//4.4以下下系统调用方法
                path = getRealPathFromURI(this,uri);
                Log.w(TAG,path);
                Toast.makeText(StudentMiddleCheckEditActivity.this, path+"222222", Toast.LENGTH_SHORT).show();
            }
        }

    }

对了,别忘了定义变量,我是在一开始就定义了,所以,这里没有。然后,uploadfile单纯的就是为了得到文件的名字,因为我后面调接口的时候需要把文件名传过去。

private String path,uploadfile;
private File file;

3. FileUtils 封装类

之前,我们能够很明显看到getPath(this, uri)的方法,那么这个方法是封装在哪呢?

我自己遇到的问题是什么,选中文件之后就报这样的错误:

E/AndroidRuntime: FATAL EXCEPTION: main
    Process: com.will.manage_system, PID: 22879
    java.lang.RuntimeException: Failure delivering result ResultInfo{who=null, request=1, result=-1, data=Intent { dat=content://com.android.providers.downloads.documents/document/raw:/storage/emulated/0/Download/会议记录9-12月.doc flg=0x1 }} to activity {com.will.manage_system/com.manage_system.ui.manage.activity.student.StudentMiddleCheckActivity}: java.lang.NumberFormatException: For input string: "raw:/storage/emulated/0/Download/会议记录9-12月.doc"
        at android.app.ActivityThread.deliverResults(ActivityThread.java:4360)
        at android.app.ActivityThread.handleSendResult(ActivityThread.java:4402)
        at android.app.servertransaction.ActivityResultItem.execute(ActivityResultItem.java:49)
        at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:108)
        at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:68)
        at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1808)
        at android.os.Handler.dispatchMessage(Handler.java:106)
        at android.os.Looper.loop(Looper.java:193)
        at android.app.ActivityThread.main(ActivityThread.java:6669)
        at java.lang.reflect.Method.invoke(Native Method)
        at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:493)
        at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:858)
     Caused by: java.lang.NumberFormatException: For input string: "raw:/storage/emulated/0/Download/会议记录9-12月.doc"
        at java.lang.Long.parseLong(Long.java:594)
        at java.lang.Long.valueOf(Long.java:808)
        at com.manage_system.utils.FileUtils.getPath(FileUtils.java:109)
        at com.manage_system.ui.manage.activity.student.StudentMiddleCheckActivity.onActivityResult(StudentMiddleCheckActivity.java:293)
        at android.app.Activity.dispatchActivityResult(Activity.java:7454)
        at android.app.ActivityThread.deliverResults(ActivityThread.java:4353)
        at android.app.ActivityThread.handleSendResult(ActivityThread.java:4402) 
        at android.app.servertransaction.ActivityResultItem.execute(ActivityResultItem.java:49) 
        at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:108) 
        at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:68) 
        at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1808) 
        at android.os.Handler.dispatchMessage(Handler.java:106) 
        at android.os.Looper.loop(Looper.java:193) 
        at android.app.ActivityThread.main(ActivityThread.java:6669) 
        at java.lang.reflect.Method.invoke(Native Method) 
        at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:493) 
        at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:858)

喏,再截个图: 

Android OkGo上传多文件 okhttp上传_Android OkGo上传多文件_02

但是,选择系统自带的文件是没有问题的,最后发现传过去的字段不符,其实也就加了一下几行代码:

if (id != null && id.startsWith("raw:")) {
     return id.substring(4);
}

好吧,直接把我改完之后的代码放上来:

package com.manage_system.utils;

import android.annotation.SuppressLint;
import android.content.ContentUris;
import android.content.Context;
import android.database.Cursor;
import android.net.Uri;
import android.os.Build;
import android.os.Environment;
import android.provider.DocumentsContract;
import android.provider.MediaStore;
import android.util.Log;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;


public class FileUtils {
    private static String TAG = "FileUtils";


    /**
     * 专为Android4.4设计的从Uri获取文件绝对路径,以前的方法已不好使
     */
    @SuppressLint("NewApi")
    public static String getPath(final Context context, final Uri uri) {

        final boolean isKitKat = Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT;

        // DocumentProvider
        if (isKitKat && DocumentsContract.isDocumentUri(context, uri)) {
            // ExternalStorageProvider
            if (isExternalStorageDocument(uri)) {
                final String docId = DocumentsContract.getDocumentId(uri);
                final String[] split = docId.split(":");
                final String type = split[0];

                if ("primary".equalsIgnoreCase(type)) {
                    return Environment.getExternalStorageDirectory() + "/" + split[1];
                }
            }
            // DownloadsProvider
            else if (isDownloadsDocument(uri)) {

                final String id = DocumentsContract.getDocumentId(uri);
                if (id != null && id.startsWith("raw:")) {
                    return id.substring(4);
                }

                final Uri contentUri = ContentUris.withAppendedId(
                        Uri.parse("content://downloads/public_downloads"), Long.valueOf(id));
                Log.w(TAG,contentUri+"");

                return getDataColumn(context, contentUri, null, null);
            }
            // MediaProvider
            else if (isMediaDocument(uri)) {
                final String docId = DocumentsContract.getDocumentId(uri);
                final String[] split = docId.split(":");
                final String type = split[0];
                Log.w(TAG,docId);
                Log.w(TAG,type);

                Uri contentUri = null;

                if ("image".equals(type)) {
                    contentUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
                } else if ("video".equals(type)) {
                    contentUri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI;
                } else if ("audio".equals(type)) {
                    contentUri = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI;
                }
                Log.e(TAG,"isMediaDocument");

                final String selection = "_id=?";
                final String[] selectionArgs = new String[]{split[1]};

                return getDataColumn(context, contentUri, selection, selectionArgs);
            }
        }
        // MediaStore (and general)
        else if ("content".equalsIgnoreCase(uri.getScheme())) {
            Log.e(TAG,"content");
            return getDataColumn(context, uri, null, null);
        }
        // File
        else if ("file".equalsIgnoreCase(uri.getScheme())) {
            Log.e(TAG,"file");
            return uri.getPath();
        }
        return null;
    }

    /**
     * Get the value of the data column for this Uri. This is useful for
     * MediaStore Uris, and other file-based ContentProviders.
     *
     * @param context       The context.
     * @param uri           The Uri to query.
     * @param selection     (Optional) Filter used in the query.
     * @param selectionArgs (Optional) Selection arguments used in the query.
     * @return The value of the _data column, which is typically a file path.
     */
    public static String getDataColumn(Context context, Uri uri, String selection,
                                String[] selectionArgs) {

        Cursor cursor = null;
        Log.w(TAG,"hh:"+uri);
        final String column = "_data";
        final String[] projection = {column};

        try {
            cursor = context.getContentResolver().query(uri, projection, selection, selectionArgs,
                    null);
            Log.w(TAG,"hh1:"+cursor);
            if (cursor != null && cursor.moveToFirst()) {
                final int column_index = cursor.getColumnIndexOrThrow(column);
                return cursor.getString(column_index);
            }
        } finally {
            if (cursor != null)
                cursor.close();
        }
        return null;
    }

    public static String getRealPathFromURI(Context context,Uri contentUri) {
        String res = null;
        String[] proj = { MediaStore.Images.Media.DATA };
        Cursor cursor = context.getContentResolver().query(contentUri, proj, null, null, null);
        if(null!=cursor&&cursor.moveToFirst()){
            int column_index = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA);
            res = cursor.getString(column_index);
            cursor.close();
        }
        return res;
    }

    /**
     * @param uri The Uri to check.
     * @return Whether the Uri authority is ExternalStorageProvider.
     */
    public static boolean isExternalStorageDocument(Uri uri) {
        return "com.android.externalstorage.documents".equals(uri.getAuthority());
    }

    /**
     * @param uri The Uri to check.
     * @return Whether the Uri authority is DownloadsProvider.
     */
    public static boolean isDownloadsDocument(Uri uri) {
        return "com.android.providers.downloads.documents".equals(uri.getAuthority());
    }

    /**
     * @param uri The Uri to check.
     * @return Whether the Uri authority is MediaProvider.
     */
    public static boolean isMediaDocument(Uri uri) {
        return "com.android.providers.media.documents".equals(uri.getAuthority());
    }

}

4. OKhttp 带文件传参

在OkManager里封装了一个方法:

public static void postFile(String url, RequestBody requestBody ,okhttp3.Callback callback)
    {
        OkHttpClient client = new OkHttpClient().newBuilder().connectTimeout(60000, TimeUnit.MILLISECONDS)
                .readTimeout(60000, TimeUnit.MILLISECONDS)
                .build();

        // 取到我存放在SharedPreferences 的token
        SharedPreferences sp=MyApp.getAppContext().getSharedPreferences("loginInfo", MODE_PRIVATE);
        Request request = new Request.Builder()
                .header("token",sp.getString("token" , ""))
                .url(url)
                .post(requestBody)
                .build();
        client.newCall(request).enqueue(callback);
    }

第一个client的时间设置,想必有看我之前这篇博文的小伙伴知道,是为了防止我们客户端不能及时响应服务器的数据,当然,不设置也是没啥问题的,只是说如果后台数据量过大,而我们又不能及时处理,可能会存在报错超时的情况。

而我自己将token存放在SharedPreferences里,也是为了添加header,因为自己项目的需要,用户登录成功之后,服务器会返回一个token,请求数据的时候需要将token放到请求头上,所以就是你上面看到的样子。当然了,关于这块,后面我们再详讲。

最后,说一下,requestBody,我把这个参数传进来的原因,是因为我需要在不同的地方调用。

哈哈,去掉了之后的简化版:

public static void postFile(String url, RequestBody requestBody ,okhttp3.Callback callback)
    {
        OkHttpClient client = new OkHttpClient();

        Request request = new Request.Builder()
                .url(url)
                .post(requestBody)
                .build();
        client.newCall(request).enqueue(callback);
    }

总之,一句话,看你自己的需求。

那具体是怎么调用呢?如下:

OkManager manager = OkManager.getInstance();
RequestBody requestBody = new MultipartBody.Builder()
                    .setType(MultipartBody.FORM)
                    .addFormDataPart("intro", intro) // 提交内容字段
                    .addFormDataPart("uploadfile", uploadfile, RequestBody.create(MediaType.parse("*/*"), file)) // 第一个参数传到服务器的字段名,第二个你自己的文件名,第三个MediaType.parse("*/*")和我们之前说的那个type其实是一样的
                    .build();
manager.postFile(url, requestBody,new okhttp3.Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                Log.e(TAG, "onFailure: ",e);
            }
            @Override
            public void onResponse(Call call, Response response) throws IOException {
                final String responseBody = response.body().string();
                final JSONObject obj = JSON.parseObject(responseBody);
                Log.e(TAG,obj.toString());
                runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        // 对返回结果进行操作
                    }
                });

            }
        });

对了,看到这我想起来,在OkManager里面还定义了一个获取对象的方法:

//采用单例模式获取对象
    public static OkManager getInstance() {
        OkManager instance = null;
        if (manager == null) {
            synchronized (OkManager.class) {                //同步代码块
                if (instance == null) {
                    instance = new OkManager();
                    manager = instance;
                }
            }
        }
        return instance;
    }

至此,文件上传应该是没什么问题了。