Expand description
§wordval-macros
Wordval 过程宏生态:编译时代码生成,替代 Java 的反射 + 注解扫描。
§提供的宏
§路由宏
#[get("/path")]/#[post]/#[put]/#[delete]— 路由注册; 同一条注解上用audit = "动作名"、permission = "权限标识"、public声明该路由的审计 / 权限 / 免认证策略(编译成路由守卫元数据, 启动时由 wordval-web 派生中间件规则,业务侧零额外代码、路径只写一次)。
§模型宏
#[derive(Model)]— 自动实现FromRow+ToRow+ActiveRecord(query_as要的TryFromRow由wordval-db从FromRowblanket 出来);sqlx::FromRow按需生成, 要哪个后端写#[wordval(sqlx = "sqlite")]。 时间(NaiveDate/NaiveDateTime/DateTime<Utc>/DateTime<Local>)、Uuid、Vec<u8>、Decimal与各Option字段为类型化绑定(None落 typed null), 不再经 serde JSON 走文本参数(详见model模块文档)。
§其他
#[idempotent]— 幂等性保证#[tools]— MCP 工具注册
Attribute Macros§
- delete
- DELETE 路由(参数与
#[get]相同:audit/permission/public) - get
- GET 路由
- idempotent
- 幂等执行宏:只对需要幂等的写接口标注,业务逻辑对同一
x-idempotency-key只执行一次 - post
- POST 路由(参数与
#[get]相同:audit/permission/public) - put
- PUT 路由(参数与
#[get]相同:audit/permission/public) - tools
- 把普通 API handler 同时声明为大模型业务工具(MCP 工具)
Derive Macros§
- Model
- #[derive(Model)] — 自动实现 FromRow + ToRow + ActiveRecord(TryFromRow 由库 blanket 出来)
sqlx::FromRow 默认不生成,按
#[wordval(sqlx = "postgres,mysql,sqlite")]勾选的后端补齐