首页
/ ORPC v0.31.0 版本发布:更灵活的中间件链与自定义 Schema 支持

ORPC v0.31.0 版本发布:更灵活的中间件链与自定义 Schema 支持

2025-06-25 22:50:42作者:秋泉律Samson

ORPC(Object-RPC)是一个现代化的远程过程调用框架,它通过类型安全和链式API简化了前后端通信的开发体验。在最新发布的v0.31.0版本中,ORPC带来了两项重要改进:更灵活的中间件链式调用流程和自定义Schema支持。

更灵活的中间件链式调用

在之前的版本中,ORPC的链式调用存在一些限制,特别是在中间件的使用顺序上。v0.31.0版本对此进行了重大改进:

  1. 中间件插入位置更灵活:现在开发者可以在.input.output之间插入中间件,实现了更细粒度的控制。这意味着你可以在输入验证之后、业务逻辑执行之前,或者在业务逻辑执行之后、输出处理之前,插入特定的中间件逻辑。

  2. 类型安全的链式调用:TypeScript现在能够捕获无效的链式调用模式。例如:

    • 在调用.use之后不能再调用.middleware
    • 不能在一个.input之后紧接着另一个.input

这些改进不仅提升了开发体验,还能在编译阶段就发现潜在的问题,避免运行时错误。

自定义Schema支持

新版本引入了type工具函数,允许开发者创建自定义的Schema:

export const getting = oc.input(type<{ id: string }>());

这一改进带来了几个显著优势:

  1. 简化验证逻辑:当不需要复杂的验证逻辑时,可以直接使用TypeScript类型作为Schema,减少了样板代码。

  2. 减小打包体积:避免了引入完整的验证库,在不需要复杂验证的场景下可以显著减小前端打包体积。

  3. 更好的类型推断:与TypeScript深度集成,保持了完整的类型安全。

实际应用场景

假设我们正在开发一个用户管理系统,这些改进可以这样应用:

// 定义用户查询接口
const getUser = oc
  .input(type<{ id: string }>()) // 使用自定义Schema
  .middleware(async (ctx, next) => {
    // 在输入验证后执行的中间件
    console.log('输入验证通过,准备查询用户');
    return next();
  })
  .output(type<User>())
  .middleware(async (ctx, next) => {
    // 在输出处理前执行的中间件
    console.log('用户数据查询完成,准备返回');
    return next();
  })
  .use(async (ctx) => {
    // 业务逻辑
    return db.users.findUnique({ where: { id: ctx.input.id } });
  });

这种结构使得代码更加清晰,各部分的职责也更加明确。

总结

ORPC v0.31.0通过改进链式调用流程和引入自定义Schema支持,进一步提升了开发体验和灵活性。这些改进使得开发者能够:

  • 更精确地控制中间件的执行时机
  • 在编译时捕获更多的潜在错误
  • 根据实际需求选择最适合的Schema方案
  • 保持代码的简洁和类型安全

对于已经在使用ORPC的团队,建议尽快升级以利用这些新特性;对于考虑采用RPC解决方案的团队,这个版本提供了更成熟和完善的功能集。

登录后查看全文
热门项目推荐
相关项目推荐