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的格式注意一下，对着图看

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再做一遍。

四.结果展示

image.png

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

image.png

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

image.png

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

image.png

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

image.png image.png

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

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