{"version":"0.0.0","data":{"0":{"ops":[{"insert":"异步处理（"},{"attributes":{"inlineCode":"true"},"insert":"ve-tos-cpp-sdk"},{"insert":"）是指程序执行一个任务时，不需要等待该任务完成就能继续执行其他任务。本文介绍如何使用进行异步处理的场景，例如文件上传/下载、AsyncEvent 暂停/恢复、基础对象上传/下载等。\n"},{"insert":"*","attributes":{"anchor":"#82042765","lmkr":"1","heading":"h2"}},{"insert":"注意事项\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"目前异步 SDK 仅支持 Linux 平台。若在非 Linux 平台尝试开启"},{"attributes":{"inlineCode":"true"},"insert":" -DBUILD_ASYNC_SDK=ON"},{"insert":" 选项，编译过程将直接报错，以避免误编译不可用的异步代码。\n"},{"attributes":{"lmkr":"1","list":"bullet1"},"insert":"*"},{"insert":"设置 "},{"attributes":{"inlineCode":"true"},"insert":"BUILD_ASYNC_SDK=ON"},{"insert":" 时，系统会同时编译同步 SDK 与异步 SDK。\n"},{"attributes":{"list":"bullet1","lmkr":"1","align":"left"},"insert":"*"},{"insert":"回调中返回 0 必须配合 "},{"attributes":{"inlineCode":"true"},"insert":"AsyncEvent"},{"insert":" 暂停机制使用。\n"},{"insert":"*","attributes":{"anchor":"#e690b8a9","lmkr":"1","align":"left","heading":"h2"}},{"insert":"能力概览\n"},{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":"异步 SDK 通过 "},{"attributes":{"inlineCode":"true"},"insert":"VolcengineTos::TosAsyncClient"},{"insert":" 提供接口，采用立即返回加回调（Callback）的交互风格。\n"},{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":"目前支持的主要功能如下：\n"},{"attributes":{"aceTable":"rski9ivwubtj970ffc2uz13apegl92em6u cs32vrolwvg8dkk05tjbqm6tey7fmq1cbo"},"insert":"*"},{"insert":"\n"},{"insert":"*","attributes":{"anchor":"#728b439b","heading":"h2","lmkr":"1"}},{"insert":"兼容性说明\n"},{"insert":"默认构建配置下不会启用异步 SDK。相关构建命令如下：\n"},{"insert":" ","attributes":{"type":"codeblock","language":"Shell","zoneId":"wkhbsiko66","wrap":"true","parentZoneId":"0"}},{"insert":"\n"},{"insert":"在默认构建模式下：\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"不编译 TosAsyncClient。\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"不安装异步相关的公共头文件。\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"不依赖 liburing 库。\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"原有同步 SDK 的构建和使用方式保持不变。\n"},{"attributes":{"comment":"true","comment-id":"alpoQsc1XiG"},"insert":"若需显式指定仅编译异步 SDK，可通过以下命令进"},{"insert":"行：\n"},{"insert":" ","attributes":{"type":"codeblock","language":"Shell","zoneId":"dg2pf08hfi","wrap":"true","parentZoneId":"0"}},{"insert":"\n"},{"insert":"*","attributes":{"anchor":"#aeac410d","lmkr":"1","heading":"h3"}},{"insert":"io_uring 支持说明\n"},{"attributes":{"inlineCode":"true"},"insert":"io_uring "},{"insert":"为可选特性，其生效状态由编译"},{"attributes":{"comment":"true","comment-id":"a4bjNHSt4qe"},"insert":"期"},{"insert":"及运行时环境共同决定。\n"},{"insert":"编译参数："},{"attributes":{"inlineCode":"true"},"insert":"-DBUILD_ASYNC_SDK_IO_URING=AUTO "},{"insert":"\n"},{"insert":"该参数支持以下可选值：\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"AUTO"},{"insert":"：默认设置。若系统环境中存在"},{"attributes":{"inlineCode":"true"},"insert":" liburing.h"},{"insert":" 及 liburing 库则自动启用，否则自动关闭。\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"ON"},{"insert":"：强制启用。若环境中缺少 liburing 库，CMake 将在编译时报错。\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"attributes":{"inlineCode":"true"},"insert":"OFF"},{"insert":"：强制关闭。\n"},{"insert":"即使在编译期启用了 "},{"attributes":{"inlineCode":"true"},"insert":"io_uring "},{"insert":"特性，系统在运行时仍会检查当前环境是否真实支持。若运行时不可用且文件后端机制配置为 "},{"attributes":{"inlineCode":"true"},"insert":"AUTO"},{"insert":"，系统会自动回退至其他可用的实现路径。\n"},{"insert":"*","attributes":{"anchor":"#46ccfa0f","lmkr":"1","heading":"h2"}},{"insert":"依赖说明\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"异步 SDK 的可选依赖，仅在使用 "},{"attributes":{"inlineCode":"true"},"insert":"io_uring "},{"insert":"后端机制时才需配置 "},{"attributes":{"inlineCode":"true"},"insert":"liburing "},{"insert":"库。\n"},{"attributes":{"comment":"true","comment-id":"amEJA9Z2ZRr"},"insert":"在 "},{"attributes":{"comment":"true","comment-id":"amEJA9Z2ZRr","inlineCode":"true"},"insert":"Debian "},{"attributes":{"comment":"true","comment-id":"amEJA9Z2ZRr"},"insert":"或 "},{"attributes":{"comment":"true","comment-id":"amEJA9Z2ZRr","inlineCode":"true"},"insert":"Ubuntu "},{"attributes":{"comment":"true","comment-id":"amEJA9Z2ZRr"},"insert":"环境下的依赖安装示例如下："},{"insert":"\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"若需使用 "},{"attributes":{"inlineCode":"true"},"insert":"io_uring "},{"insert":"特性，请运行以下命令安装相关依赖。\n"},{"attributes":{"lmkr":"1","list":"indent1","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"language":"Shell","type":"codeblock","zoneId":"7vz7uvtlgq","wrap":"true","parentZoneId":"0"}},{"insert":"\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"若无需使用 "},{"attributes":{"inlineCode":"true"},"insert":"io_uring "},{"insert":"特性，请运行以下命令安装基础依赖即可。\n"},{"attributes":{"lmkr":"1","list":"indent1","text-indent":"true"},"insert":"*"},{"insert":" ","attributes":{"language":"Shell","type":"codeblock","zoneId":"gimo8s9h7u","wrap":"true","parentZoneId":"0"}},{"insert":"\n"},{"insert":"\n"},{"insert":"*","attributes":{"anchor":"#c49ff472","lmkr":"1","heading":"h2"}},{"insert":"初始化与释放\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"在进程启动后，您需要全局调用一次初始化接口："},{"attributes":{"inlineCode":"true"},"insert":"InitializeTosAsyncClient()"},{"insert":"。\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"单个客户端实例使用完毕后，可调用关闭接口释放资源："},{"attributes":{"inlineCode":"true"},"insert":"client.close()"},{"insert":"。\n"},{"attributes":{"list":"bullet1","lmkr":"1"},"insert":"*"},{"insert":"在进程退出前，您需要全局调用一次清理接口："},{"attributes":{"inlineCode":"true"},"insert":"CloseTosAsyncClient()"},{"insert":"。\n"},{"insert":"推荐的客户端生命周期管理示例如下：\n"},{"insert":" ","attributes":{"type":"codeblock","language":"Shell","zoneId":"pz26mdmvzd","wrap":"true","parentZoneId":"0"}},{"insert":"\n"},{"insert":"*","attributes":{"anchor":"#9da5c20f","lmkr":"1","heading":"h2"}},{"insert":"ClientConfig 常用配置\n"},{"insert":" ","attributes":{"type":"codeblock","language":"Shell","zoneId":"yv3cdztuuu","wrap":"true","parentZoneId":"0"}},{"insert":"\n"},{"insert":"相关参数的说明如下：\n"},{"attributes":{"aceTable":"rs9vcrbgbbn97lzffdwi4vu78kmowh4tuo cs38f32otjhdlqn61kqk1kd6n9rb2v88ku"},"insert":"*"},{"insert":"\n"},{"insert":"*","attributes":{"anchor":"#ff800670","heading":"h2","lmkr":"1"}},{"insert":"示例代码\n"},{"insert":" ","attributes":{"zoneType":"Z","tabsZoneId":"RsN2vGYZeQ","doc-tabs":"true","tabs":"true"}},{"insert":"\n"},{"insert":"*","attributes":{"anchor":"#3ad83926","lmkr":"1","align":"left","heading":"h2"}},{"insert":"常见问题\n"},{"insert":"*","attributes":{"anchor":"#0c4b439b","lmkr":"1","align":"left","heading":"h3"}},{"insert":"只想使用同步 SDK，编译方式要改吗？\n"},{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":"无需更改。系统默认设置 "},{"attributes":{"inlineCode":"true"},"insert":"BUILD_ASYNC_SDK=OFF"},{"insert":"，原有同步 SDK 的构建方式保持不变。\n"},{"insert":"*","attributes":{"anchor":"#60bc8957","lmkr":"1","align":"left","heading":"h3"}},{"insert":"打开异步 SDK 后，同步 SDK 还能用吗？\n"},{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":"同步 SDK 仍可正常使用。设置 "},{"attributes":{"inlineCode":"true"},"insert":"BUILD_ASYNC_SDK=ON"},{"insert":" 时，系统会同时编译同步 SDK 与异步 SDK。\n"},{"insert":"*","attributes":{"anchor":"#c3814e20","lmkr":"1","align":"left","heading":"h3"}},{"insert":"可以强制不用 io_uring 吗？\n"},{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":"您可以强制禁用"},{"attributes":{"inlineCode":"true"},"insert":" io_uring"},{"insert":" 特性。在编译期，可通过以下命令禁用该特性：\n"},{"insert":" ","attributes":{"language":"Plain Text","type":"codeblock","zoneId":"pmsnpfsdwe"}},{"insert":"\n"},{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":"在运行时，也可通过代码指定其他后端机制：\n"},{"insert":" ","attributes":{"language":"Plain Text","type":"codeblock","zoneId":"r21rpr4osg"}},{"insert":"\n"},{"insert":"*","attributes":{"anchor":"#84c7f344","lmkr":"1","align":"left","heading":"h3"}},{"insert":"callback 会在哪个线程执行？\n"},{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":"异步 HTTP 回调由 SDK 的异步 worker 线程触发。请避免在业务回调中执行长时间的阻塞操作；若需等待外部数据或下游消费能力，建议使用 "},{"attributes":{"inlineCode":"true"},"insert":"AsyncEvent::PauseFor() "},{"insert":"或配合使用"},{"attributes":{"inlineCode":"true"},"insert":" Pause()"},{"insert":" 与 "},{"attributes":{"inlineCode":"true"},"insert":"Resume()"},{"insert":"。\n"},{"insert":"*","attributes":{"anchor":"#073f3aa6","lmkr":"1","align":"left","heading":"h3"}},{"insert":"回调里返回 0 是什么意思？\n"},{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":"回调中返回 0 必须配合 "},{"attributes":{"inlineCode":"true"},"insert":"AsyncEvent"},{"insert":" 暂停机制使用。若在未显式暂停的情况下长期返回 0，SDK 会将其视为数据生产或消费异常"},{"attributes":{"comment":"true","comment-id":"aMoLnKaE06q"},"insert":"。"},{"insert":"\n"},{"insert":"\n"}],"zoneId":"0","zoneType":"Z"},"rski9ivwubtj970ffc2uz13apegl92em6u":{"ops":[{"attributes":{"colWidth":"100"},"insert":{"id":"r109wkr1vmc2y5ccy4rcm162dbc3vh6yr8"}},{"attributes":{"colWidth":"100"},"insert":{"id":"r1e7w3cro6fgiw8gj32z2grnn3dscctwti"}},{"insert":{"id":"r1csujyh00we7heo9iuuz7l0n28698dsrb"}},{"insert":{"id":"r1i7vqondq6nuu2v1utjyiv24hehilryvq"}},{"insert":{"id":"r1f5ifc6ynm48uflz061vzkmzsr0zcz0ym"}},{"insert":{"id":"r126ynnu2fn8q7vu2mv1rz3sp1tmgrwvq3"}},{"insert":{"id":"r1lbkt8zp6gtdgw5otclolfy3wjrf0er5z"}},{"insert":{"id":"r1d7d0jotr5bb1k0sbiqzidgjmd5l61368"}},{"insert":{"id":"r1ht6zlohut25s8yuafe40ujzu2dkhm5j5"}}],"zoneId":"rski9ivwubtj970ffc2uz13apegl92em6u","zoneType":"R"},"cs32vrolwvg8dkk05tjbqm6tey7fmq1cbo":{"ops":[{"attributes":{"colWidth":"188"},"insert":{"id":"c1ak5bkjb34cdfajn64vo9uobvln8k78y0"}},{"attributes":{"colWidth":"672"},"insert":{"id":"c1sw1drz6vj8yrye76tzzbmvcyo1mvwjys"}}],"zoneId":"cs32vrolwvg8dkk05tjbqm6tey7fmq1cbo","zoneType":"C"},"xr109wkr1vmc2y5ccy4rcm162dbc3vh6yr8xc1ak5bkjb34cdfajn64vo9uobvln8k78y0":{"ops":[{"insert":"功能\n"}],"zoneId":"xr109wkr1vmc2y5ccy4rcm162dbc3vh6yr8xc1ak5bkjb34cdfajn64vo9uobvln8k78y0","zoneType":"Z"},"xr109wkr1vmc2y5ccy4rcm162dbc3vh6yr8xc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys":{"ops":[{"insert":"操作\n"}],"zoneId":"xr109wkr1vmc2y5ccy4rcm162dbc3vh6yr8xc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys","zoneType":"Z"},"xr1e7w3cro6fgiw8gj32z2grnn3dscctwtixc1ak5bkjb34cdfajn64vo9uobvln8k78y0":{"ops":[{"attributes":{"align":"left","lmkr":"1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"存储桶（Bucket）管理\n"}],"zoneId":"xr1e7w3cro6fgiw8gj32z2grnn3dscctwtixc1ak5bkjb34cdfajn64vo9uobvln8k78y0","zoneType":"Z"},"xr1e7w3cro6fgiw8gj32z2grnn3dscctwtixc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys":{"ops":[{"attributes":{"inlineCode":"true"},"insert":"createBucketAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"headBucketAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"getBucketTypeAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"listBucketsAsync"},{"insert":"\n"}],"zoneId":"xr1e7w3cro6fgiw8gj32z2grnn3dscctwtixc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys","zoneType":"Z"},"xr1csujyh00we7heo9iuuz7l0n28698dsrbxc1ak5bkjb34cdfajn64vo9uobvln8k78y0":{"ops":[{"attributes":{"align":"left","lmkr":"1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"对象操作（Object）\n"}],"zoneId":"xr1csujyh00we7heo9iuuz7l0n28698dsrbxc1ak5bkjb34cdfajn64vo9uobvln8k78y0","zoneType":"Z"},"xr1csujyh00we7heo9iuuz7l0n28698dsrbxc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys":{"ops":[{"attributes":{"inlineCode":"true"},"insert":"putObjectAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"getObjectAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"headObjectAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"deleteObjectAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"copyObjectAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"setObjectMetaAsync"},{"insert":"\n"}],"zoneId":"xr1csujyh00we7heo9iuuz7l0n28698dsrbxc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys","zoneType":"Z"},"xr1i7vqondq6nuu2v1utjyiv24hehilryvqxc1ak5bkjb34cdfajn64vo9uobvln8k78y0":{"ops":[{"attributes":{"align":"left","lmkr":"1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"列举操作\n"}],"zoneId":"xr1i7vqondq6nuu2v1utjyiv24hehilryvqxc1ak5bkjb34cdfajn64vo9uobvln8k78y0","zoneType":"Z"},"xr1i7vqondq6nuu2v1utjyiv24hehilryvqxc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys":{"ops":[{"attributes":{"inlineCode":"true"},"insert":"listObjectsAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"listObjectsType2Async"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"listObjectVersionsAsync"},{"insert":"\n"}],"zoneId":"xr1i7vqondq6nuu2v1utjyiv24hehilryvqxc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys","zoneType":"Z"},"xr1f5ifc6ynm48uflz061vzkmzsr0zcz0ymxc1ak5bkjb34cdfajn64vo9uobvln8k78y0":{"ops":[{"attributes":{"align":"left","lmkr":"1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"分层命名空间（HNS）\n"}],"zoneId":"xr1f5ifc6ynm48uflz061vzkmzsr0zcz0ymxc1ak5bkjb34cdfajn64vo9uobvln8k78y0","zoneType":"Z"},"xr1f5ifc6ynm48uflz061vzkmzsr0zcz0ymxc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys":{"ops":[{"attributes":{"inlineCode":"true"},"insert":"Append "},{"insert":"、 "},{"attributes":{"inlineCode":"true"},"insert":"Modify "},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"Rename "},{"insert":"、 "},{"attributes":{"inlineCode":"true"},"insert":"Symlink "},{"insert":"、 "},{"attributes":{"inlineCode":"true"},"insert":"FileStatus"},{"insert":"\n"}],"zoneId":"xr1f5ifc6ynm48uflz061vzkmzsr0zcz0ymxc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys","zoneType":"Z"},"xr126ynnu2fn8q7vu2mv1rz3sp1tmgrwvq3xc1ak5bkjb34cdfajn64vo9uobvln8k78y0":{"ops":[{"attributes":{"align":"left","lmkr":"1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"分片上传\n"}],"zoneId":"xr126ynnu2fn8q7vu2mv1rz3sp1tmgrwvq3xc1ak5bkjb34cdfajn64vo9uobvln8k78y0","zoneType":"Z"},"xr126ynnu2fn8q7vu2mv1rz3sp1tmgrwvq3xc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys":{"ops":[{"attributes":{"inlineCode":"true"},"insert":"createMultipartUploadAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"uploadPartAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"uploadPartFromFdRangeAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"completeMultipartUploadAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"abortMultipartUploadAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"uploadPartCopyUploadAsync"},{"insert":"\n"}],"zoneId":"xr126ynnu2fn8q7vu2mv1rz3sp1tmgrwvq3xc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys","zoneType":"Z"},"xr1lbkt8zp6gtdgw5otclolfy3wjrf0er5zxc1ak5bkjb34cdfajn64vo9uobvln8k78y0":{"ops":[{"attributes":{"align":"left","lmkr":"1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"文件传输\n"}],"zoneId":"xr1lbkt8zp6gtdgw5otclolfy3wjrf0er5zxc1ak5bkjb34cdfajn64vo9uobvln8k78y0","zoneType":"Z"},"xr1lbkt8zp6gtdgw5otclolfy3wjrf0er5zxc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys":{"ops":[{"attributes":{"inlineCode":"true"},"insert":"putObjectFromFileAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"getObjectToFileAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"putObjectFromFdRangeAsync"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"getObjectToFdRangeAsync"},{"insert":"\n"}],"zoneId":"xr1lbkt8zp6gtdgw5otclolfy3wjrf0er5zxc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys","zoneType":"Z"},"xr1d7d0jotr5bb1k0sbiqzidgjmd5l61368xc1ak5bkjb34cdfajn64vo9uobvln8k78y0":{"ops":[{"attributes":{"align":"left","lmkr":"1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"文件 IO Backend\n"}],"zoneId":"xr1d7d0jotr5bb1k0sbiqzidgjmd5l61368xc1ak5bkjb34cdfajn64vo9uobvln8k78y0","zoneType":"Z"},"xr1d7d0jotr5bb1k0sbiqzidgjmd5l61368xc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys":{"ops":[{"attributes":{"inlineCode":"true"},"insert":"posix"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"mmap"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"io_uring"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"auto"},{"insert":"\n"}],"zoneId":"xr1d7d0jotr5bb1k0sbiqzidgjmd5l61368xc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys","zoneType":"Z"},"xr1ht6zlohut25s8yuafe40ujzu2dkhm5j5xc1ak5bkjb34cdfajn64vo9uobvln8k78y0":{"ops":[{"attributes":{"align":"left","lmkr":"1","start":"1","origin-start":"1"},"insert":"*"},{"insert":"动态凭证鉴权\n"}],"zoneId":"xr1ht6zlohut25s8yuafe40ujzu2dkhm5j5xc1ak5bkjb34cdfajn64vo9uobvln8k78y0","zoneType":"Z"},"xr1ht6zlohut25s8yuafe40ujzu2dkhm5j5xc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys":{"ops":[{"insert":" "},{"attributes":{"inlineCode":"true"},"insert":"Credentials"},{"insert":" 、"},{"attributes":{"inlineCode":"true"},"insert":"FederationCredentials"},{"insert":" 、"},{"attributes":{"inlineCode":"true"},"insert":"FederationTokenProvider"},{"insert":"\n"}],"zoneId":"xr1ht6zlohut25s8yuafe40ujzu2dkhm5j5xc1sw1drz6vj8yrye76tzzbmvcyo1mvwjys","zoneType":"Z"},"wkhbsiko66":{"ops":[{"insert":"cmake -S . -B build -DCMAKE_BUILD_TYPE=Release\n"},{"insert":"cmake --build build -j\n"}],"zoneId":"wkhbsiko66","zoneType":"Z"},"dg2pf08hfi":{"ops":[{"insert":"cmake -S . -B build_sync -DBUILD_ASYNC_SDK=ON -DCMAKE_BUILD_TYPE=Release\n"},{"insert":"cmake --build build_sync -j\n"}],"zoneId":"dg2pf08hfi","zoneType":"Z"},"7vz7uvtlgq":{"ops":[{"insert":"sudo apt-get update\n"},{"insert":"sudo apt-get install -y cmake g++ libcurl4-openssl-dev libssl-dev liburing-dev\n"}],"zoneId":"7vz7uvtlgq","zoneType":"Z"},"gimo8s9h7u":{"ops":[{"insert":"sudo apt-get install -y cmake g++ libcurl4-openssl-dev libssl-dev\n"}],"zoneId":"gimo8s9h7u","zoneType":"Z"},"pz26mdmvzd":{"ops":[{"insert":"InitializeTosAsyncClient();\n"},{"insert":"{\n"},{"insert":" TosAsyncClient client(region, access_key, secret_key, config);\n"},{"insert":" // use client\n"},{"insert":" client.close();\n"},{"insert":"}\n"},{"insert":"CloseTosAsyncClient();\n"}],"zoneId":"pz26mdmvzd","zoneType":"Z"},"yv3cdztuuu":{"ops":[{"insert":"ClientConfig config;\n"},{"insert":"config.endPoint = \"http://tos-cn-beijing.ivolces.com\";\n"},{"insert":"config.enableCRC = "},{"attributes":{"grammarly-data":"{\"id\":\"31bf16a3-0721-4002-a6b9-f994582a4317\",\"operation\":\"replace\",\"origin_text\":\"true;\",\"replace_text\":\"true;unmotivated\",\"rule_id\":\"1004\",\"rule_description\":\"Possible Grammar Issue@20260603164907F5DF86232456A933C734@en@19@0\",\"is_ignore\":0}"},"insert":"true;"},{"insert":"\n"},{"insert":"config.maxRetryCount = 3;\n"},{"insert":"config.connectionTimeout = 10000;\n"},{"insert":"config.socketTimeout = 30000;\n"},{"insert":"config.requestTimeout = 0;\n"},{"insert":"config.maxConnections = 64;\n"},{"insert":"\n"},{"insert":"config.event_thread_count_ = 8;\n"},{"insert":"config.max_request_queue_ = 0;\n"},{"insert":"config.connection_reuse_ = true;\n"},{"insert":"config.detail_log_ = false;\n"},{"insert":"config.curl_multi_wait_timeout_ms_ = 10;\n"},{"insert":"config.async_transport_mode_ = AsyncTransportMode::Isolated;\n"},{"insert":"\n"},{"insert":"config.fileTransferBackend = \"auto\";\n"},{"insert":"config.fileTransferChunkSize = 1024 * 1024;\n"},{"insert":"config.fileTransferIoDepth = 8;\n"},{"insert":"config.fileTransferAutoUploadIoUringMaxBytes = 0;\n"}],"zoneId":"yv3cdztuuu","zoneType":"Z"},"rs9vcrbgbbn97lzffdwi4vu78kmowh4tuo":{"ops":[{"attributes":{"colWidth":"100"},"insert":{"id":"r1p4kgkob64qa51b1a5fy7l2j8ytujljvk"}},{"attributes":{"colWidth":"100"},"insert":{"id":"r13eqsd8gh81873cr300wf1nwblgpkt6ob"}},{"insert":{"id":"r13p7hehqk6ghwdvzdvnq6jhmwmuf575sq"}},{"insert":{"id":"r1caz6h3vw7qhse8dn30e83oj0r8ny0iwa"}},{"insert":{"id":"r1ztnuspefortggvh6w974egdncsu025e2"}},{"insert":{"id":"r1k3il9g5sh5zqvcbjnq7so5luc9ab3aly"}},{"insert":{"id":"r1qp5rrl26icymptmqi1z0atzibnckhliz"}},{"insert":{"id":"r14ny9vjrkgjf05t3y7t7rvf4i083e95o1"}},{"insert":{"id":"r1pg5ads91e16bbhm5dz58zy5pgm4rg9cd"}},{"insert":{"id":"r1wv25e5seayfg87l6nc5jenk3kcikgivy"}},{"insert":{"id":"r15c7p97psr21cnblowz069y232gohknyl"}}],"zoneId":"rs9vcrbgbbn97lzffdwi4vu78kmowh4tuo","zoneType":"R"},"cs38f32otjhdlqn61kqk1kd6n9rb2v88ku":{"ops":[{"attributes":{"colWidth":"273"},"insert":{"id":"c1a9lgsvw2je284u77qf9adhoq7fm4z4z8"}},{"attributes":{"colWidth":"588"},"insert":{"id":"c14byeae2c5bd3ebdoviodotkfy744mha2"}}],"zoneId":"cs38f32otjhdlqn61kqk1kd6n9rb2v88ku","zoneType":"C"},"xr1p4kgkob64qa51b1a5fy7l2j8ytujljvkxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"参数\n"}],"zoneId":"xr1p4kgkob64qa51b1a5fy7l2j8ytujljvkxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr1p4kgkob64qa51b1a5fy7l2j8ytujljvkxc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"insert":"说明\n"}],"zoneId":"xr1p4kgkob64qa51b1a5fy7l2j8ytujljvkxc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr13eqsd8gh81873cr300wf1nwblgpkt6obxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"event_thread_count_\n"}],"zoneId":"xr13eqsd8gh81873cr300wf1nwblgpkt6obxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr13eqsd8gh81873cr300wf1nwblgpkt6obxc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"insert":"用于处理异步 HTTP 请求的 worker 线程数量。\n"}],"zoneId":"xr13eqsd8gh81873cr300wf1nwblgpkt6obxc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr13p7hehqk6ghwdvzdvnq6jhmwmuf575sqxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"max_request_queue_\n"}],"zoneId":"xr13p7hehqk6ghwdvzdvnq6jhmwmuf575sqxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr13p7hehqk6ghwdvzdvnq6jhmwmuf575sqxc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"insert":"最大排队请求数，设置为 0 时表示无限制。\n"}],"zoneId":"xr13p7hehqk6ghwdvzdvnq6jhmwmuf575sqxc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr1caz6h3vw7qhse8dn30e83oj0r8ny0iwaxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"max_request_queue_\n"}],"zoneId":"xr1caz6h3vw7qhse8dn30e83oj0r8ny0iwaxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr1caz6h3vw7qhse8dn30e83oj0r8ny0iwaxc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"insert":"是否开启连接复用功能。\n"}],"zoneId":"xr1caz6h3vw7qhse8dn30e83oj0r8ny0iwaxc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr1ztnuspefortggvh6w974egdncsu025e2xc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"detail_log_\n"}],"zoneId":"xr1ztnuspefortggvh6w974egdncsu025e2xc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr1ztnuspefortggvh6w974egdncsu025e2xc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"insert":"是否开启异步 HTTP 的详细日志，生产环境建议按需关闭。\n"}],"zoneId":"xr1ztnuspefortggvh6w974egdncsu025e2xc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr1k3il9g5sh5zqvcbjnq7so5luc9ab3alyxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"curl_multi_wait_timeout_ms_\n"}],"zoneId":"xr1k3il9g5sh5zqvcbjnq7so5luc9ab3alyxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr1k3il9g5sh5zqvcbjnq7so5luc9ab3alyxc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"attributes":{"inlineCode":"true"},"insert":"curl_multi_wait "},{"insert":"函数的超时时间。\n"}],"zoneId":"xr1k3il9g5sh5zqvcbjnq7so5luc9ab3alyxc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr1qp5rrl26icymptmqi1z0atzibnckhlizxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"async_transport_mode_\n"}],"zoneId":"xr1qp5rrl26icymptmqi1z0atzibnckhlizxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr1qp5rrl26icymptmqi1z0atzibnckhlizxc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"insert":"传输模式配置，"},{"attributes":{"inlineCode":"true"},"insert":"Isolated "},{"insert":"表示每个客户端拥有独立的传输通道，"},{"attributes":{"inlineCode":"true","comment":"true","comment-id":"a2gBqZLSSPe"},"insert":"Shared "},{"insert":"表示相同配置的客户端复用传输通道。\n"}],"zoneId":"xr1qp5rrl26icymptmqi1z0atzibnckhlizxc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr14ny9vjrkgjf05t3y7t7rvf4i083e95o1xc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"fileTransferBackend\n"}],"zoneId":"xr14ny9vjrkgjf05t3y7t7rvf4i083e95o1xc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr14ny9vjrkgjf05t3y7t7rvf4i083e95o1xc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"insert":"文件传输的底层后端机制，支持配置为 "},{"attributes":{"inlineCode":"true"},"insert":"auto"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"posix"},{"insert":"、"},{"attributes":{"inlineCode":"true"},"insert":"mmap "},{"insert":"或 "},{"attributes":{"inlineCode":"true"},"insert":"iouring"},{"insert":"。\n"}],"zoneId":"xr14ny9vjrkgjf05t3y7t7rvf4i083e95o1xc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr1pg5ads91e16bbhm5dz58zy5pgm4rg9cdxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"fileTransferChunkSize\n"}],"zoneId":"xr1pg5ads91e16bbhm5dz58zy5pgm4rg9cdxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr1pg5ads91e16bbhm5dz58zy5pgm4rg9cdxc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"insert":"文件 IO 操作的分块大小。\n"}],"zoneId":"xr1pg5ads91e16bbhm5dz58zy5pgm4rg9cdxc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr1wv25e5seayfg87l6nc5jenk3kcikgivyxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"fileTransferIoDepth\n"}],"zoneId":"xr1wv25e5seayfg87l6nc5jenk3kcikgivyxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr1wv25e5seayfg87l6nc5jenk3kcikgivyxc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"attributes":{"inlineCode":"true"},"insert":"io_uring"},{"insert":" 机制下的并发 IO 深度。\n"}],"zoneId":"xr1wv25e5seayfg87l6nc5jenk3kcikgivyxc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"xr15c7p97psr21cnblowz069y232gohknylxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8":{"ops":[{"insert":"fileTransferAutoUploadIoUringMaxBytes\n"}],"zoneId":"xr15c7p97psr21cnblowz069y232gohknylxc1a9lgsvw2je284u77qf9adhoq7fm4z4z8","zoneType":"Z"},"xr15c7p97psr21cnblowz069y232gohknylxc14byeae2c5bd3ebdoviodotkfy744mha2":{"ops":[{"insert":"在 "},{"attributes":{"inlineCode":"true"},"insert":"auto "},{"insert":"模式下执行上传操作时，允许使用 "},{"attributes":{"inlineCode":"true"},"insert":"io_uring "},{"insert":"的最大对象大小；设置为 0 时将使用 SDK 默认策略。\n"}],"zoneId":"xr15c7p97psr21cnblowz069y232gohknylxc14byeae2c5bd3ebdoviodotkfy744mha2","zoneType":"Z"},"RsN2vGYZeQ":{"ops":[{"attributes":{"zoneId":"ekmb6u1ZIg","title":"基础对象上传","tabContent":"true"},"insert":"*"},{"attributes":{"zoneId":"rBV3iVx1CY","title":"基础对象下载","tabContent":"true"},"insert":"*"},{"attributes":{"zoneId":"tN5X6P3Omo","title":"AsyncEvent 暂停/恢复示例","tabContent":"true"},"insert":"*"},{"attributes":{"zoneId":"UrsEXThYZC","title":"文件上传","tabContent":"true"},"insert":"*"},{"attributes":{"zoneId":"Az5r0Hg6NX","title":"文件下载","tabContent":"true"},"insert":"*"},{"insert":"\n"}],"zoneId":"RsN2vGYZeQ","zoneType":"Z"},"ekmb6u1ZIg":{"ops":[{"insert":" ","attributes":{"language":"C++","type":"codeblock","zoneId":"jbvi0l9qn7","wrap":"true","parentZoneId":"ekmb6u1ZIg"}},{"insert":"\n"}],"zoneId":"ekmb6u1ZIg","zoneType":"Z"},"rBV3iVx1CY":{"ops":[{"insert":" ","attributes":{"language":"C++","type":"codeblock","zoneId":"dkojbjtlk6","wrap":"true","parentZoneId":"rBV3iVx1CY"}},{"insert":"\n"}],"zoneId":"rBV3iVx1CY","zoneType":"Z"},"tN5X6P3Omo":{"ops":[{"insert":"当上传数据暂时不可用，或下载消费端暂时无法写入时，回调可以返回 0 并通过 AsyncEvent 显式暂停请求。\n"},{"insert":"请勿在未显式暂停的情况下长期返回 0，否则 SDK 会将其作为错误处理，以防止请求长时间阻塞。\n"},{"insert":" ","attributes":{"type":"codeblock","language":"C++","zoneId":"2fvdvbawsk","wrap":"true","parentZoneId":"tN5X6P3Omo"}},{"insert":"\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":"也可在数据准备就绪后，由业务线程发起调用：\n"},{"attributes":{"lmkr":"1"},"insert":"*"},{"insert":" ","attributes":{"type":"codeblock","zoneId":"cgvvykifyw","language":"C++"}},{"insert":"\n"}],"zoneId":"tN5X6P3Omo","zoneType":"Z"},"UrsEXThYZC":{"ops":[{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":"使用 "},{"attributes":{"inlineCode":"true"},"insert":"putObjectFromFdRangeAsync"},{"insert":" 可以从 fd 指定范围上传，适合大对象或已有本地文件的场景。\n"},{"attributes":{"lmkr":"1","align":"left"},"insert":"*"},{"insert":" ","attributes":{"language":"C++","type":"codeblock","zoneId":"3qg4olbgjn","wrap":"true","parentZoneId":"rBV3iVx1CY"}},{"insert":"\n"}],"zoneId":"UrsEXThYZC","zoneType":"Z"},"Az5r0Hg6NX":{"ops":[{"insert":" ","attributes":{"language":"C++","type":"codeblock","zoneId":"3jww675ouu","wrap":"true","parentZoneId":"rBV3iVx1CY"}},{"insert":"\n"}],"zoneId":"Az5r0Hg6NX","zoneType":"Z"},"pmsnpfsdwe":{"ops":[{"insert":"cmake -S . -B build_async \\\n"},{"insert":" -DBUILD_ASYNC_SDK=ON \\\n"},{"insert":" -DBUILD_ASYNC_SDK_IO_URING=OFF\n"}],"zoneId":"pmsnpfsdwe","zoneType":"Z"},"r21rpr4osg":{"ops":[{"insert":"config.fileTransferBackend = \"posix\";\n"}],"zoneId":"r21rpr4osg","zoneType":"Z"},"jbvi0l9qn7":{"ops":[{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"TosAsyncClient.h\""},{"insert":"\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"using"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"namespace"},{"insert":" VolcengineTos;\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"int"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"main"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"()"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"insert":"{\n"},{"insert":" std::string region = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"cn-beijing\""},{"insert":";\n"},{"insert":" std::string endpoint = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"http://tos-cn-beijing.ivolces.com\""},{"insert":";\n"},{"insert":" std::string bucket = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"insert":";\n"},{"insert":" std::string key = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"async-demo/hello.txt\""},{"insert":";\n"},{"insert":" std::string ak = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"insert":";\n"},{"insert":" std::string sk = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"insert":";\n"},{"insert":" std::string body = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"hello async tos\""},{"insert":";\n"},{"insert":"\n"},{"insert":" ClientConfig config;\n"},{"insert":" config.endPoint = endpoint;\n"},{"insert":" config.enableCRC = "},{"attributes":{"clientside-highlight":"hljs-literal"},"insert":"true"},{"insert":";\n"},{"insert":" config.detail_log_ = "},{"attributes":{"clientside-highlight":"hljs-literal"},"insert":"false"},{"insert":";\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"InitializeTosAsyncClient"},{"insert":"();\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-function"},"insert":"TosAsyncClient "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"client"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"(region, ak, sk, config)"},{"insert":";\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-function"},"insert":"PutObjectAsyncInput "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"input"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"(bucket, key, TransferEncoding::ContentLength)"},{"insert":";\n"},{"insert":" input."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"setContentLength"},{"insert":"("},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"static_cast"},{"insert":"<"},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"int64_t"},{"insert":">(body."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"size"},{"insert":"()));\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" offset = std::"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"make_shared"},{"insert":"("},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":");\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" sender = [body, offset]("},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"char"},{"insert":"* data, "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"size_t"},{"insert":" len, AsyncEvent* ev) -> "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"size_t"},{"insert":" {\n"},{"insert":" ("},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"void"},{"insert":")ev;\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"const"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"size_t"},{"insert":" remain = body."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"size"},{"insert":"() - *offset;\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"const"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"size_t"},{"insert":" n = std::"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"min"},{"insert":"(len, remain);\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"if"},{"insert":" (n > "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":") {\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"memcpy"},{"insert":"(data, body."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"data"},{"insert":"() + *offset, n);\n"},{"insert":" *offset += n;\n"},{"insert":" }\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" n;\n"},{"insert":" };\n"},{"insert":"\n"},{"insert":" std::promise> promise;\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" future = promise."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"get_future"},{"insert":"();\n"},{"insert":"\n"},{"insert":" client."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"putObjectAsync"},{"insert":"(input, sender,\n"},{"insert":" [&promise](Outcome& outcome) "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"mutable"},{"insert":" {\n"},{"insert":" promise."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"set_value"},{"insert":"(outcome);\n"},{"insert":" });\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" outcome = future."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"get"},{"insert":"();\n"},{"insert":" client."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"close"},{"insert":"();\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"CloseTosAsyncClient"},{"insert":"();\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" outcome."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"isSuccess"},{"insert":"() ? "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":" : "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"1"},{"insert":";\n"},{"insert":"}\n"}],"zoneId":"jbvi0l9qn7","zoneType":"Z"},"dkojbjtlk6":{"ops":[{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"TosAsyncClient.h\""},{"insert":"\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"using"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"namespace"},{"insert":" VolcengineTos;\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"int"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"main"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"()"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"insert":"{\n"},{"insert":" ClientConfig config;\n"},{"insert":" config.endPoint = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"insert":";\n"},{"insert":" config.enableCRC = "},{"attributes":{"clientside-highlight":"hljs-literal"},"insert":"true"},{"insert":";\n"},{"insert":" config.detail_log_ = "},{"attributes":{"clientside-highlight":"hljs-literal"},"insert":"false"},{"insert":";\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"InitializeTosAsyncClient"},{"insert":"();\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-function"},"insert":"TosAsyncClient "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"client"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"("},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", config)"},{"insert":";\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" content = std::"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"make_shared"},{"insert":"();\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" receiver = [content]("},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"char"},{"insert":"* data, "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"size_t"},{"insert":" len, AsyncEvent* ev) -> "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"size_t"},{"insert":" {\n"},{"insert":" ("},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"void"},{"insert":")ev;\n"},{"insert":" content->"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"append"},{"insert":"(data, len);\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" len;\n"},{"insert":" };\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-function"},"insert":"GetObjectAsyncInput "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"input"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"("},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":")"},{"insert":";\n"},{"insert":"\n"},{"insert":" std::promise> promise;\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" future = promise."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"get_future"},{"insert":"();\n"},{"insert":"\n"},{"insert":" client."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"getObjectAsync"},{"insert":"(input, receiver,\n"},{"insert":" [&promise](Outcome& outcome) "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"mutable"},{"insert":" {\n"},{"insert":" promise."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"set_value"},{"insert":"(outcome);\n"},{"insert":" });\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" outcome = future."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"get"},{"insert":"();\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"if"},{"insert":" (outcome."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"isSuccess"},{"insert":"()) {\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-comment"},"insert":"// content 中是下载到的数据"},{"insert":"\n"},{"insert":" }\n"},{"insert":"\n"},{"insert":" client."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"close"},{"insert":"();\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"CloseTosAsyncClient"},{"insert":"();\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" outcome."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"isSuccess"},{"insert":"() ? "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":" : "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"1"},{"insert":";\n"},{"insert":"}\n"}],"zoneId":"dkojbjtlk6","zoneType":"Z"},"2fvdvbawsk":{"ops":[{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" sender = []("},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"char"},{"insert":"* data, "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"size_t"},{"insert":" len, AsyncEvent* ev) -> "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"size_t"},{"insert":" {\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"if"},{"insert":" (!"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"HasDataReady"},{"insert":"()) {\n"},{"insert":" ev->"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"PauseFor"},{"insert":"("},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"10"},{"insert":"); "},{"attributes":{"clientside-highlight":"hljs-comment"},"insert":"// 10ms 后重新调度"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":";\n"},{"insert":" }\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"FillData"},{"insert":"(data, len);\n"},{"insert":"};\n"}],"zoneId":"2fvdvbawsk","zoneType":"Z"},"cgvvykifyw":{"ops":[{"insert":"ev->"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"Pause"},{"insert":"();\n"},{"attributes":{"clientside-highlight":"hljs-comment"},"insert":"// other thread:"},{"insert":"\n"},{"insert":"ev->"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"Resume"},{"insert":"();\n"}],"zoneId":"cgvvykifyw","zoneType":"Z"},"3qg4olbgjn":{"ops":[{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"TosAsyncClient.h\""},{"insert":"\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"using"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"namespace"},{"insert":" VolcengineTos;\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":"std::"},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"uint64_t"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"FileSize"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"("},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"const"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":" std::string& path)"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"insert":"{\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"struct"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-title class_"},"insert":"stat"},{"insert":" st {};\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"if"},{"insert":" (::"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"stat"},{"insert":"(path."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"c_str"},{"insert":"(), &st) != "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":") {\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":";\n"},{"insert":" }\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"static_cast"},{"insert":"(st.st_size);\n"},{"insert":"}\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"int"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"main"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"()"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"insert":"{\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"InitializeTosAsyncClient"},{"insert":"();\n"},{"insert":"\n"},{"insert":" ClientConfig config;\n"},{"insert":" config.endPoint = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"insert":";\n"},{"insert":" config.fileTransferBackend = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"auto\""},{"insert":";\n"},{"insert":" config.fileTransferChunkSize = "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"1024"},{"insert":" * "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"1024"},{"insert":";\n"},{"insert":" config.fileTransferIoDepth = "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"8"},{"insert":";\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-function"},"insert":"TosAsyncClient "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"client"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"("},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", config)"},{"insert":";\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"const"},{"insert":" std::string path = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"/data/file.bin\""},{"insert":";\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"int"},{"insert":" fd = ::"},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"open"},{"insert":"(path."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"c_str"},{"insert":"(), O_RDONLY);\n"},{"insert":"\n"},{"insert":" FileRange range;\n"},{"insert":" range.fd = fd;\n"},{"insert":" range.offset = "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":";\n"},{"insert":" range.length = "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"FileSize"},{"insert":"(path);\n"},{"insert":" range.owns_fd = "},{"attributes":{"clientside-highlight":"hljs-literal"},"insert":"true"},{"insert":";\n"},{"insert":"\n"},{"insert":" FileTransferOptions options;\n"},{"insert":" options.backend = FileIoBackend::Auto;\n"},{"insert":" options.close_fd_on_done = "},{"attributes":{"clientside-highlight":"hljs-literal"},"insert":"true"},{"insert":";\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-function"},"insert":"PutObjectAsyncInput "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"input"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"("},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"path/file.bin\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", TransferEncoding::ContentLength)"},{"insert":";\n"},{"insert":"\n"},{"insert":" std::promise> done;\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" future = done."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"get_future"},{"insert":"();\n"},{"insert":"\n"},{"insert":" client."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"putObjectFromFdRangeAsync"},{"insert":"(input, range, options,\n"},{"insert":" [&done](Outcome& outcome,\n"},{"insert":" FileTransferResult transfer) "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"mutable"},{"insert":" {\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"if"},{"insert":" (!transfer.status.ok) {\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-comment"},"insert":"// transfer.status.message 包含本地文件 IO 错误"},{"insert":"\n"},{"insert":" }\n"},{"insert":" done."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"set_value"},{"insert":"(outcome);\n"},{"insert":" });\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" outcome = future."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"get"},{"insert":"();\n"},{"insert":" client."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"close"},{"insert":"();\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"CloseTosAsyncClient"},{"insert":"();\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" outcome."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"isSuccess"},{"insert":"() ? "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":" : "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"1"},{"insert":";\n"},{"insert":"}\n"}],"zoneId":"3qg4olbgjn","zoneType":"Z"},"3jww675ouu":{"ops":[{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"TosAsyncClient.h\""},{"insert":"\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":"#"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"include"},{"attributes":{"clientside-highlight":"hljs-meta"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":""},{"insert":"\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"using"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"namespace"},{"insert":" VolcengineTos;\n"},{"insert":"\n"},{"attributes":{"clientside-highlight":"hljs-type"},"insert":"int"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"main"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"()"},{"attributes":{"clientside-highlight":"hljs-function"},"insert":" "},{"insert":"{\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"InitializeTosAsyncClient"},{"insert":"();\n"},{"insert":"\n"},{"insert":" ClientConfig config;\n"},{"insert":" config.endPoint = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"insert":";\n"},{"insert":" config.fileTransferBackend = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"auto\""},{"insert":";\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-function"},"insert":"TosAsyncClient "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"client"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"("},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", config)"},{"insert":";\n"},{"insert":"\n"},{"insert":" FileRange range;\n"},{"insert":" range.path = "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"/data/download.bin\""},{"insert":";\n"},{"insert":" range.offset = "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":";\n"},{"insert":" range.length = "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"1024"},{"insert":" * "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"1024"},{"insert":"; "},{"attributes":{"clientside-highlight":"hljs-comment"},"insert":"// 已知对象长度时填写对象长度；未知时可用 kUnknownFileRangeLength"},{"insert":"\n"},{"insert":"\n"},{"insert":" FileTransferOptions options;\n"},{"insert":" options.backend = FileIoBackend::Auto;\n"},{"insert":" options.truncate_file_on_done = "},{"attributes":{"clientside-highlight":"hljs-literal"},"insert":"true"},{"insert":";\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-function"},"insert":"GetObjectAsyncInput "},{"attributes":{"clientside-highlight":"hljs-title"},"insert":"input"},{"attributes":{"clientside-highlight":"hljs-params"},"insert":"("},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":", "},{"attributes":{"clientside-highlight":"hljs-string"},"insert":"\"\""},{"attributes":{"clientside-highlight":"hljs-params"},"insert":")"},{"insert":";\n"},{"insert":"\n"},{"insert":" std::promise> done;\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" future = done."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"get_future"},{"insert":"();\n"},{"insert":"\n"},{"insert":" client."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"getObjectToFdRangeAsync"},{"insert":"(input, range, options,\n"},{"insert":" [&done](Outcome& outcome,\n"},{"insert":" FileTransferResult transfer) "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"mutable"},{"insert":" {\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"if"},{"insert":" (!transfer.status.ok) {\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-comment"},"insert":"// transfer.status.message 包含本地文件 IO 错误"},{"insert":"\n"},{"insert":" }\n"},{"insert":" done."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"set_value"},{"insert":"(outcome);\n"},{"insert":" });\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"auto"},{"insert":" outcome = future."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"get"},{"insert":"();\n"},{"insert":" client."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"close"},{"insert":"();\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"CloseTosAsyncClient"},{"insert":"();\n"},{"insert":"\n"},{"insert":" "},{"attributes":{"clientside-highlight":"hljs-keyword"},"insert":"return"},{"insert":" outcome."},{"attributes":{"clientside-highlight":"hljs-built_in"},"insert":"isSuccess"},{"insert":"() ? "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"0"},{"insert":" : "},{"attributes":{"clientside-highlight":"hljs-number"},"insert":"1"},{"insert":";\n"},{"insert":"}\n"}],"zoneId":"3jww675ouu","zoneType":"Z"}}}

对象存储