From 3696c9d8e61d84e6f3a9f81fc9841b8b1f72117f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=83=A1=E5=87=AF?= <347329645@qq.com> Date: Mon, 24 Apr 2023 12:15:04 +0000 Subject: [PATCH 1/3] =?UTF-8?q?Reqwest=20=E4=B8=AD=E6=96=87=E7=AE=80?= =?UTF-8?q?=E4=BB=8B=20MD=20=E4=B8=8A=E4=BC=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 胡凯 <347329645@qq.com> --- README_zh.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 README_zh.md diff --git a/README_zh.md b/README_zh.md new file mode 100644 index 0000000..b50be41 --- /dev/null +++ b/README_zh.md @@ -0,0 +1,34 @@ +## 三方开源软件 reqwest + +### 1. Reqwest 简介 + +Reqwest 是一个 Rust 编写的第三方库,提供了一个符合人体工学的、强大的 Rust HTTP 客户端,并提供了如下功能: + +- 多种 body 可选:纯文本、JSON 格式、URL 格式、Multipart 格式 +- 可自定义的重定向策略 +- HTTP 代理配置 +- 可自选的底层 TLS 库 +- Cookie +- WASM + +Reqwest 基于 Rust 异步语义实现,具有高性能、高吞吐量等特点。 + +### 2. 引入背景简述 + +OpenHarmony 需要引入 Rust 的 HTTP 客户端能力。 + +### 3. 使用场景 + +任何 Rust 语言编写的组件且需要使用 HTTP 客户端的场景均可使用。 + +### 4. 为 OpenHarmony 带来的价值 + +借助于 Reqwest 的 HTTP 客户端功能,提高 OpenHarmony 各组件在进行 HTTP 请求交互时的吞吐量,降低时延。 + +### 5. 如何使用 + +在您的 BUILD.gn 需要的地方添加依赖即可。 + +```json + deps += [ "//third_party/rust/crate/reqwest" ] +``` \ No newline at end of file From 7457b80f7c4dc4bb22bfe4ae8b459dd3045fc89b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=83=A1=E5=87=AF?= <347329645@qq.com> Date: Fri, 5 May 2023 07:21:12 +0000 Subject: [PATCH 2/3] =?UTF-8?q?=E4=BF=AE=E6=94=B9=20README=5Fzh.md.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 胡凯 <347329645@qq.com> --- README_zh.md | 32 ++++++++++++++++++++------------ 1 file changed, 20 insertions(+), 12 deletions(-) diff --git a/README_zh.md b/README_zh.md index b50be41..3b7480c 100644 --- a/README_zh.md +++ b/README_zh.md @@ -1,6 +1,6 @@ -## 三方开源软件 reqwest +# 三方开源软件 reqwest -### 1. Reqwest 简介 +## Reqwest 简介 Reqwest 是一个 Rust 编写的第三方库,提供了一个符合人体工学的、强大的 Rust HTTP 客户端,并提供了如下功能: @@ -13,22 +13,30 @@ Reqwest 是一个 Rust 编写的第三方库,提供了一个符合人体工学 Reqwest 基于 Rust 异步语义实现,具有高性能、高吞吐量等特点。 -### 2. 引入背景简述 +## 引入背景简述 -OpenHarmony 需要引入 Rust 的 HTTP 客户端能力。 +OpenHarmony 需要引入 Rust 的 HTTP 客户端能力。借助于 Reqwest 的 HTTP 客户端功能,可以提高 OpenHarmony 各组件在进行 HTTP 请求交互时的吞吐量,并降低时延。 -### 3. 使用场景 +任何 Rust 语言编写的组件且需要使用 HTTP 客户端的场景均可使用 Reqwest 来发送 HTTP 请求。 -任何 Rust 语言编写的组件且需要使用 HTTP 客户端的场景均可使用。 - -### 4. 为 OpenHarmony 带来的价值 - -借助于 Reqwest 的 HTTP 客户端功能,提高 OpenHarmony 各组件在进行 HTTP 请求交互时的吞吐量,降低时延。 - -### 5. 如何使用 +## 如何使用 在您的 BUILD.gn 需要的地方添加依赖即可。 ```json deps += [ "//third_party/rust/crate/reqwest" ] +``` + +如果您需要使用 Cargo 的方式进行依赖,可以在自己的 Rust crate 的 Cargo.toml 下添加如下字段: + +如果您的本地环境上存在 reqwest 库,您可以使用路径依赖: +``` +[dependencies] +reqwest = { path = "(reqwest 的具体路径)" } +``` + +使用版本依赖。如果您使用该依赖方式,该三方库会在 Cargo build 时自动从 crates.io 下载。 +``` +[dependencies] +reqwest = "0.11.13" ``` \ No newline at end of file From 1cd905c128dbbf663cfaf4775de084f193c38b41 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=83=A1=E5=87=AF?= <347329645@qq.com> Date: Fri, 5 May 2023 07:28:22 +0000 Subject: [PATCH 3/3] =?UTF-8?q?=E4=BF=AE=E6=94=B9=20README=5Fzh.md.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 胡凯 <347329645@qq.com> --- README_zh.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README_zh.md b/README_zh.md index 3b7480c..0ecbe83 100644 --- a/README_zh.md +++ b/README_zh.md @@ -27,7 +27,7 @@ OpenHarmony 需要引入 Rust 的 HTTP 客户端能力。借助于 Reqwest 的 H deps += [ "//third_party/rust/crate/reqwest" ] ``` -如果您需要使用 Cargo 的方式进行依赖,可以在自己的 Rust crate 的 Cargo.toml 下添加如下字段: +如果您需要使用 Cargo 的方式进行依赖,可以在自己的 Rust 工程的 Cargo.toml 下添加如下字段: 如果您的本地环境上存在 reqwest 库,您可以使用路径依赖: ``` @@ -35,8 +35,8 @@ OpenHarmony 需要引入 Rust 的 HTTP 客户端能力。借助于 Reqwest 的 H reqwest = { path = "(reqwest 的具体路径)" } ``` -使用版本依赖。如果您使用该依赖方式,该三方库会在 Cargo build 时自动从 crates.io 下载。 +您也可以依赖 Reqwest 的具体版本。如果您使用该方式,该三方库会在您的 Rust 工程编译时自动从 crates.io 下载。 ``` [dependencies] -reqwest = "0.11.13" +reqwest = { version = "0.11.13" } ``` \ No newline at end of file