首页
/ ORPC v0.35.0 发布:全新插件系统与核心架构升级

ORPC v0.35.0 发布:全新插件系统与核心架构升级

2025-06-25 18:27:57作者:蔡丛锟

ORPC(OpenAPI RPC Framework)是一个基于 TypeScript 的 RPC 框架,它通过 OpenAPI 规范来定义和实现远程过程调用。该框架特别适合需要强类型安全和 API 文档自动生成的项目,能够显著提升前后端协作效率。

核心架构重构

本次 v0.35.0 版本带来了重大架构调整,最显著的变化是处理器的全面重写。框架现在原生支持 fetch API 和 Node.js HTTP 服务器的原生接口,这一改变带来了显著的性能提升和更好的兼容性。

原有的四个生命周期选项(onStart、onSuccess、onError 和 onFinish)已被移除,取而代之的是全新的拦截器系统。开发者现在可以使用更灵活、功能更强大的拦截器来实现相同的功能。同时,OpenAPIServerHandler 和 OpenAPIServerlessHandler 两个处理器被合并为统一的 OpenAPIHandler,这个新处理器针对各种部署环境都进行了优化。

全新插件系统

v0.35.0 版本引入了插件系统,首批推出的两个官方插件是 CORSPlugin 和 ResponseHeadersPlugin。

CORSPlugin 简化了跨域资源共享配置,开发者只需简单配置 origin 参数即可启用 CORS 支持。ResponseHeadersPlugin 则为响应头管理提供了统一接口,通过上下文对象可以方便地设置自定义响应头。

插件系统的设计采用了依赖注入模式,ResponseHeadersPlugin 会自动向上下文类型中注入 ResponseHeadersPluginContext,开发者可以方便地通过类型扩展来使用这些功能。

改进与优化

除了上述重大变更外,本次更新还包含了对 Hono 框架兼容性的改进。Hono 是一个轻量级的 Web 框架,ORPC 现在能够更好地与其集成,特别是在中间件支持方面进行了优化。

错误处理也得到了增强,新的拦截器系统提供了更精细的错误处理能力。开发者可以针对不同类型的错误实现特定的处理逻辑,同时保持代码的整洁和可维护性。

升级建议

对于现有项目,升级到 v0.35.0 需要注意以下几点:

  1. 所有处理器相关的代码需要按照新 API 重写
  2. 生命周期钩子需要迁移到新的拦截器系统
  3. 可以考虑使用新的插件系统来替代部分自定义中间件

虽然升级需要一定的工作量,但新版本带来的性能提升和功能增强值得投入。特别是插件系统的引入,为框架的扩展性打开了新的可能性,开发者可以期待更多官方和社区插件的出现。

ORPC 正在朝着更现代化、更灵活的方向发展,v0.35.0 是一个重要的里程碑版本,为未来的功能扩展奠定了坚实的基础。

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