Toa 是一个用于构建分布式系统的运行时。本指南介绍如何将业务需求转化为在 Toa 上运行的应用程序,包括需要编写什么、创建哪些文件、如何运行与测试。
用途
Toa 旨在支持分布式应用的开发,提供组件、状态、操作、事件、任务等核心概念,并通过 HTTP API 暴露服务。文档面向开发者,帮助理解如何从零开始构建应用并逐步添加业务逻辑、安全控制和平台能力。
主要能力
根据文档目录,Toa 提供以下能力:
- 基础开发:通过命令创建应用、运行测试、添加配置。
- 业务逻辑:描述状态(实体模式)、编写操作(带输入输出、并发和查询)、拒绝请求(错误与异常)、调用操作与选择状态(本地/远程调用、条件、排序、分页)、使用继承操作(transit、observe、enumerate 等)、保护不变量(guard)、发布与响应事件、后台任务、处理重复调用(幂等性)、调用外部服务、多步工作流、定时任务、延迟执行、读取大型集合、流式回复与输入、进程内状态保持、循环与只读调用、TypeScript 支持、索引与数据迁移、操作上下文。
- HTTP API:为组件构建 API、路由布局、方法映射、过滤排序分页、客户端请求与响应格式、选择路由接受与返回内容、传递头部/语言/主机、缓存与防止更新丢失、流式传输、文件存储与上传下载、处理上传文件、向浏览器推送变更、JSON-RPC 过程调用、让 AI 助手通过 MCP 调用 API、描述 API、运行与配置网关。
- 用户与访问:用户注册登录、密码管理、保持登录、通过 Google/Apple/电子邮件验证码/通行密钥登录、限制路由访问、员工权限、多域名与请求筛选、让其他应用代表用户操作、身份资源参考。
- 平台特性:开启扩展、管理设置与密钥、不重新部署更改设置、共享缓存、副本协调、日志、请求追踪,以及后续章节(文档截断处为“Count ...”)。
使用方式
文档采用文章形式,每篇文章回答“如何做 X”,独立成篇并链接相关依赖。示例均来自同一个应用——一个小型商店,包含订单和客户账户。章节按步骤组织:
- 第一步:创建应用、运行与修改、创建组件、通过 HTTP 暴露、编写测试、添加配置。
- 业务逻辑:逐项讲解组件构成。
- API:通过 HTTP 服务应用,包括路由、请求响应、文件、实时更新和 AI 助手工具。
- 用户与访问:注册登录、保持会话、权限控制。
- 平台特性:设置、缓存、协调、遥测、自身映射、可查询日志。
具体操作涉及命令行工具、清单文件(manifest)、操作文件、测试场景等。文档中提到了使用 curl 发送请求、运行测试、生成类型等,但未提供完整的安装命令或代码示例(资料中仅保留描述性摘要)。
适用场景
Toa 适用于需要构建分布式系统的场景,尤其是需要组件化、事件驱动、任务调度、HTTP API、身份认证与授权、以及平台级特性(缓存、协调、日志、追踪)的应用。示例中的小型商店应用展示了订单和客户账户管理的典型用例。
限制
资料中未明确说明 Toa 的许可协议、定价、平台要求或性能限制。部分功能(如 MCP 集成、通行密钥登录)的具体实现细节未在摘要中展开。文档提到“机器需要什么”但未详述系统要求。资料截断于“Count ...”,后续内容暂未提供。