在Android平台上进行文件上传是一项常见的任务，特别是在开发移动应用时，比如用户可能需要上传照片、文档或者其他类型的数据到服务器。本示例将详细介绍如何在Android设备上实现文件上传功能。
我们需要理解Android的文件系统结构。Android使用Linux内核，因此它的文件系统类似于Linux。用户可以将文件存储在内部存储器或外部SD卡上，访问这些位置需要相应的权限。在AndroidManifest.xml文件中添加`READ_EXTERNAL_STORAGE`和`WRITE_EXTERNAL_STORAGE`权限，以便读写文件。
接下来，我们讨论网络请求。Android通常使用HttpURLConnection或第三方库如OkHttp、Retrofit来处理网络请求。HttpURLConnection是Android自带的API，而OkHttp和Retrofit提供了更简洁、高效的接口。在这个示例中，我们将重点放在使用OkHttp上，因为它易于使用且性能出色。
1. **添加依赖**：在build.gradle文件中引入OkHttp库：
```groovy
dependencies {
implementation 'com.squareup.okhttp3:okhttp:4.9.1'
}
```
2. **创建OkHttpClient实例**：OkHttpClient是一个配置网络请求的工具，它可以设置超时、重试策略等。
```java
OkHttpClient client = new OkHttpClient.Builder()
.readTimeout(60, TimeUnit.SECONDS)
.writeTimeout(60, TimeUnit.SECONDS)
.build();
```
3. **构建RequestBody对象**：RequestBody用于封装要上传的文件。这里我们用MultipartBody.Part创建一个包含文件的Part。
```java
File file = new File(filePath);
RequestBody requestBody = RequestBody.create(MediaType.parse("multipart/form-data"), file);
RequestBody fileNameBody = RequestBody.create(MediaType.parse("text/plain"), "filename");
MultipartBody.Part filePart = MultipartBody.Part.createFormData("file", file.getName(), requestBody);
```
4. **构造上传请求**：创建一个POST请求，将文件Part添加到请求体中。
```java
String uploadUrl = "https://yourserver.com/upload";
Request request = new Request.Builder()
.url(uploadUrl)
.post(filePart)
.build();
```
5. **执行请求**：使用OkHttpClient发送请求并处理响应。
```java
Call call = client.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
// 处理失败情况
}
@Override
public void onResponse(Call call, Response response) throws IOException {
if (response.isSuccessful()) {
// 处理成功情况
} else {
// 处理非2xx状态码的情况
}
}
});
```
以上步骤详细介绍了Android文件上传的基本流程。在实际应用中，还需要考虑错误处理、进度回调、多文件上传等情况。使用第三方库如Volley、Retrofit等可以使代码更加简洁，但基本原理与上述步骤类似。
注意，Android在不同版本间对于文件访问有变化，例如Android Q及更高版本引入了存储访问框架，需要通过ContentResolver访问外部存储。在编写代码时，确保考虑到兼容性问题，使用兼容库如androidx.core:core-ktx可以帮助简化这部分工作。
在处理文件上传时，还要关注用户隐私和数据安全。确保获取了必要的权限，并妥善处理敏感信息，遵循最佳实践，如使用HTTPS传输数据，避免明文存储密码等。通过以上步骤，你可以为Android应用创建一个可靠的文件上传功能。
Android手机文件上传示例.zip （1个子文件） 
Android 手机文件上传示例.rar 69KB
