协同办公密码学【免费下载链接】tutanotaTuta is an email service with a strong focus on security and privacy that lets you encrypt emails, contacts and calendar entries on all your devices.项目地址https://gitcode.com/gh_mirrors/tu/tutanota点击查看免费下载Tuta原名 Tutanota是一款以安全与隐私为核心、可在所有设备上加密邮件、联系人和日历条目的邮件服务。其新一代 Rust SDK位于 tuta-sdk/rust/sdk采用“核心逻辑用 Rust 实现、宿主平台注入外部能力”的架构而本指南聚焦的bindings目录tuta-sdk/rust/sdk/src/bindings/README.md正是 SDK 与嵌入应用Kotlin / Swift / JavaScript之间全部交互接口的汇集地。读完本文你将掌握RestClient与FileClient两个注入式 trait 的定义与错误模型、SuspendableRestClient的限流挂起语义、NativeFileClient/TestRestClient/TestFileClient等实现与测试用法以及如何在自己的宿主应用中接入这套 bindings 协议。bindings 目录SDK 与宿主应用的接口边界bindings 目录内的文件“处理与嵌入应用程序的接口”files that deal with the interface to the embedding application是整条边界上唯一直接暴露给宿主代码Kotlin、Swift、JavaScript的模块。Rust 侧通过 uniffi 把这些接口翻译成各语言的绑定代码SDK 内部则通过动态派发dyn trait调用这些由宿主注入的实现从而做到网络栈、文件存储等平台差异能力完全由宿主负责SDK 只关心业务与加密逻辑。模块导出关系见 bindings.rsrest_client定义RestClienttrait、HttpMethod、RestClientOptions、RestResponse、RestClientError及查询参数编码工具suspendable_rest_client对宿主RestClient的包装器实现服务器强制限流suspension语义test_rest_client内存版RestClient用于测试file_client定义FileClienttrait 与FileClientErrornative_file_client基于std::fs的真实文件系统实现test_file_client内存版FileClient用于测试。RestClient注入的 HTTP 客户端协议接口定义宿主应用必须实现 rest_client.rs 中的RestClienttrait为 SDK 提供“携带二进制请求体执行 HTTP 请求”的能力#[uniffi::export(with_foreign)] #[cfg_attr(test, mockall::automock)] #[async_trait::async_trait] pub trait RestClient: Send Sync static { /// Performs an HTTP request with binary data in its body using the injected HTTP client async fn request_binary( self, url: String, method: HttpMethod, options: RestClientOptions, ) - ResultRestResponse, RestClientError; }要点#[uniffi::export(with_foreign)]允许 trait 由外部语言实现后回调 Rustforeign traitSend Sync static约束保证实现可在 Tokio 异步运行时中跨线程安全调用请求体是Vecu8二进制数据与 Tuta 后端压缩加密载荷的传输方式一致例如TestRestClient默认响应就是 lz4 压缩后的 JSON。请求选项与响应结构RestClientOptionsrest_client.rs携带请求的可变部分字段类型说明headersHashMapString, String请求头如认证令牌、app-types-hashbodyOptionVecu8可选的二进制请求体suspension_behaviorOptionSuspensionBehavior遇到挂起时的行为None时默认SuspendRestResponserest_client.rs表示后端返回pub struct RestResponse { pub status: u32, /// Map of response headers. **Header names must be lowercased**. pub headers: HashMapString, String, pub body: OptionVecu8, }特别注意响应头键必须小写否则 SDK 在解析retry-after等头部时可能匹配失败见下文get_suspension。错误模型RestClientErrorrest_client.rs覆盖宿主 HTTP 客户端可能抛出的全部异常NetworkError网络错误DNS、连接被拒、超时等InvalidURLURL 格式非法FailedHandshakeTLS 握手失败InvalidRequest请求非法如不可接受的请求头InvalidResponse响应非法如 HTTP 状态行解析失败FailedTlsSetupTLS 配置初始化失败Suspended调用方指定Throw行为时在挂起期间立即返回该错误Unknown未知错误兜底。这些变体通过#[uniffi::Error]导出为各语言的异常类型宿主可按枚举逐项处理。HTTP 方法与查询参数工具HttpMethodrest_client.rs是一个uniffi::Enum目前支持GET、POST、PUT、DELETE四种方法Tuta 后端协议不使用 PATCH。同文件提供的encode_query_paramsrest_client.rs负责把查询参数追加到 URL使用form_urlencoded::byte_serialize对 key/value 做百分号编码并以连接、以?开头自动过滤 key 或 value 为空的条目无有效参数时返回空字符串不产生裸?。SuspensionBehavior 与 SuspendableRestClient限流挂起语义服务端限流与 SuspensionTuta 后端在请求过频HTTP 429 Too Many Requests或暂时不可用HTTP 503 Service Unavailable时会在响应头中给出retry-after秒SDK 据此暂停后续请求。suspendable_rest_client.rs 定义行为枚举#[derive(uniffi::Enum, Clone, Debug, Eq, PartialEq)] pub enum SuspensionBehavior { /// delay the request until the suspension is over, then return the result. this is the default. Suspend, /// return an error immediately if suspended; do not wait. Throw, }Suspend默认等待挂起结束再发请求Throw立即返回RestClientError::Suspended不等待。Suspension结构体记录until: DateTime挂起截止时刻由date_provider提供统一时钟保证可测试性。核心流程request_binary 包装SuspendableRestClientsuspendable_rest_client.rs持有inner: Arcdyn RestClient、date_provider以及suspension: ArcRwLockOptionSuspension。每次请求的调用链如下request_binary 实现wait_for_suspension(options.suspension_behavior)若当前有未过期挂起按行为等待Suspend则tokio::time::sleepThrow则立即返回Suspended错误委托inner.request_binary(...)执行真实 HTTP 请求通过get_suspension(now, response)从响应中提取新挂起若有则update_suspension登记并对后续请求生效无论是否发生挂起原始响应都会原样返回给调用方。挂起的登记与解除update_suspensionsuspendable_rest_client.rs的设计要点采用RwLock的原因是可以有一个专门的写入方任务在挂起到期后解除它同时允许多个等待中的请求并发读取若新挂起已过期则直接把当前挂起清空None否则记录新挂起并tokio::spawn一个后台任务sleep到截止时间后仅当锁中仍是“我们写入的那次挂起”相等比较才清除——避免覆盖掉更新的一次挂起语义上“最后一次看到的挂起总是胜出”。wait_for_suspensionsuspendable_rest_client.rs先读锁计算剩余等待时长没有挂起则直接放行get_sleep_timesuspendable_rest_client.rs在sleep_until晚于当前时间时返回毫秒级Duration否则返回None无需等待。从响应中提取挂起get_suspensionsuspendable_rest_client.rs只对非 2xx 响应生效它通过 rest_error.rs 中的HttpError::from_http_response解析状态码——429映射为TooManyRequestsError { suspension_time_sec }503映射为ServiceUnavailableError { suspension_time_sec }两者都从常量RETRY_AFTER_HEADER: str retry-afterrest_error.rs读取秒数再换算为until now sec * 1000ms。注意该头解析要求响应头键已小写见RestResponse注释。测试验证suspendable_rest_client.rs 内置测试 覆盖了关键语义get_suspension_returns_suspension_on_too_many_requests_error429 retry-after: 60→ 挂起 60 秒get_suspension_returns_suspension_on_service_unavailable_error503 retry-after: 20→ 挂起 20 秒respects_too_many_requests_with_retry_after/respects_service_unavailable_error_with_retry_after先用TestRestClient插入 429/503 响应再验证后续请求确实被推迟了至少 1000msrespects_service_unavailable_error_with_retry_after_throws验证Throw行为下第二次请求直接返回RestClientError::Suspended。这些测试直接证明了“挂起期间等待/报错”语义是按真实时钟与retry-after头部驱动的而非硬编码。FileClient 与 NativeFileClient二进制内容存取接口定义file_client.rs 定义宿主需实现的文件存取协议#[uniffi::export(with_foreign)] #[cfg_attr(test, mockall::automock)] #[async_trait::async_trait] pub trait FileClient: Send Sync static { async fn persist_content(self, name: String, content: Vecu8) - Result(), FileClientError; async fn read_content(self, name: String) - ResultVecu8, FileClientError; }SDK 用它持久化/读取加密 blob如附件、密钥材料等文件如何落盘完全交给宿主平台。错误映射FileClientErrorfile_client.rs只有三个变体NotFound、IoError、Unknown。impl Fromstd::io::ErrorKind提供自动映射NotFound→NotFoundOther→Unknown其余PermissionDenied、AlreadyExists、InvalidData等一律归为IoError。NativeFileClient真实文件系统实现native_file_client.rs 是 Rust 侧的开箱即用实现NativeFileClient::try_new(app_dir)要求传入的app_dir必须已存在且是目录否则返回std::io::ErrorKind::Other错误persist_contentapp_dir.join(name)后std::fs::writeread_contentapp_dir.join(name)后std::fs::read两个方法的错误都会先log::error!记录完整路径与原因再通过.kind().into()映射为FileClientError。内置测试save_and_read_roundtripnative_file_client.rs演示了用/tmp做app_dir的写入→读取往返验证。测试辅助实现TestRestClient 与 TestFileClientTestRestClient可编程响应的内存 HTTP 客户端test_rest_client.rs 为 SDK 测试提供确定性响应TestRestClient::new(base_url)自动注册一条GET {base_url}/rest/base/applicationtypesservice的默认响应把CLIENT_TYPE_MODEL.apps见 type_model_provider.rs序列化后用lz4_flex::compress压缩作为响应体并附带app-types-hash: latest-applications-hash头insert_response(url, method, status, headers, body)按(url, method)精确匹配插入自定义响应且总是合并注入app-types-hash头request_binary未命中任何已注册响应时会panic!从而暴露测试中的意外请求它按TestRestRequest { url, method }Hash PartialEq Eq作为HashMap键进行路由。TestFileClient内存文件存储test_file_client.rs 以MutexHashMapString, Vecu8模拟文件系统persist_content直接插入内存表锁中毒poisoned时返回Unknownread_content按名字取出字节不存在返回NotFound额外提供contains_file(file_name)断言辅助方法方便测试“某内容是否已落盘”。在宿主应用中接入 bindings 协议综合以上接口接入流程可概括为三步实现RestClient在 Kotlin/Swift/JavaScript 侧用平台 HTTP 栈如 OkHttp / URLSession / fetch实现request_binary注意把响应头键统一转小写把平台错误映射为RestClientError的八个变体之一用二进制 body 传输。实现FileClient选择NativeFileClientRust 侧std::fs实现适合桌面/服务端场景或宿主平台的文件 API返回NotFound/IoError/Unknown。组合与测试真实环境可用SuspendableRestClient::new(Arcdyn RestClient, Arcdyn DateProvider)包裹宿主客户端以获得自动限流退避测试环境可注入TestRestClient/TestFileClient获得确定性行为并用 DateProviderStub 固定时钟验证挂起逻辑。正是这套“Rust 核心 宿主注入 IO”的 bindings 设计让 Tuta 能够在 AndroidKotlin、iOSSwift与桌面JavaScript/Electron等多个平台上复用同一套加密与业务逻辑同时把网络、存储等平台差异收敛在 bindings 目录 这一层清晰可测的接口协议之中。赞分享协同办公密码学【免费下载链接】tutanotaTuta is an email service with a strong focus on security and privacy that lets you encrypt emails, contacts and calendar entries on all your devices.项目地址https://gitcode.com/gh_mirrors/tu/tutanota点击查看免费下载相关推荐ADK 模型层深入指南BaseLlm 接口与 LLMRegistry 模型注册解析机制ADK 模型层深入指南BaseLlm 接口与 LLMRegistry 模型注册解析机制 本文围绕 Google ADKAgent Development K人工智能AI AgentAgent 框架多智能体工具调用RAG.NET Mono 运行时协作式挂起Cooperative Suspend机制深度解析.NET Mono 运行时协作式挂起Cooperative Suspend机制深度解析 导读 本文基于仓库中的设计文档 docs/design/mono/w语言运行时标准库JIT编译编译器Humanizer 自定义 TimeOnly.Humanize 策略深入解析 ITimeOnlyHumanizeStrategy 接口与挂载机制Humanizer 自定义 TimeOnly.Humanize 策略深入解析 ITimeOnlyHumanizeStrategy 接口与挂载机制 本篇技术指南开发工具上一篇Grapple.nvim持久化原理如何确保标签状态在Neovim重启后不丢失下一篇【亲测免费】 探索Visually Stunning世界Visual Studio Code的Mermaid图预览插件创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考