Skip to main content

Crate wordval_macros

Crate wordval_macros 

Source
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 从 FromRow blanket 出来);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")] 勾选的后端补齐