Android发送form-data请求实现文件上传

对于 Android 开发者来说，实现文件上传是一个常见的需求。本文将介绍如何使用 form-data 请求方式实现文件上传。

流程概览

下面是实现文件上传的整个流程：

步骤 描述
1 创建一个包含文件选择功能的界面
2 选择要上传的文件
3 将文件转换为 MultipartBody.Part 对象
4 创建一个 Retrofit 实例
5 定义一个用于上传文件的 API 接口
6 发起文件上传请求
7 处理上传结果

接下来，我们将逐步介绍每个步骤需要做什么，以及相应的代码实现。

步骤一：创建文件选择界面

首先，需要创建一个界面，用于选择要上传的文件。可以使用 Intent 和 startActivityForResult() 方法启动系统的文件选择器。

private static final int REQUEST_CODE = 1;

// 启动文件选择器
private void selectFile() {
    Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
    intent.setType("*/*");
    startActivityForResult(intent, REQUEST_CODE);
}

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    
    if (requestCode == REQUEST_CODE && resultCode == RESULT_OK) {
        // 处理选择的文件
        Uri fileUri = data.getData();
        String filePath = FileUtils.getPath(this, fileUri); // 获取文件路径
        // 继续下一步
        uploadFile(filePath);
    }
}

步骤二：选择要上传的文件

在 onActivityResult() 方法中，我们通过获取选择的文件的路径。

String filePath = FileUtils.getPath(this, fileUri); // 获取文件路径

步骤三：转换文件为 MultipartBody.Part 对象

MultipartBody.Part 对象是 Retrofit 用于上传文件的关键对象，我们需要将文件转换为这个对象。

private MultipartBody.Part prepareFilePart(String partName, String filePath) {
    File file = new File(filePath);
    RequestBody requestFile = RequestBody.create(MediaType.parse("multipart/form-data"), file);
    return MultipartBody.Part.createFormData(partName, file.getName(), requestFile);
}

步骤四：创建 Retrofit 实例

在进行文件上传之前，我们需要创建一个 Retrofit 实例，用于发起网络请求。

Retrofit retrofit = new Retrofit.Builder()
    .baseUrl(BASE_URL)
    .addConverterFactory(GsonConverterFactory.create())
    .build();

步骤五：定义上传文件的 API 接口

在 Retrofit 中，我们可以使用注解来定义 API 接口。

public interface FileUploadService {
    @Multipart
    @POST("upload")
    Call<ResponseBody> uploadFile(@Part MultipartBody.Part file);
}

步骤六：发起文件上传请求

接下来，我们通过 Retrofit 创建的 API 接口来发起文件上传请求。

FileUploadService service = retrofit.create(FileUploadService.class);
Call<ResponseBody> call = service.uploadFile(filePart);
call.enqueue(new Callback<ResponseBody>() {
    @Override
    public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
        if (response.isSuccessful()) {
            // 文件上传成功
        } else {
            // 文件上传失败
        }
    }
    
    @Override
    public void onFailure(Call<ResponseBody> call, Throwable t) {
        // 文件上传失败
    }
});

步骤七：处理上传结果

最后，在请求完成后，我们可以根据响应结果来处理上传结果。

@Override
public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
    if (response.isSuccessful()) {
        // 文件上传成功
    } else {
        // 文件上传失败
    }
}

@Override
public void onFailure(Call<ResponseBody> call, Throwable t) {
    // 文件上传失败
}

以上就是实现 Android 发送 form-data 请求实现文件上传的整个流程和代码示例。希望能帮助到刚入行的开发者。