使用Retrofit上传文件

最新推荐文章于 2025-04-16 10:55:11 发布

tinyzhao

最新推荐文章于 2025-04-16 10:55:11 发布

阅读量1.6k

点赞数

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/tinyzhao/article/details/52685233

Android 同时被 2 个专栏收录

6 篇文章

订阅专栏

Java

4 篇文章

订阅专栏

本文介绍如何使用Retrofit和Multipart进行文件上传操作。通过示例代码详细展示了配置依赖、定义请求接口、构造请求参数及异步调用等步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Retrofit和RxJava系列博客：
使用Retrofit上传文件
 使用Gson解析Retrofit返回结果
 Retrofit和RxJava结合使用
 使用Retrofit和RxJava进行轮询操作

Retrofit是Square公司开发的网络请求框架，其底层封装了okhttp进行实际的网络请求操作。关于其基础用法，强烈推荐腾讯bugly社区的博文《深入浅出 Retrofit》：

http://bugly.qq.com/bbs/forum.php?mod=viewthread&tid=1117

本文将以使用Multipart方式上传图片为例，总结一下Retrofit的使用方法。

添加依赖

在build.gradle中加入依赖

compile 'com.squareup.retrofit2:retrofit:2.1.0'

定义Multipart请求接口

Multipart在http中常常用于上传文件。首先需要使用注解@Multipart，表明该接口使用Multipart方式进行请求。在接口的upload方法中，使用@Part注解定义上传的内容，这里的第一个@Part表示一个键为UserId、值为description的参数；第二个@Part表示该参数为一个MultipartBody.Part类型的文件file。

public interface FileUploadService {
        @Multipart
        @POST("EntranceGuardes/app/appOpen_pushdDataToApp.action")
        Call<ResponseBody> upload(@Part("userId") RequestBody description,
                                  @Part MultipartBody.Part file);
    }

传入文件

首先，需要构造一个FileUploadService对象service：

Retrofit retrofit = new Retrofit.Builder().baseUrl("http://172.18.81.155:8080/").build();

FileUploadService service = retrofit.create(FileUploadService.class);

接下来需要调用service的upload方法。upload方法的第一个参数是@Part("userId") RequestBody description,使用RequestBody.create方法就可以将字符串s变为RequestBody类型。值得注意的是MediaType.parse("text/plain")中使用MIME来说明上传数据的类型。

String s = "1006";

RequestBody description = RequestBody.create(MediaType.parse("text/plain"), s);

如果加入要上传的图片呢？首先需要打开图片文件，随后使用RequestBody.create创建一个RequestBody对象，然后调用MultipartBody.Part.createFormData将RequestBody对象转变为MultipartBody.Part对象。注意到这里的MIME指定为image/*，表明这部分数据是图片类型的文件。

File file = new File("/storage/sdcard/Desert.jpg");
RequestBody requestFile = RequestBody.create(MediaType.parse("image/*"), file);
MultipartBody.Part body = MultipartBody.Part.createFormData("image", file.getName(), requestFile);

异步调用

定义完成请求以后就需要调用了，retrofit和okhttp一样提供了同步调用和异步调用两种方式，常用的就是异步调用方式。异步调用只需要在enqueue方法中传入回调对象就可以了。在回调的接口中，需要实现两个方法onResponse和onFailure，分别对应中请求成功响应和请求失败两种情况。

    Call<ResponseBody> call = service.upload(description, body);

    call.enqueue(new Callback<ResponseBody>() {
        @Override
        public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
            try {
                Log.d("main", response.body().string());
                Log.d("main",Thread.currentThread().getName());                         
                } catch (IOException e) {
                    e.printStackTrace();
                    }
                }
        @Override
        public void onFailure(Call<ResponseBody> call, Throwable t) {
                    }
                });

完整代码

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

                File file = new File("/storage/sdcard/Desert.jpg");

                Retrofit retrofit = new Retrofit.Builder().baseUrl("http://172.18.81.155:8080/").build();

                FileUploadService service = retrofit.create(FileUploadService.class);

                RequestBody requestFile = RequestBody.create(MediaType.parse("image/*"), file);
                MultipartBody.Part body = MultipartBody.Part.createFormData("image", file.getName(), requestFile);

                String s = "1006";
                RequestBody description = RequestBody.create(MediaType.parse("text/plain"), s);

                Call<ResponseBody> call = service.upload(description, body);

                call.enqueue(new Callback<ResponseBody>() {
                    @Override
                    public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
                        try {
                            Log.d("main", response.body().string());
                            Log.d("main",Thread.currentThread().getName());
                        } catch (IOException e) {
                            e.printStackTrace();
                        }
                    }

                    @Override
                    public void onFailure(Call<ResponseBody> call, Throwable t) {

                    }
                });
    }

    public interface FileUploadService {
        @Multipart
        @POST("EntranceGuardes/app/appOpen_pushdDataToApp.action")
        Call<ResponseBody> upload(@Part("userId") RequestBody description,
                                  @Part MultipartBody.Part file);

    }

}