Android中如何利用Retrofit2实现多文件上传
Android中如何利用Retrofit2实现多文件上传
这篇文章主要讲解了“Android中如何利用Retrofit2实现多文件上传”，文中的讲解内容简单清晰，易于学习与理解，下面请大家跟着小编的思路慢慢深入，一起来研究和学习“Android中如何利用Retrofit2实现多文件上传”吧！
1.实验效果
Server端接收到的图片
2. Server端实战
Server端负责接收保存客户端上传来的图片并提供访问图片的能力，Server有很多技术可以实现，Python作为一门具有强大的第三方库的语言，拥有很多web服务框架，如Flask,Django等。笔者采用Flask框架，Flask是微框架，实现小型功能十分方便，笔者实现的多文件上传功能，程序不超过30行。
下面具体来看看。
2.1 环境安装
笔者使用的Python版本为3.4，可以去 Python3.4下载 选择下载适合自己系统的版本。完整安装Python教程请自行搜索。
Python安装完成后需要安装Server端程序依赖库。通过pip安装：
pipinstallFlaskpipinstallwerkzeug
2.2 程序实现
首先要引入依赖库：
fromflaskimportFlask,request,send_from_directory,jsonifyimportosfromwerkzeugimportsecure_filename
本实验需要上传文件，需要将所上传文件的文件类型以及文件名做出限制，防止某些破坏服务器的程序运行，另外有些非法文件名如：
filename = "../../../../home/username/.bashrc"
如果黑客们能够操作这样的文件，对服务器系统来说，将是致命打击。所以werkzeug提供了secure_filename对上传文件的文件名进行合法校验。
判断文件后缀是否合法
ALLOWED_EXTENSIONS=set(['png','jpg','jpeg','gif'])defallowed_file(filename):return'.'infilenameandfilename.rsplit('.',1)[1]inALLOWED_EXTENSIONS
接收上传文件的函数代码如下：
@app.route('/upload',methods=['POST'])defupload_file():ifrequest.method=='POST':forkinrequest.files:file=request.files[k]image_urls=[]iffileandallowed_file(file.filename):filename=secure_filename(file.filename)file.save(os.path.join(app.config['IMAGE_FOLDER'],filename))image_urls.append("images/%s"%filename)returnjsonify({"code":1,"image_urls":image_urls})
Flask支持GET,POST,PUT,DELETE等HTTP请求方式，使用装饰器进行修饰，类似于Java中的注解概念，/upload为客户端请求的相对地址，请求方式限制为POST.根据request内置对象，可以访问客户端发来的文件，将文件检查后保存在本地，其中image_urls为上传后的图片的相对地址数组。***将图片的地址以json格式返回给客户端。
完整的Server端代码如下：
fromflaskimportFlask,request,send_from_directory,jsonifyimportosfromwerkzeugimportsecure_filenameapp=Flask(__name__)app.config['IMAGE_FOLDER']=os.path.abspath('.')+'\\images\\'ALLOWED_EXTENSIONS=set(['png','jpg','jpeg','gif'])defallowed_file(filename):return'.'infilenameandfilename.rsplit('.',1)[1]inALLOWED_EXTENSIONS@app.route('/upload',methods=['POST'])defupload_file():ifrequest.method=='POST':forkinrequest.files:file=request.files[k]print(file)image_urls=[]iffileandallowed_file(file.filename):filename=secure_filename(file.filename)file.save(os.path.join(app.config['IMAGE_FOLDER'],filename))image_urls.append("images/%s"%filename)returnjsonify({"code":1,"image_urls":image_urls})#让文件映射访问，否则默认只能访问static文件夹中的文件@app.route("/images/<imgname>",methods=['GET'])defimages(imgname):returnsend_from_directory(app.config['IMAGE_FOLDER'],imgname)if__name__=="__main__":#检测IMAGE_FOLDER是否存在ifnotos.path.exists(app.config['IMAGE_FOLDER']):os.mkdir(app.config['IMAGE_FOLDER'])app.run("192.168.1.102",debug=True)
这里有一个小技巧，写完Server端代码后可以使用Postman进行测试，测试成功后再进行客户端程序开发。
3. 客户端开发
因为涉及文件的上传，笔者这里以图片为例进行上传实验，图片上传除了重头戏Retrofit之外，还需要选择图片，笔者这里推荐一个模仿微信的图片选择库 ImagePicker .
3.1 添加依赖库
图片加载库笔者喜欢使用Glide
compile'com.squareup.retrofit2:retrofit:2.1.0'compile'com.squareup.retrofit2:converter-gson:2.1.0'compile'com.github.bumptech.glide:glide:3.7.0'compile'com.lzy.widget:imagepicker:0.4.1'
3.2 程序实现
如果没有接触过Retrofit 2，可以来我的博客Retrofit教程 了解。
Retrofit2 是一个支持RESTful API的请求库，实际上只是对API请求方式的封装，真正的网络请求由OkHttp发出。
Retrofit2一般会定义一个ServiceGenerator类，用于动态生成Retrofit对象。
publicclassServiceGenerator{publicstaticfinalStringAPI_BASE_URL="http://192.168.1.102:5000/";privatestaticOkHttpClient.BuilderhttpClient=newOkHttpClient.Builder();privatestaticRetrofit.Builderbuilder=newRetrofit.Builder().baseUrl(API_BASE_URL).addConverterFactory(GsonConverterFactory.create());publicstatic<S>ScreateService(Class<S>serviceClass){Retrofitretrofit=builder.client(httpClient.build()).build();returnretrofit.create(serviceClass);}}
具体的API操作由FlaskClient接口操作，
publicinterfaceFlaskClient{//上传图片@Multipart@POST("/upload")Call<UploadResult>uploadMultipleFiles(@PartMapMap<String,RequestBody>files);}
上传文件需要使用@Multipart关键字注解，@POST表明HTTP请求方式为POST,/upload为请求服务器的相对地址，uploadMultipleFiles是自定义的方法名，参数为Map<String,RequestBody> files即多个文件组成的Map对象，@PartMap表明这是多文件上传，如果单文件可以使用@Part MultipartBody.Part file,方法的返回类型默认为Response,由于我们已经开发了Server端，所以知道Server端的返回数据格式为Json，因此我们针对返回数据格式新建一个UploadResut类。
publicclassUploadResult{publicintcode;//1publicList<String>image_urls;}
界面布局如图所示：
点击Upload按钮后执行上传操作，核心的方法：
publicvoiduploadFiles(){if(imagesList.size()==0){Toast.makeText(MainActivity.this,"不能不选择图片",Toast.LENGTH_SHORT).show();return;}Map<String,RequestBody>files=newHashMap<>();finalFlaskClientservice=ServiceGenerator.createService(FlaskClient.class);for(inti=0;i<imagesList.size();i++){Filefile=newFile(imagesList.get(i).path);files.put("file"+i+"\";filename=\""+file.getName(),RequestBody.create(MediaType.parse(imagesList.get(i).mimeType),file));}Call<UploadResult>call=service.uploadMultipleFiles(files);call.enqueue(newCallback<UploadResult>(){@OverridepublicvoidonResponse(Call<UploadResult>call,Response<UploadResult>response){if(response.isSuccessful()&&response.body().code==1){Toast.makeText(MainActivity.this,"上传成功",Toast.LENGTH_SHORT).show();Log.i("orzangleli","---------------------上传成功-----------------------");Log.i("orzangleli","基础地址为："+ServiceGenerator.API_BASE_URL);Log.i("orzangleli","图片相对地址为："+listToString(response.body().image_urls,','));Log.i("orzangleli","---------------------END-----------------------");}}@OverridepublicvoidonFailure(Call<UploadResult>call,Throwablet){Toast.makeText(MainActivity.this,"上传失败",Toast.LENGTH_SHORT).show();}});}
其中构建上传多文件的方法的参数较为关键，MediaType.parse(imagesList.get(i).mimeType)获取图片的mimeType，如果指定错误，可能会导致上传失败。
Map<String,RequestBody>files=newHashMap<>();finalFlaskClientservice=ServiceGenerator.createService(FlaskClient.class);for(inti=0;i<imagesList.size();i++){Filefile=newFile(imagesList.get(i).path);files.put("file"+i+"\";filename=\""+file.getName(),RequestBody.create(MediaType.parse(imagesList.get(i).mimeType),file));}
集成Callback借口的匿名回调类的onResponse方法的第二个参数为服务器响应，通过访问body()方法返回UploadResult类型对象，接着就可以通过组合ServiceGenerator.API_BASE_URL和response.body().image_urls中每一项访问上传完成的图片。
感谢各位的阅读，以上就是“Android中如何利用Retrofit2实现多文件上传”的内容了，经过本文的学习后，相信大家对Android中如何利用Retrofit2实现多文件上传这一问题有了更深刻的体会，具体使用情况还需要大家实践验证。这里是恰卡编程网，小编将为大家推送更多相关知识点的文章，欢迎关注！
