): 文档《响应实体类》。"}
{"id":"zh/06_web/01.md#chunk-0","pageId":"zh/06_web/01.md","title":"概述","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/01.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/01.md","heading":"概述","status":"document","sha256":"1141e21b8b72d41b15ea3cf20e83739beec295e52a4a56a6fbeb19bd2ecc34cf","content":"# 概述"}
{"id":"zh/06_web/01.md#chunk-1","pageId":"zh/06_web/01.md","title":"概述","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/01.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/01.md","heading":"TestControler","status":"document","sha256":"fe5b06b6b1e124e1de7e01bd531dd2f9ff07b6d353fa4006a74cf19bddf746dd","content":"## TestControler\n\n在 Web 开发中，常用的类包括 HttpRequest, HttpResponse, Reps 等。以下是一个使用了 tio-boot controller 的 Java 控制器示例：\n\n```java\npackage nexus.io.tio.web.hello.controller;\nimport nexus.io.annotation.AController;\nimport nexus.io.annotation.RequestPath;\n@AController\n@RequestPath(\"/test\")\npublic class TestController {\n\n @RequestPath\n public String index() {\n return \"index\";\n }\n}\n```\n\n这段代码演示了一些重要的注解的用法：\n\n1. `@AController`: 这个注解标识一个类作为控制器（Controller）。如果一个类已经被 `@RequestPath` 注解标记，那么可以省略 `@AController` 注解。\n2. `@RequestPath`: 这个注解用于指明控制器的请求路径。在这个例子中，它将 `TestController` 类关联到了 `/test` 路径。此外，当一个控制器类的成员方法返回值不为 void 时，tio-boot 会自动将这些方法添加到请求路由中。方法名将作为子路径。也可以通过在方法上使用 `@RequestPath` 来手动指定路由路径。\n\n在 TIO HTTP Server 中，一个控制器（Controller）的方法（即 Action 方法）支持注入以下类型的参数：\n\n- `ServerChannelContext`\n- `HttpConfig`\n- `HttpSession`\n- `HttpRequest`"}
{"id":"zh/06_web/01.md#chunk-2","pageId":"zh/06_web/01.md","title":"概述","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/01.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/01.md","heading":"IndexController","status":"document","sha256":"beeac2bdbdc3bc897be7d58b92ed91c77bd1acdb82ff1536df130ca85200b3d9","content":"## IndexController\n\n```\nimport nexus.io.annotation.RequestPath;\n\n@RequestPath(\"/\")\npublic class IndexController {\n @RequestPath(\"\")\n public String index() {\n return \"uh-course\";\n }\n}\n\n```\n\n1. **类声明和注解**:\n\n - `@RequestPath(\"/\")`: 这个注解将整个 `IndexController` 类映射到根路径 `/`。这意味着当请求的 URL 以 `/` 开头时，可能会由这个控制器处理。\n\n2. **方法声明和注解**:\n - `@RequestPath(\"\")`: 这个注解将 `index` 方法映射到相对路径为空的请求，即根路径 `/`。当请求 URL 是 `/` 时，这个方法会被调用。\n - `public String index()`: 这是一个公开的方法，它返回一个字符串 `\"uh-course\"`。这个字符串将作为 HTTP 响应的内容返回给客户端。\n\n测试\n\n```\n>curl http://localhost/\nuh-course\n>curl http://localhost\nuh-course\n```"}
{"id":"zh/06_web/02.md#chunk-0","pageId":"zh/06_web/02.md","title":"接收请求参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/02.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/02.md","heading":"接收请求参数","status":"document","sha256":"e449ce2f194cc0dd4162db42bb39980293a51fb590ec8bab07b80793edd0d11b","content":"# 接收请求参数"}
{"id":"zh/06_web/02.md#chunk-1","pageId":"zh/06_web/02.md","title":"接收请求参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/02.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/02.md","heading":"get 获取参数","status":"document","sha256":"91d4a977f635b011ab2fc980c1927011ffc9d14dca8f4ca74dfd8cf5c55c2d4a","content":"### get 获取参数\n\n```\n@RequestPath(value = \"/get\")\npublic HttpResponse get(String before, String end, HttpRequest request) throws Exception {\n HttpResponse ret = Resps.html(request, \"before:\" + before + \"
end:\" + end);\n return ret;\n}\n```\n\n这段代码定义了一个名为 `get` 的方法，通过 `@RequestPath` 注解映射到 URL 路径 `/get`。方法接收两个字符串参数 `before` 和 `end`，以及一个 `HttpRequest` 对象 `request`。"}
{"id":"zh/06_web/02.md#chunk-2","pageId":"zh/06_web/02.md","title":"接收请求参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/02.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/02.md","heading":"Post 获取参数","status":"document","sha256":"4e6938298db618cbe2a774173db91b60960f7e7a933ef9e429230e20bc82925a","content":"### Post 获取参数\n\n```\n @RequestPath(value = \"/post\")\n public HttpResponse post(String before, String end, User user, Short shortid, HttpRequest request) throws Exception {\n HttpResponse ret = Resps.html(request, \"before:\" + before + \"
end:\" + end + \"
user:\" + Json.toFormatedJson(user) + \"
\");\n return ret;\n }\n```\n\n这段代码定义了一个名为 `post` 的方法，通过 `@RequestPath` 注解映射到 `/post` URL 路径。这个方法接收几个参数：两个字符串 `before` 和 `end`，一个 `User` 对象 `user`，一个 `Short` 类型的 `shortid`，以及一个 `HttpRequest` 对象 `request`。\n\n这个方法的主要功能是接收 HTTP POST 请求，获取其中的参数和用户对象，并将这些信息以 HTML 格式的响应返回。"}
{"id":"zh/06_web/02.md#chunk-3","pageId":"zh/06_web/02.md","title":"接收请求参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/02.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/02.md","heading":"从请求地址中获取参数","status":"document","sha256":"dea2fb0c81fdc25d88cfb572e61bf6877fe9642335b0c2981fd1aa47cd5c4e76","content":"### 从请求地址中获取参数\n\n示例代码\n\n```\n@RequestPath(value = \"/var/{name}/{id}\")\npublic HttpResponse var(String name, String id, HttpRequest request) throws Exception {\n HttpResponse ret = Resps.json(request, \"name:\" + name + \"\\r\\n\" + \"id:\" + id);\n return ret;\n}\n```\n\n这段代码定义了一个处理 HTTP 请求的方法 `var`，该方法映射到一个 URL 路径模式 `/var/{name}/{id}`。这里的 `{name}` 和 `{id}` 是路径变量，它们在 URL 中动态替换成实际的值。方法接收两个字符串参数 `name` 和 `id`，这些参数自动从匹配的 URL 中提取。还有一个 `HttpRequest` 参数，代表接收到的 HTTP 请求。\n\n方法的主体创建并返回一个 `HttpResponse` 对象，其中包含 `name` 和 `id` 的值。通过 `Resps.json` 方法生成响应，它将 `name` 和 `id` 的值格式化为 JSON 格式的字符串。这样，当访问对应的 URL 时，此方法将以 JSON 格式返回提取的 `name` 和 `id` 参数值。"}
{"id":"zh/06_web/02.md#chunk-4","pageId":"zh/06_web/02.md","title":"接收请求参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/02.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/02.md","heading":"URL 编码的参数名与重复参数","status":"document","sha256":"60778c348789a8f37a6048c93041e4eb257f9a80b918d544d31fa86fef45a8e0","content":"## URL 编码的参数名与重复参数\n\n查询字符串及 `application/x-www-form-urlencoded` 表单由框架统一解码，参数名和参数值都使用请求字符集进行 URL 解码。业务 Handler 直接读取解码后的名称，不必再调用 URLDecoder，避免二次解码。\n\n| 传入片段 | 解码结果 |\n| --- | --- |\n| `%69d=one&id=two` | 同一个 id 参数的两个值，按请求顺序保留 |\n| `first+name=hello+world` | 名称 first name，值 hello world |\n| `%E5%90%8D=%E5%80%BC` | 名称“名”，值“值” |\n| `x%3Dy=a%3Db` | 名称 x=y，值 a=b |\n\n重复参数可从 `request.getParams().get(\"id\")` 获取数组；不要只读取单值后假定客户端没有提交其他同名值。名称或值中的非法百分号编码会进入请求解码错误处理。\n\n```java\nimport nexus.io.tio.boot.http.TioRequestContext;\nimport nexus.io.tio.http.common.HttpRequest;\nimport nexus.io.tio.http.common.HttpResponse;\nimport nexus.io.model.body.RespBodyVo;\n\npublic class ParameterNameHandler {\n public HttpResponse handle(HttpRequest request) {\n String value = request.getParam(\"first name\");\n return TioRequestContext.getResponse().respond(RespBodyVo.ok(value));\n }\n}\n```"}
{"id":"zh/06_web/02.md#chunk-5","pageId":"zh/06_web/02.md","title":"接收请求参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/02.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/02.md","heading":"程序追加参数与类型保留","status":"document","sha256":"3109d5f24cdd5cb742266161ac02f7c210134823a85cca8c0072bbae3abab3a5","content":"## 程序追加参数与类型保留\n\n`request.addParam(name, value)` 按调用顺序追加同名参数，支持字符串、UploadFile 以及其他 Java 对象。纯字符串参数保留 String[] 类型，纯文件参数保留 UploadFile[] 类型；混合类型使用 Object[]，便于完整保留同名字段的不同值。\n\n```java\nimport nexus.io.tio.http.common.HttpRequest;\n\npublic class ParameterEnrichment {\n public Object[] addInternalValues(HttpRequest request) {\n request.addParam(\"internal-value\", Integer.valueOf(42));\n request.addParam(\"internal-value\", \"label\");\n return request.getParamArray(\"internal-value\");\n }\n}\n```\n\n示例结果依次包含 Integer 值 42 和字符串 label。`getObject` 读取第一个对象，`getParamArray` 读取完整数组。字符串字段可用 `getParam` 或 `getParamValues`，文件字段可用 `getUploadFile`；混合字段应通过对象接口读取，再按业务约定检查类型。\n\n程序调用 `addParam(name, null)` 保持不追加的行为。查询字符串和表单的解码追加也保留已有值与顺序，普通对象不会自动转换为字符串。框架按 Content-Type 完成请求解析，Handler 无需另写一套表单解码逻辑。"}
{"id":"zh/06_web/02.md#chunk-6","pageId":"zh/06_web/02.md","title":"接收请求参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/02.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/02.md","heading":"Content-Type 的区域无关识别","status":"document","sha256":"ba6123e7e7177feb14f4bb40cb51a9114f6a9fd284dde9e3c894ea0ca4d1533a","content":"## Content-Type 的区域无关识别\n\n框架使用固定大小写规则识别 Content-Type，与 JVM 默认语言区域无关。application/json 及其大写形式进入相同的文本处理流程；multipart/form-data 的大小写形式也遵循相同分类，便于在不同部署区域保持一致的请求解析行为。"}
{"id":"zh/06_web/02.md#chunk-7","pageId":"zh/06_web/02.md","title":"接收请求参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/02.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/02.md","heading":"HTTP 首部属性","status":"document","sha256":"0c06604677d7750a093e0399348bf32e41fe30ac79e0b257d178e10a9163b89f","content":"## HTTP 首部属性\n\n`HttpParseUtils.getSubAttribute` 按完整属性名称匹配，名称不区分大小写，允许等号两侧留空白，属性值保持原始大小写。带引号的值支持分号及反斜杠转义，适合解析 Content-Type 的 boundary、charset 与 Content-Disposition 的 name、filename。缺少属性或引号未闭合时返回 null。\n\n```java\nimport nexus.io.tio.http.common.utils.HttpParseUtils;\n\npublic class HeaderAttributeExample {\n public String uploadField() {\n String header = \"form-data; filename=photo.png; name=upload\";\n return HttpParseUtils.getSubAttribute(header, \"name\");\n }\n\n public String multipartBoundary() {\n return HttpParseUtils.getSubAttribute(\"multipart/form-data; BOUNDARY = AbCd\", \"boundary\");\n }\n}\n```\n\n示例分别返回 upload 与 AbCd。框架的 multipart 和字符集解析复用该方法，业务处理器通常可以直接使用框架已经解析的请求参数。"}
{"id":"zh/06_web/03.md#chunk-0","pageId":"zh/06_web/03.md","title":"接收日期参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/03.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/03.md","heading":"接收日期参数","status":"document","sha256":"934eb0aba7cbd6cc21a982ec38551fe8c50d3dd54084482c515fe6084f38fa73","content":"# 接收日期参数\n\n在 Tio-Boot 框架中，处理日期类型参数是开发中的常见场景。通过框架内置的类型转换功能，可以轻松地接收和处理前端传递的日期数据"}
{"id":"zh/06_web/03.md#chunk-1","pageId":"zh/06_web/03.md","title":"接收日期参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/03.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/03.md","heading":"Date","status":"document","sha256":"deeb04228b858100337710c6c818cae648e0c85a7ec30e32114efac83b5093e8","content":"## Date"}
{"id":"zh/06_web/03.md#chunk-2","pageId":"zh/06_web/03.md","title":"接收日期参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/03.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/03.md","heading":"使用 Tio-Boot 框架处理 `Date` 类型参数","status":"document","sha256":"5029400316c310442a75b1f1ea9490444f09f2e65e4eecaefe570b22de07dfbe","content":"### 使用 Tio-Boot 框架处理 `Date` 类型参数\n\n以下是一个简单的示例，演示如何在 Controller 中接收 `Date` 类型的参数。"}
{"id":"zh/06_web/03.md#chunk-3","pageId":"zh/06_web/03.md","title":"接收日期参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/03.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/03.md","heading":"示例代码","status":"document","sha256":"cd570a9d79d584ea2f8b1e70212533fcaa358ee2669226509a43a2ba181a30ba","content":"#### 示例代码\n\n```java\nimport java.util.Date;\n\nimport com.jfinal.kit.Kv;\nimport nexus.io.annotation.RequestPath;\nimport nexus.io.model.body.RespBodyVo;\n\n@RequestPath(\"/base\")\npublic class BaseController {\n\n public RespBodyVo date(Date date) {\n Kv kv = Kv.create();\n kv.set(\"date\", date);\n return RespBodyVo.ok(kv);\n }\n}\n```\n\n在上面的代码中，`BaseController` 通过 `date()` 方法接收一个 `java.util.Date` 类型的参数。这个参数将由前端以特定格式传递，并自动转换为 `Date` 对象。"}
{"id":"zh/06_web/03.md#chunk-4","pageId":"zh/06_web/03.md","title":"接收日期参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/03.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/03.md","heading":"请求示例","status":"document","sha256":"21689f5cb856f21667b15ed1931d0cef8190bf624a55ce3a289892f07b0321c6","content":"#### 请求示例\n\n前端请求可以如下发送：\n\n```\ndate=2014-09-04 08:34:00\n```\n\n此请求将会传递一个日期字符串，该字符串将被 Tio-Boot 框架自动解析为 `java.util.Date` 对象，并传递给 `date()` 方法。"}
{"id":"zh/06_web/03.md#chunk-5","pageId":"zh/06_web/03.md","title":"接收日期参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/03.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/03.md","heading":"响应示例","status":"document","sha256":"93052b5a86c3821f85d8f6ea05d69deb5bd36268bfbf296683384e42d1ffe705","content":"#### 响应示例\n\n服务端返回的响应数据可能如下所示：\n\n```json\n{\n \"data\": {\n \"date\": \"2014-09-04 08:34:00\"\n },\n \"ok\": true,\n \"msg\": null,\n \"code\": 1\n}\n```\n\n在响应中，`data` 字段包含了请求传递的日期值。这个日期数据可以用于进一步的业务逻辑处理或直接返回给前端。"}
{"id":"zh/06_web/03.md#chunk-6","pageId":"zh/06_web/03.md","title":"接收日期参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/03.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/03.md","heading":"明确业务时区和日历日期","status":"document","sha256":"674deef3cf4ee4158c57bb069ae454dd2f61552d0f4f692c9973186b597c153a","content":"## 明确业务时区和日历日期\n\n对于“今天”“明天”等相对日期，先确定业务时区，再按日历日期加减。`LocalDate` 表示日期，`Instant` 表示时间点；将 `Clock` 作为参数便于固定时间测试，也避免依赖服务器默认时区。以下工具可以由 Service 调用，不需要改变框架的请求参数绑定。\n\n```java\nimport java.time.Clock;\nimport java.time.LocalDate;\nimport java.time.ZoneId;\n\npublic final class BusinessDateUtils {\n private static final ZoneId BUSINESS_ZONE = ZoneId.of(\"Asia/Shanghai\");\n\n private BusinessDateUtils() {\n }\n\n public static LocalDate tomorrow(Clock clock) {\n return LocalDate.now(clock.withZone(BUSINESS_ZONE)).plusDays(1);\n }\n}\n```\n\n```java\nimport java.time.Clock;\nimport java.time.Instant;\nimport java.time.LocalDate;\nimport java.time.ZoneOffset;\n\npublic class BusinessDateExample {\n public static void main(String[] args) {\n Clock clock = Clock.fixed(Instant.parse(\"2026-10-10T16:30:00Z\"), ZoneOffset.UTC);\n LocalDate date = BusinessDateUtils.tomorrow(clock);\n System.out.println(date); // 2026-10-12\n }\n}\n```\n\n业务响应宜返回明确的日期字符串；含出发和到达时间的业务需要分别保留完整日期、时间和时区偏移。价格与日期等外部数据应在应用服务中校验实际响应字段，不能只依据请求 URL 推断结果。"}
{"id":"zh/06_web/04.md#chunk-0","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"接收数组参数","status":"document","sha256":"93718e0435eb0ac05029a6b5451574b8277bcf8081f709ff7625f0bcb019629f","content":"# 接收数组参数\n\n在 Web 应用程序中，处理包含数组参数的 HTTP 请求是一项常见的需求。本文将介绍两种处理数组参数的方法：\n\n1. **使用框架自带的绑定功能（From）**\n2. **使用自定义解析逻辑**"}
{"id":"zh/06_web/04.md#chunk-1","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"1. 使用框架自带的绑定功能（From）","status":"document","sha256":"83f03f81528b946e3b5eb53cfee3e6881a3390acefd8bfd65fb80fdb34296ed6","content":"## 1. 使用框架自带的绑定功能（From）\n\n利用框架提供的注解和自动绑定功能，可以简化数组参数的接收和处理。以下是一个示例方法，展示如何通过 `@RequestPath` 注解接收数组参数。"}
{"id":"zh/06_web/04.md#chunk-2","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"示例代码","status":"document","sha256":"0b4c92859160c9b3ca5122318ee4af918085edf88ef11cef78150696677032aa","content":"### 示例代码\n\n```java\nimport nexus.io.annotation.RequestPath;\nimport nexus.io.http.HttpRequest;\nimport nexus.io.http.HttpResponse;\nimport nexus.io.http.Resps;\nimport nexus.io.json.Json;\nimport org.slf4j.Logger;\nimport org.slf4j.LoggerFactory;\n\npublic class ArrayController {\n\n private static final Logger log = LoggerFactory.getLogger(ArrayController.class);\n\n @RequestPath(value = \"/array\")\n public HttpResponse array(String[] names, Integer[] ids, int[] primitiveIds, HttpRequest request) throws Exception {\n // 将数组参数转换为格式化的 JSON 字符串，并拼接作为响应内容\n String jsonResponse = Json.toFormatedJson(names) + Json.toFormatedJson(ids) + Json.toFormatedJson(primitiveIds);\n HttpResponse ret = Resps.json(request, jsonResponse);\n\n // 从请求中获取名为 \"names\" 的参数数组\n Object[] xx = request.getParamArray(\"names\");\n log.info(\"Received names array: {}\", Json.toFormatedJson(xx));\n\n return ret;\n }\n}\n```"}
{"id":"zh/06_web/04.md#chunk-3","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"方法说明","status":"document","sha256":"5ed11ba7953ad1dba95656b350132d2c27fc7ba64977a3592941021bc708d03b","content":"### 方法说明\n\n- **方法签名**:\n\n - `array` 方法通过 `@RequestPath` 注解映射到 URL 路径 `/array`。\n - 接收四个参数：\n - `String[] names`：字符串数组。\n - `Integer[] ids`：包装类 `Integer` 数组。\n - `int[] primitiveIds`：基本类型 `int` 数组。\n - `HttpRequest request`：HTTP 请求对象，用于获取额外的请求信息。\n\n- **方法逻辑**:\n\n 1. **生成响应内容**：\n\n - 使用 `Json.toFormatedJson` 方法将 `names`、`ids` 和 `primitiveIds` 数组转换为格式化的 JSON 字符串。\n - 将这些 JSON 字符串拼接起来，作为响应的内容。\n - 通过 `Resps.json` 方法创建一个 `HttpResponse` 对象，包含上述 JSON 内容。\n\n 2. **获取并记录参数数组**：\n\n - 使用 `request.getParamArray(\"names\")` 方法从请求中获取名为 `\"names\"` 的参数数组，并存储在 `Object[] xx` 中。\n - 使用日志记录工具（`log.info`）记录 `xx` 数组的格式化 JSON 表示，便于调试和监控。\n\n 3. **返回响应**：\n - 返回包含 `names`、`ids` 和 `primitiveIds` 数组 JSON 表示的 `HttpResponse` 对象。"}
{"id":"zh/06_web/04.md#chunk-4","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"HTML 表单示例","status":"document","sha256":"413eb99feac7a9bea15f1a6ca4b092061c091861e743fc81bd015f5fd210f8c9","content":"### HTML 表单示例\n\n前端可以通过 HTML 表单发送数组参数。以下是一个示例表单，展示如何通过多个 `input` 标签传递数组数据。\n\n```html\n\n```"}
{"id":"zh/06_web/04.md#chunk-5","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"注意事项","status":"document","sha256":"522776dcbe750b0b14e9f7985caac631cf02d93d0cde51e34cca091ced4fb588","content":"### 注意事项\n\n- **参数名称一致性**：确保前端 `input` 标签的 `name` 属性与后端方法参数名称一致，以便框架能够正确绑定。\n- **数据类型匹配**：前端传递的参数值应与后端接收的数组类型匹配，避免类型转换错误。"}
{"id":"zh/06_web/04.md#chunk-6","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"2. 使用自定义解析逻辑","status":"document","sha256":"22efe2607c7a11fda89f43bbd333eb4e85dfbdba466887f923ace639a618960e","content":"## 2. 使用自定义解析逻辑\n\n有时，使用框架自带的绑定功能可能不够灵活或过于繁琐。此时，可以选择自定义解析请求参数，手动处理数组数据。"}
{"id":"zh/06_web/04.md#chunk-7","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"示例代码","status":"document","sha256":"1c99278ebdbfc08130d27f5eec1ba111b797183e207c67259d88b1c934761b80","content":"### 示例代码\n\n```java\nimport nexus.io.annotation.RequestPath;\nimport nexus.io.model.body.RespBodyVo;\nimport nexus.io.tio.http.common.HttpRequest;\n\n@RequestPath(\"/api/v1/email\")\npublic class ApiV1EmailController {\n\n /**\n * 发送邀请邮件\n *\n * @param request HTTP 请求对象\n * @return 响应体，包含处理结果\n */\n public RespBodyVo sendInviteEmail(HttpRequest request) {\n // 获取名为 \"ids\" 的参数\n String ids = request.getParam(\"ids\");\n\n // 参数校验\n if (ids == null || ids.trim().isEmpty()) {\n return RespBodyVo.fail(\"ids 不能为空\");\n }\n\n // 分割参数字符串，转换为 long 类型数组\n String[] split = ids.split(\",\");\n long[] studentIds = new long[split.length];\n try {\n for (int i = 0; i < split.length; i++) {\n studentIds[i] = Long.parseLong(split[i].trim());\n }\n } catch (NumberFormatException e) {\n return RespBodyVo.fail(\"ids 格式错误，必须为数字\");\n }\n\n // 返回成功响应，包含转换后的 studentIds 数组\n return RespBodyVo.ok(studentIds);\n }\n}\n```"}
{"id":"zh/06_web/04.md#chunk-8","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"方法说明","status":"document","sha256":"d19fcade37a2a45796382552792c3526e63ca42510785c7d72b041106403d19c","content":"### 方法说明\n\n- **方法签名**:\n\n - `sendInviteEmail` 方法通过 `@RequestPath` 注解映射到 URL 路径 `/api/v1/email/sendInviteEmail`。\n - 接收一个参数 `HttpRequest request`，用于获取请求中的参数。\n\n- **方法逻辑**:\n\n 1. **获取参数**：\n\n - 使用 `request.getParam(\"ids\")` 方法获取请求中名为 `\"ids\"` 的参数值。\n\n 2. **参数校验**：\n\n - 检查 `ids` 是否为 `null` 或空字符串，若是，则返回失败响应，提示 `\"ids 不能为空\"`。\n\n 3. **参数解析**：\n\n - 使用 `split(\",\")` 方法将 `ids` 字符串按逗号分割，得到一个字符串数组。\n - 创建一个 `long[]` 类型的数组 `studentIds`，用于存储转换后的数字。\n - 遍历分割后的字符串数组，使用 `Long.parseLong` 方法将每个字符串转换为 `long` 类型，并存入 `studentIds` 数组。\n - 如果转换过程中发生 `NumberFormatException` 异常，说明参数格式错误，返回失败响应，提示 `\"ids 格式错误，必须为数字\"`。\n\n 4. **返回响应**：\n - 使用 `RespBodyVo.ok(studentIds)` 返回成功响应，包含转换后的 `studentIds` 数组。"}
{"id":"zh/06_web/04.md#chunk-9","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"前端请求示例","status":"document","sha256":"c33a53b1ec5967342727429a20bb220b19d652958f32fcda2d3ac4d70d045a11","content":"### 前端请求示例\n\n使用 `curl` 命令发送 POST 请求，传递 `ids` 参数。\n\n```bash\ncurl --location --request POST 'http://localhost/api/v1/email/sendInviteEmail' \\\n--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \\\n--header 'Authorization: Bearer PAfvyWa268y0on8MbxHhfYY21rvi9Sx8' \\\n--header 'Accept: */*' \\\n--header 'Host: localhost' \\\n--header 'Connection: keep-alive' \\\n--header 'Content-Type: application/x-www-form-urlencoded' \\\n--data-urlencode 'ids=1,2,3,4,5,6,7,8,9'\n```"}
{"id":"zh/06_web/04.md#chunk-10","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"后端响应示例","status":"document","sha256":"6a7a8c93b332ba50a39c175d5aa40deb47b60a8d4cce95a47a119609e0f76969","content":"### 后端响应示例\n\n成功处理请求后，后端返回如下 JSON 响应：\n\n```json\n{\n \"data\": [1, 2, 3, 4, 5, 6, 7, 8, 9],\n \"code\": 1,\n \"msg\": null,\n \"ok\": true\n}\n```"}
{"id":"zh/06_web/04.md#chunk-11","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"注意事项","status":"document","sha256":"0ecab9c09b507735070c6d607c19bd8087c68c17b8f87088e81426e052fc14d9","content":"### 注意事项\n\n- **参数格式**：确保前端传递的 `ids` 参数为逗号分隔的数字字符串，例如 `\"1,2,3,4,5,6,7,8,9\"`。\n- **异常处理**：在参数解析过程中，捕获可能的格式异常，及时返回有意义的错误信息，提升用户体验。\n- **安全性**：对传入的参数进行必要的校验和清理，防止潜在的安全风险，如注入攻击。"}
{"id":"zh/06_web/04.md#chunk-12","pageId":"zh/06_web/04.md","title":"接收数组参数","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/04.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/04.md","heading":"总结","status":"document","sha256":"0cb3a71e6c31c0157c997ae2ef37eb210f7ee05c99595784bf4ca4a88a1829bc","content":"## 总结\n\n在 Web 应用程序中，处理数组参数有多种方法。使用框架自带的绑定功能可以简化开发，但在某些情况下，自定义解析逻辑提供了更高的灵活性和控制力。根据具体需求选择合适的方法，确保代码的可维护性和系统的稳定性。"}
{"id":"zh/06_web/05.md#chunk-0","pageId":"zh/06_web/05.md","title":"返回字符串","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/05.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/05.md","heading":"返回字符串","status":"document","sha256":"c9167cdb87137626b0ce33656a234d50df5114e48b0bada66419c476dd84e94b","content":"# 返回字符串\n\n```\npackage nexus.io.tio.boot.hello.AController;\n\nimport nexus.io.annotation.RequestPath;\n@AController\n@RequestPath(\"/test/string\")\npublic class TestStringController {\n\n @RequestPath()\n public String index() {\n return \"index\";\n }\n}\n```\n\n这段代码定义了一个使用 tio-boot 框架的 HTTP 控制器，专门用于处理 /test/string 路径下的 Web 请求，并返回一个字符串。\n\n- `@RequestPath()`: 方法注解，指定了此方法处理的具体请求路径。结合类注解，当 HTTP 请求发送到 `/test/string` 时，此方法将被调用。\n- 方法不接收任何参数，这意味着它响应的是不需要任何输入的请求。\n- 方法返回一个字符串 `\"index\"`。在 tio-boot 框架中，会直接将字符串 `\"index\"` 作为响应内容发送给客户端不会查找名为 `\"index\"` 的视图模板，并用该模板生成 HTTP 响应。"}
{"id":"zh/06_web/06.md#chunk-0","pageId":"zh/06_web/06.md","title":"返回文本数据","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/06.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/06.md","heading":"返回文本数据","status":"document","sha256":"ec3bd384c6df851c6a25e1f62a264148877e943fd213bacf795bcb1f28fe40d5","content":"# 返回文本数据\n\n使用 `Resps.txt` 返回纯文本，由框架设置 `text/plain` 和对应的 charset，无需手写 Content-Type。\n\n```java\nimport nexus.io.tio.boot.http.TioRequestContext;\nimport nexus.io.tio.http.common.HttpRequest;\nimport nexus.io.tio.http.common.HttpResponse;\nimport nexus.io.tio.http.server.util.Resps;\n\npublic class TextHandler {\n public HttpResponse handle(HttpRequest request) {\n HttpResponse response = TioRequestContext.getResponse().setStatus(200);\n return Resps.txt(response, \"服务正常\", \"UTF-8\");\n }\n}\n```\n\n`Resps.txt(response, body, \"UTF-8\")` 复用传入的响应对象，保留已设置的状态码及其他响应头，使用 UTF-8 编码正文并设置纯文本 Content-Type。第三方协议要求纯文本回执时，可以直接用它返回协议规定的字符串。\n\n| 调用 | 行为 |\n| --- | --- |\n| `Resps.txt(request, body)` | 创建响应，使用请求字符集 |\n| `Resps.txt(response, body)` | 复用响应，使用响应字符集 |\n| `Resps.txt(request, body, charset)` | 创建响应，显式指定正文编码与 Content-Type 字符集 |\n| `Resps.txt(response, body, charset)` | 复用响应，显式指定正文编码与 Content-Type 字符集 |\n\n普通业务接口需要统一 JSON 响应结构时，继续使用 `RespBodyVo`；纯文本接口根据协议返回原文。"}
{"id":"zh/06_web/07.md#chunk-0","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"返回网页","status":"document","sha256":"d0e37cdb0601c35b20992617f1bca8a280eb704a10ef005c7b140694629de709","content":"# 返回网页"}
{"id":"zh/06_web/07.md#chunk-1","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"概述","status":"document","sha256":"505253682a68c0b750bca551fcd349b3ddec3bdf00aa311eef2c743c1c34bcda","content":"## 概述\n\n本文档介绍如何使用 tio-boot 框架创建 Controller 来直接返回网页内容。通过这种方式，可以将存储在数据库中的 HTML 内容直接渲染到浏览器中。"}
{"id":"zh/06_web/07.md#chunk-2","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"控制器实现","status":"document","sha256":"09f5372aba757ba8ddbb4ef641041dd70a713a097513e8aea60ec74c3874a564","content":"## 控制器实现"}
{"id":"zh/06_web/07.md#chunk-3","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"完整代码示例","status":"document","sha256":"f19303d5c0e830f68a50dbb757fa4abf6856daa10d350bf4d790c2e24f1ca3e4","content":"### 完整代码示例\n\n```java\nimport nexus.io.annotation.RequestPath;\nimport nexus.io.db.activerecord.Db;\nimport nexus.io.tio.boot.http.TioRequestContext;\nimport nexus.io.tio.http.common.HttpResponse;\nimport nexus.io.tio.http.server.util.Resps;\n\n@RequestPath(\"/amazon_products\")\npublic class AmazonProductsHtmlController {\n\n @RequestPath(\"/{id}\")\n public HttpResponse html(Long id) {\n String html = Db.queryStr(\"select html from amazon_products_html where id=?\", id);\n HttpResponse response = TioRequestContext.getResponse();\n Resps.html(response, html);\n return response;\n }\n}\n```"}
{"id":"zh/06_web/07.md#chunk-4","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"代码解析","status":"document","sha256":"225c048b1eb13a02cba106f9f3ad3257e64cd33cb9098d1751a468fecd58146e","content":"### 代码解析"}
{"id":"zh/06_web/07.md#chunk-5","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"1. 注解说明","status":"document","sha256":"70df04dc3d59b02e2c197d6720b3241a201cf55e71fcbadf1e5dce443599adfd","content":"#### 1. 注解说明\n\n- `@RequestPath(\"/amazon_products\")`: 类级别的注解，定义控制器的基础路径\n- `@RequestPath(\"/{id}\")`: 方法级别的注解，定义具体的路由路径，其中 `{id}` 是路径参数"}
{"id":"zh/06_web/07.md#chunk-6","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"2. 核心组件","status":"document","sha256":"c1b65de025f5ce0cb3fd3152d53db4415aea9f4278d97e4f39f4ab5c7ba28ea9","content":"#### 2. 核心组件\n\n- **Db.queryStr()**: 从数据库中查询 HTML 内容\n - 执行 SQL 查询：`select html from amazon_products_html where id=?`\n - 参数化查询防止 SQL 注入\n- **TioRequestContext.getResponse()**: 获取当前的 HTTP 响应对象\n- **Resps.html()**: 设置响应内容为 HTML 格式"}
{"id":"zh/06_web/07.md#chunk-7","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"3. 执行流程","status":"document","sha256":"ac795a28360dd36e4503d708f0677eba513e8d30019b1a38e26ffa54f2345af6","content":"#### 3. 执行流程\n\n1. 用户访问 `/amazon_products/{id}` 路径\n2. 控制器接收 `id` 参数\n3. 从数据库查询对应的 HTML 内容\n4. 将查询结果设置为 HTTP 响应的 HTML 内容\n5. 返回完整的 HTTP 响应"}
{"id":"zh/06_web/07.md#chunk-8","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"路由访问","status":"document","sha256":"4dccd66fba479bfc17f259e34bb3ecd33e5dd27ff60b3426037b2d924fbb8b5e","content":"### 路由访问\n\n```\nGET /amazon_products/123\n```\n\n其中 `123` 是数据库记录的 ID。"}
{"id":"zh/06_web/07.md#chunk-9","pageId":"zh/06_web/07.md","title":"返回网页","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/07.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/07.md","heading":"数据库表结构","status":"document","sha256":"19eaa28ba3c951752e9b9f2b23c389aba2fd9932dc3f9fbd55985be471b11fcc","content":"### 数据库表结构\n\n```sql\nCREATE TABLE amazon_products_html (\n id BIGINT PRIMARY KEY,\n html TEXT\n);\n```"}
{"id":"zh/06_web/08.md#chunk-0","pageId":"zh/06_web/08.md","title":"请求和响应字节","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/08.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/08.md","heading":"请求和响应字节","status":"document","sha256":"5d4392f135760f8a46db2415e29b2a9904ebd89afc33e176d29b44cb8d09ca1c","content":"# 请求和响应字节"}
{"id":"zh/06_web/08.md#chunk-1","pageId":"zh/06_web/08.md","title":"请求和响应字节","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/08.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/08.md","heading":"获取请求字节","status":"document","sha256":"b7eb36706fd0234ead8e9544aff18010d19945c133c0f47d15fb0609eef78978","content":"### 获取请求字节\n\n```\npackage nexus.io.tio.boot.hello.AController;\n\nimport nexus.io.tio.http.common.HttpRequest;\nimport nexus.io.annotation.RequestPath;\n@AController\n@RequestPath(\"/test/bytes\")\npublic class TestBytesController {\n\n @RequestPath\n public String index(HttpRequest reuqest) {\n byte[] body = reuqest.getBody();\n return \"index\";\n }\n}\n```\n\n**Method `index`**:\n\n- `@RequestPath`: 方法注解，没有提供具体的路径值，这意味着它将使用类级别的路径 `/test/bytes`。因此，当 HTTP 请求发送到 `/test/bytes` 时，此方法将被调用。\n- 方法接收一个 `HttpRequest` 对象作为参数，代表接收到的 HTTP 请求。\n- `byte[] body = reuqest.getBody();`: 从 HTTP 请求中获取字节数组格式的请求体。\n- 方法返回一个字符串 `\"index\"`。这个字符串会会作为 Response 返回。\n\n这对深度学习框架很有用,可以它获取客户端发送的 NumPy 的字节数据"}
{"id":"zh/06_web/08.md#chunk-2","pageId":"zh/06_web/08.md","title":"请求和响应字节","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/08.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/08.md","heading":"响应字节","status":"document","sha256":"ae23e5beff1c5fce97be35843178cd91b98b81696c5ee01f10db18c4c68cbe64","content":"### 响应字节\n\n直接响应\n\n```\n@RequestPath(\"/pen/raw/data\")\n@Slf4j\npublic class PenRawDataController {\n\n @RequestPath()\n public byte[] index() {\n byte[] bytes = new byte[] { 1, 2, 3, 4, 5, 6, 7, 8 };\n HttpResponse response = TioControllerContext.getResponse();\n response.setBody(bytes);\n return bytes;\n }\n}\n```\n\n封装为 HttpResponse 响应\n\n```\nimport nexus.io.tio.http.common.HttpResponse;\n@RequestPath(\"/pen/raw/data\")\n@Slf4j\npublic class PenRawDataController {\n\n @RequestPath()\n public HttpResponse index() {\n byte[] bytes = new byte[] { 1, 2, 3, 4, 5, 6, 7, 8 };\n HttpResponse response = TioControllerContext.getResponse();\n response.setBody(bytes);\n return response;\n }\n}\n```"}
{"id":"zh/06_web/09.md#chunk-0","pageId":"zh/06_web/09.md","title":"文件上传","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/09.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/09.md","heading":"文件上传","status":"document","sha256":"d74d2a10165cdca486e4b1d033709d4ea0d099ba08682a8d0af2386f3b870f6b","content":"# 文件上传"}
{"id":"zh/06_web/09.md#chunk-1","pageId":"zh/06_web/09.md","title":"文件上传","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/09.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/09.md","heading":"接收文件","status":"document","sha256":"7bfa00742bf384341d26a1fabd9ec59112b107469736711ebe8c1bd372a949b9","content":"## 接收文件\n\n接受文件在 Controller 的方法中添加 UploadFile 类型的参数,在发送 http 请求时,请求的 key 是 UploadFile 类型的参数名.通常是 file,下面的案例是 uploadFile\n\n```java\npackage nexus.io.tio.web.hello.controller;\n\nimport java.io.File;\n\nimport nexus.io.annotation.RequestPath;\nimport nexus.io.tio.boot.http.TioRequestContext;\nimport nexus.io.tio.http.common.HttpResponse;\nimport nexus.io.model.upload.UploadFile;\nimport nexus.io.tio.utils.hutool.FileUtil;\n\n@RequestPath(value = \"/simple/upload\")\npublic class SimleUploadController {\n\n @RequestPath(value = \"\")\n public HttpResponse index(UploadFile uploadFile){\n if (uploadFile != null) {\n byte[] fileData = uploadFile.getData();\n File file = new File(uploadFile.getName());\n FileUtil.writeBytes(fileData, file);\n }\n HttpResponse response = TioRequestContext.getResponse();\n return response.setString(\"sucess\");\n }\n\n}\n```\n\n这段代码定义了一个处理 HTTP 请求的方法 `index`。该方法通过 `@RequestPath` 注解映射到一个空的 URL 路径（即默认路径）。它接收两个参数：一个 `UploadFile` 对象 `uploadFile` 和一个 `HttpRequest` 对象 `request`。\n\n- 方法首先检查 `uploadFile` 是否为非空，如果非空，表示有文件上传。\n- 然后，从 `uploadFile` 对象中获取文件数据（字节数组）和文件名。\n- 使用 `FileUtil.writeBytes` 方法，将文件数据写入到一个新创建的 `File` 对象中，该对象使用上传文件的名称。\n- 最后，该方法返回一个 JSON 格式的响应，内容为字符串 \"success\"。\n\n这个方法的主要功能是处理文件上传的请求，将上传的文件保存在服务器上，并返回一个表示操作成功的响应。"}
{"id":"zh/06_web/09.md#chunk-2","pageId":"zh/06_web/09.md","title":"文件上传","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/09.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/09.md","heading":"6.3.2.接受文件和包含上传参数","status":"document","sha256":"93b224d5fedf8f65a0d2f3b16b84b77a452e32adcfe292fc87a156f08cb3eb7f","content":"#### 6.3.2.接受文件和包含上传参数\n\nInputType 是 form 中的一个参数,可以省略\nInputType 是 from 中的一个参数,可以省略\n\n```\n @RequestPath(value = \"\")\n public HttpResponse index(UploadFile uploadFile, String InputType, String outputType, HttpRequest request)\n throws Exception {\n if (uploadFile != null) {\n byte[] fileData = uploadFile.getData();\n File file = new File(uploadFile.getName());\n FileUtil.writeBytes(fileData, file);\n }\n return Resps.json(request, \"success\");\n }\n```\n\n这段代码定义了一个处理 HTTP 请求的方法 `index`，它处理带有文件上传的请求。该方法接收四个参数：`UploadFile` 对象 `uploadFile`，两个字符串 `InputType` 和 `outputType`，以及一个 `HttpRequest` 对象 `request`。\n\n- 如果 `uploadFile` 不为空，方法读取上传文件的数据（字节），然后创建一个新的 `File` 对象，文件名与上传的文件名相同。\n- 使用 `FileUtil.writeBytes` 方法，将上传文件的数据写入到新创建的文件中。\n- 最后，方法返回一个 JSON 格式的响应，内容为字符串 \"success\"。"}
{"id":"zh/06_web/09.md#chunk-3","pageId":"zh/06_web/09.md","title":"文件上传","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/09.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/09.md","heading":"6.3.3.UploadFile 常用方法","status":"document","sha256":"a328aa60f83f50c93352249ea89529b9a7d5cb6d26577870466c096dc87dbcb6","content":"#### 6.3.3.UploadFile 常用方法\n\n类 `org.tio.http.common.UploadFile` 可能代表在 Web 应用程序上下文中的一个上传文件。下面是这些方法的简要说明：\n\n1. `getName()`: 这个方法返回上传文件的名称。它用于识别文件，可能基于文件名扩展名确定其类型。\n\n2. `getSize()`: 这个方法返回上传文件的大小，以字节为单位。它可以用来检查文件的大小，这对于验证目的（例如，确保文件不太大，应用程序能够处理）是必要的。\n\n3. `getData()`: 这个方法返回文件的实际数据，以字节数组的形式。它用于处理文件的内容，如将其保存到服务器上或执行任何特定于文件的操作。"}
{"id":"zh/06_web/09.md#chunk-4","pageId":"zh/06_web/09.md","title":"文件上传","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/09.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/09.md","heading":"返回文件","status":"document","sha256":"e9e5412217ed4cf9310958a0147149daf0925e0691d0295b4d32c66d278956c5","content":"## 返回文件\n\n```\n @RequestPath(value = \"/filetest\")\n public HttpResponse filetest(HttpRequest request) throws Exception {\n HttpResponse ret = Resps.file(request, new File(\"d:/tio.exe\"));\n return ret;\n }\n\n\n @RequestPath(value = \"/test.zip\")\n public HttpResponse test_zip(HttpRequest request) throws Exception {\n String root = request.httpConfig.getPageRoot(request);\n HttpResponse ret = Resps.file(request, new File(root, \"test/test.zip\"));\n return ret;\n }\n```\n\n这两个方法都涉及处理 HTTP 请求并返回文件作为响应。\n\n1. `filetest` 方法:\n\n - 通过 `@RequestPath` 注解映射到 `/filetest` URL 路径。\n - 方法使用 `Resps.file` 创建一个 `HttpResponse` 对象，该对象将发送位于 \"d:/tio.exe\" 的文件作为响应。\n\n2. `test_zip` 方法:\n - 映射到 `/test.zip` URL 路径。\n - 首先，使用 `request.httpConfig.getPageRoot` 获取服务器的根目录。\n - 然后，使用 `Resps.file` 创建 `HttpResponse` 对象，返回位于根目录下 \"test/test.zip\" 路径的文件。"}
{"id":"zh/06_web/10.md#chunk-0","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"文件下载","status":"document","sha256":"6cd4e830068206b3526abed27068808dadf25ce5e130e63af37bbdf48691d28d","content":"# 文件下载\n\n本文详细介绍了如何在 tio-boot 后端应用程序中实现文件下载功能，涵盖任意文件下载、浏览器触发下载、以及 DOCX/PDF 文件下载等多种场景，同时还展示了如何生成二维码并通过浏览器下载二维码图片。内容包括完整的代码示例和详细的原理解析，适用于希望扩展或自定义文件下载功能的开发者。\n\n---\n\n[[toc]]"}
{"id":"zh/06_web/10.md#chunk-1","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"1. 任意文件下载","status":"document","sha256":"4700a52dfd91f0e13ec2e431a8fd137853d7cffeb2ccb6b0127bf03ff30b6484","content":"## 1. 任意文件下载\n\n在一些场景下，我们可能需要实现一个通用的文件下载接口，该接口能够根据传入的参数动态读取文件并返回给客户端。下面的示例代码展示了如何读取指定文件，并将文件字节流以合适的 MIME 类型返回给浏览器。\n\n```java\npackage nexus.io.test.controller;\n\nimport java.io.File;\n\nimport nexus.io.annotation.RequestPath;\nimport nexus.io.media.NativeMedia;\nimport nexus.io.tio.boot.http.TioRequestContext;\nimport nexus.io.tio.http.common.HttpRequest;\nimport nexus.io.tio.http.common.HttpResponse;\nimport nexus.io.model.upload.UploadFile;\nimport nexus.io.tio.http.server.util.Resps;\nimport nexus.io.tio.utils.http.ContentTypeUtils;\nimport nexus.io.tio.utils.hutool.FileUtil;\nimport nexus.io.tio.utils.hutool.FilenameUtils;\n\n@RequestPath(\"/media\")\npublic class MediaController {\n\n public HttpResponse toMp3(HttpRequest request) {\n // 指定要下载的文件名称（这里以 mp3 文件为例）\n String result = \"a.mp3\";\n // 根据文件后缀获取正确的 MIME 类型\n String contentType = ContentTypeUtils.getContentType(FilenameUtils.getSuffix(result));\n // 将文件读取为字节数组\n byte[] fileBytes = FileUtil.readBytes(new File(result));\n HttpResponse response = TioRequestContext.getResponse();\n // 使用工具类将字节流和 MIME 类型设置到响应中\n Resps.bytesWithContentType(response, fileBytes, contentType);\n return response;\n }\n}\n```"}
{"id":"zh/06_web/10.md#chunk-2","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"原理说明","status":"document","sha256":"fa671ba7fa0cf5d21a628526494a1a24612a72879ab7ff83a5ef9fdcc53ea329","content":"### 原理说明\n\n- **文件读取**：使用 `FileUtil.readBytes()` 将文件转换为字节数组，适用于文件较小的场景。\n- **ContentType**：通过 `ContentTypeUtils` 根据文件后缀设置 MIME 类型，确保浏览器正确解析文件内容。\n- **响应构建**：利用 `Resps.bytesWithContentType` 工具类，封装文件字节流和 MIME 类型，返回一个 HTTP 响应。\n\n---"}
{"id":"zh/06_web/10.md#chunk-3","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"2. 通过浏览器触发文件下载","status":"document","sha256":"4f02e32cfa619efb903ccf60707c84420cc045cb51dfdfbf018e02d67837eb43","content":"## 2. 通过浏览器触发文件下载\n\n在大多数 Web 应用中，我们希望通过浏览器的下载功能直接下载文件。为此，需要在 HTTP 响应中设置特定的响应头，提示浏览器将内容作为附件下载。"}
{"id":"zh/06_web/10.md#chunk-4","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"示例代码","status":"document","sha256":"0017ddaae6cddbf8fab41ac8a954a98d1c129e0feb5799d4b24cef5e7cb7adbe","content":"### 示例代码\n\n```java\npackage nexus.io.linux.handler;\n\nimport java.io.File;\n\nimport nexus.io.tio.boot.http.TioRequestContext;\nimport nexus.io.tio.http.common.HttpRequest;\nimport nexus.io.tio.http.common.HttpResponse;\nimport nexus.io.tio.utils.http.ContentTypeUtils;\nimport nexus.io.tio.utils.hutool.FileUtil;\nimport nexus.io.tio.utils.hutool.FilenameUtils;\n\nimport lombok.extern.slf4j.Slf4j;\n\n@Slf4j\npublic class DownloadHandler {\n\n public HttpResponse donwload(HttpRequest httpRequest) {\n\n HttpResponse httpResponse = TioRequestContext.getResponse();\n String downloadFilename = \"readme.md\";\n File file = new File(downloadFilename);\n\n String suffix = FilenameUtils.getSuffix(downloadFilename);\n // 设置响应内容类型，此处使用 Markdown 格式\n String contentType = ContentTypeUtils.getContentType(suffix);\n log.info(\"filename:{},{}\", downloadFilename, contentType);\n \n \n // 设置 Content-Type 响应头，确保浏览器以正确格式解析文件内容\n httpResponse.setContentType(contentType);\n // 设置 Content-Disposition 响应头，告知浏览器将内容作为附件下载，并指定默认文件名\n httpResponse.setAttachmentFilename(downloadFilename);\n // 设置响应体内容，实际项目中可替换为文件的字节流\n httpResponse.setBody(FileUtil.readBytes(file));\n\n return httpResponse;\n }\n}\n```"}
{"id":"zh/06_web/10.md#chunk-5","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"原理说明","status":"document","sha256":"64f262dc9acf10972965167e8fd2e879b41642d281940f8393c83ceb2a982638","content":"### 原理说明\n\n- **Content-Disposition**：设置为 `attachment` 告知浏览器将文件作为附件下载，同时 `filename` 参数指定了默认的文件名称。\n- **Content-Type**：确保返回的内容格式与文件实际类型相匹配，从而使下载后的文件能够被正确识别。\n\nhttp响应头\n```\ncontent-disposition:attachment; filename=\"readme.md\"\ncontent-type:application/octet-stream\n```\n---"}
{"id":"zh/06_web/10.md#chunk-6","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"3. 文档下载","status":"document","sha256":"6836d2888a8be4c10aeb4965fed6c3fb92c4209b305d3180f0d491c2c1641f55","content":"## 3. 文档下载\n\n针对常见的文档文件（如 DOCX 和 PDF），可以根据文件 ID 动态获取文件内容，并返回给客户端。以下分别介绍 DOCX 和 PDF 文件下载的实现方法。"}
{"id":"zh/06_web/10.md#chunk-7","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"3.1 下载 DOCX 文件","status":"document","sha256":"288f3c13fff5f94b3c20d83f605a80e4efc2ed3b7c2331b3b90ef2860e7cdbed","content":"### 3.1 下载 DOCX 文件"}
{"id":"zh/06_web/10.md#chunk-8","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"示例代码","status":"document","sha256":"7f5433d61ee1cc6e8d261274c62867c64cccd2fd2f3a8465dfd79ad81e017559","content":"#### 示例代码\n\n```java\n@RequestPath(\"/download/docx/{id}\")\npublic HttpResponse download(String id, HttpRequest request) {\n // 根据传入的 id 动态获取 DOCX 文件的输入流\n InputStream inputStream = ResourceUtil.getStream(id+\".docx\");\n int available;\n try {\n available = inputStream.available();\n byte[] fileBytes = new byte[available];\n // 将文件内容读取到字节数组中\n inputStream.read(fileBytes, 0, available);\n // 设置 DOCX 文件的 MIME 类型\n String contentType = \"application/vnd.openxmlformats-officedocument.wordprocessingml.document; charset=utf-8\";\n HttpResponse response = Resps.bytesWithContentType(request, fileBytes, contentType);\n return response;\n } catch (IOException e) {\n e.printStackTrace();\n // 文件读取异常时返回错误 JSON 响应\n return Resps.json(request, RespBodyVo.fail(\"Error generating captcha\"));\n }\n}\n```"}
{"id":"zh/06_web/10.md#chunk-9","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"3.2 下载 PDF 文件","status":"document","sha256":"0860872b08888423be9ffbb8849ccad8513f93eeb376525eddbaa4c27a2e02d1","content":"### 3.2 下载 PDF 文件"}
{"id":"zh/06_web/10.md#chunk-10","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"示例代码","status":"document","sha256":"59c32815115d39325aba61da8a60671eb73a1d2912c5331c9af4b4a2c4a988a1","content":"#### 示例代码\n\n```java\n@RequestPath(\"/download/pdf/{id}\")\npublic HttpResponse downloadPdf(String id, HttpRequest request) {\n log.info(\"id:{}\", id);\n // 从资源路径中动态读取 PDF 文件（假设文件存放在 pdf 目录下）\n InputStream inputStream = ResourceUtil.getStream(\"pdf/\" + id + \".pdf\");\n int available;\n try {\n available = inputStream.available();\n byte[] fileBytes = new byte[available];\n // 将文件内容读取到字节数组中\n inputStream.read(fileBytes, 0, available);\n // 设置 PDF 文件的 MIME 类型\n HttpResponse response = Resps.bytesWithContentType(request, fileBytes, \"application/pdf; charset=utf-8\");\n return response;\n } catch (IOException e) {\n e.printStackTrace();\n // 文件读取异常时返回错误 JSON 响应\n return Resps.json(request, RespBodyVo.fail(\"Error generating captcha\"));\n }\n}\n```"}
{"id":"zh/06_web/10.md#chunk-11","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"原理说明","status":"document","sha256":"bae9370ade523bc7fa75e3b40b2f68cd35add1c74e98e0f3b7ec35764825671f","content":"### 原理说明\n\n- **资源获取**：利用 `ResourceUtil.getStream()` 方法根据文件名或路径获取文件的输入流，适用于存储在项目资源中的文件。\n- **字节流读取**：调用 `inputStream.available()` 获取可读取的字节数，并一次性读取文件内容。对于大文件，应考虑使用流式传输以避免内存压力。\n- **错误处理**：在读取过程中捕获异常，并返回格式化的错误响应，确保接口的健壮性。"}
{"id":"zh/06_web/10.md#chunk-12","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"3.3 用文档类型方法直接下载","status":"document","sha256":"17ef30141e238a0ed73376640612bd051a757a1ecdc1f4ade07e83686fd14a2b","content":"### 3.3 用文档类型方法直接下载\n\n`Resps` 为常用文档类型准备了快捷方法：一行写完 Content-Type 与附件文件名，不需要自己拼字符串。文件名里的中文会按 UTF-8 编码写入响应头：\n\n```java\nimport java.io.InputStream;\n\nimport nexus.io.annotation.Post;\nimport nexus.io.annotation.RequestPath;\nimport nexus.io.tio.boot.http.TioRequestContext;\nimport nexus.io.tio.http.common.HttpResponse;\nimport nexus.io.tio.http.server.util.Resps;\nimport nexus.io.tio.utils.hutool.ResourceUtil;\n\n@RequestPath(\"/download\")\npublic class DocumentDownloadController {\n\n @Post(\"/docx/{id}\")\n public HttpResponse docx(String id) {\n byte[] bytes = read(ResourceUtil.getStream(id + \".docx\"));\n return Resps.docx(TioRequestContext.getResponse(), bytes, id + \".docx\");\n }\n\n @Post(\"/pdf/{id}\")\n public HttpResponse pdf(String id) {\n byte[] bytes = read(ResourceUtil.getStream(\"pdf/\" + id + \".pdf\"));\n return Resps.pdf(TioRequestContext.getResponse(), bytes, id + \".pdf\");\n }\n\n private byte[] read(InputStream inputStream) {\n try (InputStream in = inputStream) {\n return in.readAllBytes();\n } catch (java.io.IOException e) {\n throw new IllegalStateException(\"读取文件失败\", e);\n }\n }\n}\n```\n\n同一组方法还有 `excel`、`excelXls`、`pptx`、`ppt`、`image`，以及通用的 `download(response, bytes, contentType, filename)`；完整清单见 [Resps]()。\n\n---"}
{"id":"zh/06_web/10.md#chunk-13","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"4. 生成二维码并下载","status":"document","sha256":"522a227665027ffbd58caf2500012eb82a379f6ee14fc38ee3e711603eefe3ef","content":"## 4. 生成二维码并下载\n\n除了常规的文件下载外，有时还需要动态生成图片（例如二维码）并返回给客户端。下面以二维码生成为例，展示如何使用 ZXing 库生成二维码图片，并通过 HTTP 响应返回。"}
{"id":"zh/06_web/10.md#chunk-14","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"前置准备","status":"document","sha256":"3a512f5870aa10ca7e6f2cb6ecf2093510b1843b6f866594878c3f3b335775b8","content":"### 前置准备\n\n请确保项目中已添加以下依赖："}
{"id":"zh/06_web/10.md#chunk-15","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"Maven 依赖示例","status":"document","sha256":"53d0fd7544c079f02f186bf88215b818288e22b53f104c5a420d23778302c3e1","content":"#### Maven 依赖示例\n\n```xml\n\n \n \n com.google.zxing\n core\n 3.4.1\n \n \n com.google.zxing\n javase\n 3.4.1\n \n\n \n \n nexus.io\n tio-boot\n 最新版本\n \n\n```"}
{"id":"zh/06_web/10.md#chunk-16","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"QrController 实现","status":"document","sha256":"3b497e7c3e09dbf475706b2f7a2119cff174abe730a77f391fe6fc93b5f0418d","content":"### QrController 实现"}
{"id":"zh/06_web/10.md#chunk-17","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"示例代码","status":"document","sha256":"f0d2f1fbf651505943e787fc07838466f15c99f2c1635bc30dfa143cb58c8081","content":"#### 示例代码\n\n```java\npackage nexus.io.test.controller;\n\nimport java.io.ByteArrayOutputStream;\nimport java.io.IOException;\n\nimport nexus.io.annotation.AController;\nimport nexus.io.annotation.RequestPath;\nimport nexus.io.model.body.RespBodyVo;\nimport nexus.io.tio.boot.http.TioRequestContext;\nimport nexus.io.tio.http.common.HttpResponse;\nimport nexus.io.tio.http.server.util.Resps;\nimport nexus.io.tio.utils.hutool.StrUtil;\nimport nexus.io.tio.utils.qrcode.QrCodeUtils;\n\n@AController\n@RequestPath(\"/qr\")\npublic class QrController {\n\n @RequestPath(\"/gen\")\n public HttpResponse qr(String content) {\n HttpResponse response = TioRequestContext.getResponse();\n // 验证二维码内容不能为空\n if (StrUtil.isBlank(content)) {\n return Resps.json(response, RespBodyVo.fail(\"No content provided for QR code\"));\n }\n\n try (ByteArrayOutputStream outputStream = new ByteArrayOutputStream()) {\n // 生成二维码图片，并写入到输出流中，二维码尺寸为 300x300 像素\n QrCodeUtils.generateQRCode(content, 300, 300, outputStream);\n\n // 将输出流转换为字节数组\n byte[] qrCodeBytes = outputStream.toByteArray();\n\n // 使用工具类返回包含二维码图片字节流的响应，设置 MIME 类型为 image/png\n return Resps.bytesWithContentType(response, qrCodeBytes, \"image/png\");\n\n } catch (IOException e) {\n e.printStackTrace();\n return Resps.json(response, RespBodyVo.fail(\"Error generating QR code\"));\n }\n }\n}\n```"}
{"id":"zh/06_web/10.md#chunk-18","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"原理说明","status":"document","sha256":"41d022da93b4c996a3be3ba54a748c333bf71d8623869445b8ed326f3756ccb8","content":"### 原理说明\n\n- **二维码生成**：利用 ZXing 库生成二维码图片，通过 `QrCodeUtils.generateQRCode()` 方法将二维码内容写入输出流中。\n- **流转换**：将 `ByteArrayOutputStream` 中的内容转换为字节数组，方便后续通过 HTTP 响应返回给客户端。\n- **响应设置**：设置正确的 MIME 类型 `\"image/png\"`，确保浏览器能够识别并显示图片内容。\n\n---"}
{"id":"zh/06_web/10.md#chunk-19","pageId":"zh/06_web/10.md","title":"文件下载","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/10.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/10.md","heading":"5. 总结","status":"document","sha256":"a88365be3552f7b1b8a115fbea749f9e2b797bea3906c0531433123bd37074cf","content":"## 5. 总结\n\n通过以上示例，我们可以看到在 Java Web 应用中实现文件下载功能的关键步骤：\n\n1. **定义请求路径**：通过注解或路由配置定义对应的 URL 接口。\n2. **读取文件**：根据实际需求读取服务器中的文件，支持任意文件、DOCX、PDF、二维码图片等。\n3. **设置响应头**：重点在于设置 `Content-Type` 和 `Content-Disposition` 响应头，确保浏览器能够正确识别文件类型并触发下载。\n4. **返回响应内容**：将读取的字节流写入 HTTP 响应体中，完成文件传输。\n5. **错误处理**：合理捕获异常并返回友好的错误提示，提升接口的健壮性和用户体验。\n\n通过正确的设置和处理，开发者可以在项目中灵活扩展文件下载功能，同时确保安全性和性能。希望本文能为您提供清晰的实现思路和实践参考。"}
{"id":"zh/06_web/11.md#chunk-0","pageId":"zh/06_web/11.md","title":"返回视频文件并支持断点续传","chapter":"zh/06_web","url":"https://tio-boot.com/zh/06_web/11.html","markdownUrl":"https://tio-boot.com/ai/pages/zh/06_web/11.md","heading":"返回视频文件并支持断点续传","status":"document","sha256":"b3c0f68dbd2158ef73f85afed53461e34f2db658064232939b7229a879293588","content":"# 返回视频文件并支持断点续传\n\n本文档介绍如何通过 TioBoot Handler 返回视频文件，支持 HTTP Range 断点续传，以便前端页面使用 `