鸿蒙NEXT使用request模块实现本地文件上传
大家好，我是 V 哥。在鸿蒙 NEXT API 12 中，可以使用 ohos.request 模块提供的上传接口将本地文件上传到服务器。自定义代理设置可以通过 request.agent.create 接口来实现，从而指定代理服务器的地址。下面是一个详细的案例代码，演示了如何使用自定义代理上传本地文件。整理好的学习笔记，分享给大家。
示例代码
import { request } from '@ohos.request';
import { Log } from '@ohos.logger';
import fs from '@ohos.fileSystem';
export default {
data: {
localFilePath: '/data/files/example.txt', // 需要上传的文件路径
serverUrl: 'https://example.com/upload', // 上传文件的服务器URL
proxyUrl: 'http://proxy.example.com:8080', // 自定义代理地址
},
onInit() {
// 在组件初始化时，触发上传文件的操作
this.uploadFileWithProxy();
},
async uploadFileWithProxy() {
try {
// 创建代理代理服务
const agent = await request.agent.create({
proxy: this.proxyUrl, // 设置自定义代理地址
});
Log.info('Custom proxy agent created successfully.');
// 读取本地文件
const fileData = await this.readFile(this.data.localFilePath);
if (!fileData) {
Log.error('Failed to read local file.');
return;
}
// 准备上传请求的参数
const options = {
url: this.data.serverUrl, // 目标上传URL
method: 'POST', // HTTP方法为POST
headers: {
'Content-Type': 'multipart/form-data', // 设置请求头
},
data: {
file: fileData, // 上传的文件内容
},
agent, // 使用代理
};
// 发起文件上传请求
const response = await request.upload(options);
if (response && response.status === 200) {
Log.info('File uploaded successfully: ' + JSON.stringify(response));
} else {
Log.error('File upload failed: ' + JSON.stringify(response));
}
} catch (error) {
Log.error('Error during file upload: ' + error.message);
}
},
// 读取本地文件内容的函数
async readFile(filePath: string) {
try {
// 读取本地文件
const fileStats = await fs.stat(filePath);
if (!fileStats || !fileStats.isFile) {
return null; // 文件不存在或不是一个文件
}
const fileData = await fs.readFile(filePath);
return fileData;
} catch (error) {
Log.error('Error reading file: ' + error.message);
return null;
}
},
};解释：
- 代理服务创建 (request.agent.create)：
- 在 uploadFileWithProxy 函数中，我们使用 request.agent.create 创建了一个自定义代理服务，代理地址由 proxyUrl 提供。
- 该服务用于通过代理上传文件。
- 读取本地文件：
- readFile 函数读取本地文件内容。在这个示例中，我们假设上传的是一个文本文件。
- 使用 fs.stat 检查文件是否存在，fs.readFile 获取文件内容。
- 上传文件：
- 使用 request.upload 发起文件上传请求，并且指定代理。
- options 中的 url 为目标上传地址，method 为 HTTP 请求方法（在此为 POST）。
- 上传文件的数据作为 data 部分传递给服务器。
- 日志：
- 使用 Log 模块打印上传过程的相关日志信息，帮助调试和监控。
需要注意：
- request.upload 方法是鸿蒙系统提供的用于上传文件的接口。确保传递正确的 options，包括文件内容、上传URL等。
- 代理的地址通过 request.agent.create 设置，可以为HTTP请求指定一个中间代理服务器，尤其在网络受限或者有特殊需求时非常有用。
- 需要正确配置服务器端接收文件的接口（如 POST 方法和表单数据处理）。
- 将需要上传的文件路径替换为你本地实际存在的文件路径（如 /data/files/example.txt）。
- 确保服务器端能够处理来自代理服务器的上传请求。
- 使用合适的 proxyUrl 进行自定义代理。
此示例提供了一个基础框架，你可以根据实际需求扩展或修改功能，感谢支持，关注威哥爱编程，一起学鸿蒙开发。