add download docx and pdf

Author: litongjava

docs/zh/05_web开发/03.md

@@ -1,4 +1,4 @@
-# 文件
+# 文件上传
 
 ### 接收文件
 
@@ -90,4 +90,4 @@ InputType 是 from 中的一个参数,可以省略
 2. `test_zip` 方法:
    - 映射到 `/test.zip` URL 路径。
    - 首先，使用 `request.httpConfig.getPageRoot` 获取服务器的根目录。
-   - 然后，使用 `Resps.file` 创建 `HttpResponse` 对象，返回位于根目录下 "test/test.zip" 路径的文件。
+   - 然后，使用 `Resps.file` 创建 `HttpResponse` 对象，返回位于根目录下 "test/test.zip" 路径的文件。

docs/zh/05_web开发/11.md

@@ -1,9 +1,140 @@
-# 返回图片
+# 文件下载
 
-#### 返回验证码
-用到了hutool依赖,请自行添加
+### 下载文档
+
+用于说明如何在 Java 后端应用程序中实现 PDF 和 DOCX 文件的下载功能
+
+#### 环境依赖
+
+在开始之前，请确保您的项目已添加以下依赖：
+
+- hutool-core: 提供工具类，例如资源访问工具。
+
+#### 下载 PDF 文件
+
+实现步骤
+
+- 定义请求路径:使用@RequestPath("/download/pdf/{id}")注解标注方法，定义了处理 PDF 文件下载的请求路径。
+- 读取文件:使用 ResourceUtil.getStream("pdf/" + id + ".pdf")根据文件 ID 动态获取 PDF 文件的输入流。
+- 发送响应:将 PDF 文件内容以字节形式发送给客户端，并设置 Content-Type 为 application/pdf; charset=utf-8。
+
+示例代码
+
+```java
+@RequestPath("/download/pdf/{id}")
+public HttpResponse downloadPdf(String id, HttpRequest request) {
+  log.info("id:{}", id);
+  InputStream inputStream = ResourceUtil.getStream("pdf/" + id + ".pdf");
+  int available;
+  try {
+    available = inputStream.available();
+    byte[] fileBytes = new byte[available];
+    inputStream.read(fileBytes, 0, available);
+    HttpResponse response = Resps.bytesWithContentType(request, fileBytes, "application/pdf; charset=utf-8");
+    return response;
+  } catch (IOException e) {
+    e.printStackTrace();
+    return Resps.json(request, RespVo.fail("Error generating captcha"));
+  }
+}
+```
+
+#### 下载 DOCX 文件
+
+实现步骤
+
+- 定义请求路径:使用@RequestPath("/download/docx/{id}")注解标注方法，定义了处理 DOCX 文件下载的请求路径。
+- 读取文件:使用 ResourceUtil.getStream(id+".docx")根据文件 ID 动态获取 DOCX 文件的输入流。
+- 发送响应:将 DOCX 文件内容以字节形式发送给客户端，并设置 Content-Type 为 application/vnd.openxmlformats-officedocument.wordprocessingml.document; charset=utf-8。
+
+示例代码
+
+```java
+@RequestPath("/download/docx/{id}")
+public HttpResponse download(String id, HttpRequest request) {
+  InputStream inputStream = ResourceUtil.getStream(id+".docx");
+  int available;
+  try {
+    available = inputStream.available();
+    byte[] fileBytes = new byte[available];
+    inputStream.read(fileBytes, 0, available);
+    HttpResponse response = Resps.bytesWithContentType(request, fileBytes,
+        "application/vnd.openxmlformats-officedocument.wordprocessingml.document; charset=utf-8");
+    return response;
+  } catch (IOException e) {
+    e.printStackTrace();
+    return Resps.json(request, RespVo.fail("Error generating captcha"));
+  }
+}
 ```
-package com.litongjava.tio.boot.hello.AController;
+
+结论
+通过上述实现，您可以方便地在您的 Java Web 应用中添加文件下载功能，支持多种文件格式，如 PDF 和 DOCX。请注意，文件路径和命名方式可能需要根据实际项目情况进行调整。
+
+#### 下载完整代码示例
+
+```java
+import java.io.IOException;
+import java.io.InputStream;
+
+import com.litongjava.tio.http.common.HttpRequest;
+import com.litongjava.tio.http.common.HttpResponse;
+import com.litongjava.tio.http.server.annotation.RequestPath;
+import com.litongjava.tio.http.server.util.Resps;
+import com.litongjava.tio.utils.resp.RespVo;
+
+import cn.hutool.core.io.resource.ResourceUtil;
+import lombok.extern.slf4j.Slf4j;
+
+@Slf4j
+public class DownloadController {
+  @RequestPath("/download/pdf/{id}")
+  public HttpResponse downloadPdf(String id, HttpRequest request) {
+    log.info("id:{}", id);
+    InputStream inputSteam = ResourceUtil.getStream("pdf/" + id + ".pdf");
+    int available;
+    try {
+      available = inputSteam.available();
+      byte[] captchaBytes = new byte[available];
+      inputSteam.read(captchaBytes, 0, available);
+
+      HttpResponse response = Resps.bytesWithContentType(request, captchaBytes, "application/pdf; charset=utf-8");
+      return response;
+    } catch (IOException e) {
+      e.printStackTrace();
+      return Resps.json(request, RespVo.fail("Error generating captcha"));
+    }
+  }
+
+  @RequestPath("/download/docx/{id}")
+  public HttpResponse download(String id, HttpRequest request) {
+    log.info("id:{}", id);
+    InputStream inputSteam = ResourceUtil.getStream(id + ".docx");
+    int available;
+    try {
+      available = inputSteam.available();
+      byte[] captchaBytes = new byte[available];
+      inputSteam.read(captchaBytes, 0, available);
+      // Content-Type:
+      HttpResponse response = Resps.bytesWithContentType(request, captchaBytes,
+          "application/vnd.openxmlformats-officedocument.wordprocessingml.document; charset=utf-8");
+      return response;
+    } catch (IOException e) {
+      e.printStackTrace();
+      return Resps.json(request, RespVo.fail("Error generating captcha"));
+    }
+  }
+
+}
+```
+
+### 下载图片
+
+#### 返回验证码
+
+用到了 hutool 依赖,请自行添加
+
+```java
 
 import java.io.ByteArrayOutputStream;
 import java.io.IOException;
@@ -82,17 +213,15 @@ public class CaptchaController {
 
 添加依赖
 
-```
+```xml
 <dependency>
   <groupId>com.google.zxing</groupId>
   <artifactId>core</artifactId>
   <version>3.4.1</version> <!-- 使用最新版本 -->
 </dependency>
 ```
 
-```
-package com.litongjava.tio.boot.hello.AController;
-
+```java
 import java.io.ByteArrayOutputStream;
 import java.io.IOException;
 
@@ -169,4 +298,4 @@ public class QrController {
 6. **请求示例**:
    - 访问 `http://localhost/qr?content=tio-boot` 将会触发这个控制器方法，`content=tio-boot` 表示生成包含文本 “tio-boot” 的二维码。
 
-这个控制器的作用是接收一个文本内容，并将其转换为二维码图片，然后将这个图片作为 HTTP 响应返回给客户端。如果在生成二维码的过程中出现问题，它会返回一个包含错误信息的 JSON 响应。
+这个控制器的作用是接收一个文本内容，并将其转换为二维码图片，然后将这个图片作为 HTTP 响应返回给客户端。如果在生成二维码的过程中出现问题，它会返回一个包含错误信息的 JSON 响应。