Retrofit(三)上传文件

想了想,觉得还是把自定义的东西放到最后再讲,所以讲下用Retrofit上传文件,就拿上传图片来说,因为上传图片我是想写一个专题的,包括以下:
1.上传图片操作
2.展示图片操作
3.选择图片操作

上传图片这篇讲,用Retrofit,之后我还想写一篇是用httpurlconnection的,因为用它会有个拼接的操作,只有经历过拼接才会更深刻的了解使用Http上传文件的过程。展示图片我其实已经写完了,很快就能发布。选择图片网上有很多仿微信图片选择器什么的,github上几千颗星,但是我还是想自己去造轮子,所以这个可能放在很后面。

一.创建Retrofit

前面说了使用Retrofit就要先创建Retrofit对象,我这里封装起来。

public class APIClinet {

    public static String BASE_URL = "http://xxxxxxxxxxxxxxxxxxxxx/";
    private static final int TIME_OUT = 15 * 1000;

    public static Retrofit retrofit;

    public static <T> T getInstance(Class<T> service) {
        if (retrofit == null){
            initRetrofit();
        }
        return retrofit.create(service);
    }

    private static void initRetrofit(){
        retrofit = new Retrofit.Builder()
                .baseUrl(BASE_URL)
                .client(getOkHttpClient())
                .addConverterFactory(GsonConverterFactory.create())
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .build();
    }

    private static OkHttpClient getOkHttpClient(){
        return new OkHttpClient.Builder()
                .connectTimeout(TIME_OUT, TimeUnit.MILLISECONDS)
                .addInterceptor(new HttpLoggingInterceptor().setLevel(HttpLoggingInterceptor.Level.BODY))
                .build();
    }

}

有人一看,觉得创建retrofit挺简单的,大哥,你搞笑吧。我这里只是为了赶时间而简单写的,还有自定义的操作没写呢,各种拦截器没写呢,请求头没写呢,缓存没写呢,https的操作没写呢。retrofit的内容不会这么简单,但是这样写已经可以算踏入retrofit的大门了。

代码中的操作我不多说,前一章我基本都解释过了哪些方法有哪些作用。

二.创建服务接口

public interface PhotoService {
    @Multipart
    @POST("site/post")
    Observable<ResponseBody> upload(@PartMap HashMap<String, RequestBody> params);
}
1.上传文件要用@Multipart注释和@PartMap/@Part,这个注释会帮你完成分割线的操作。
2.@PartMap与@Part,我这里虽然只传单图,却用了PartMap是因为有时候后台不光只要图,还要文档,习惯了所以这样写。
3.hashmap的格式注意一下,对着图看

《Retrofit(三)上传文件》 image.png

key是一些描述,比如这里分割线下面的那行。RequestBody是包含content – type和字节流,这个上一篇我也有讲。

三.调用地方

        byte[] bytes = out.toByteArray();

        HashMap<String, RequestBody> params = new HashMap<>();
        params.put("uploadFile\"; filename=\"test.jpg\""
                ,RequestBody.create(MediaType.parse("multipart/form-data"), bytes));

        APIClinet.getInstance(PhotoService.class)
                .upload(params)
                .subscribeOn(Schedulers.io())
                .observeOn(AndroidSchedulers.mainThread())
                .subscribe(new Action1<ResponseBody>() {
                    @Override
                    public void call(ResponseBody responseBody) {

                    }
                });

我先把文件存到一个byte[]数组中,你别管我怎么拿的,和这里的操作没关系。
然后配置请求参数HashMap<String, RequestBody>。这里我觉得有必要好好研究一下,因为这里的操作只用一行,而用httpurlconnection的话拼接会很麻烦。create方法的第二参数传我拿到的byte[]数组,当然你也可以用file,效果是一样的。
最后讲下params 的key,可以对比一下上面的图,你就会恍然大悟。

如果你不传图片而是传其它,改一下params的key和value就行。怎么样,用retrofit上传文件是不是很简单,多个文件就params.put多个对象就行,至少我觉得比其它框架少写了很多代码,但是你什么都看不出来,所以只后我会用httpurlconnection再做一遍。

四.结果展示

《Retrofit(三)上传文件》 image.png

点击选择图片进入图片选择器,我这里是用系统自带的,只能单选。

《Retrofit(三)上传文件》 image.png

选择后会把uri展示在最上边,然后我把uri转成byte[]再上传。

《Retrofit(三)上传文件》 image.png

最后得到结果,后台那里拿到图片

《Retrofit(三)上传文件》 image.png

因为我们在封装retrofit的时候加了Log拦截器,所以我们能在logcat中查看请求的过程,对比上一篇我发过的一张发送文件的http报文。

《Retrofit(三)上传文件》 image.png
《Retrofit(三)上传文件》 image.png

看下面的请求体,说明我们能拼接成发送文件请求报文的样子。这里说明一下,我的乱码那里是字节流,这里是乱码是因为我没设置编码方式。

项目地址:
https://github.com/994866755/handsomeYe.requestFile
记住,这个项目不做工具使用,只做代码演示。

    原文作者:键盘上的麒麟臂
    原文地址: https://www.jianshu.com/p/3fa830e1a729
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞