首页
/ oRPC v1.4.0 版本发布:请求去重、批处理优化与多框架集成

oRPC v1.4.0 版本发布:请求去重、批处理优化与多框架集成

2025-06-24 04:27:17作者:邵娇湘

oRPC 是一个现代化的远程过程调用(RPC)框架,旨在简化客户端与服务器之间的通信。它提供了强大的类型安全、灵活的插件系统以及与流行前端框架的无缝集成。最新发布的 v1.4.0 版本带来了一系列重要功能和改进,进一步提升了开发体验和性能。

请求去重插件:减少冗余网络请求

新引入的 Dedupe Requests 插件能够智能识别并合并重复的请求,有效减少不必要的网络流量。这对于前端应用中常见的重复数据请求场景特别有用,例如多个组件同时请求相同数据时。

该插件允许开发者通过配置过滤器来精确控制哪些请求需要去重。例如,可以设置为只对 GET 方法请求进行去重:

new DedupeRequestsPlugin({
  filter: ({ request }) => request.method === 'GET',
  groups: [{ condition: () => true, context: {} }]
})

批处理模式优化:支持缓冲和流式传输

批处理插件现在支持两种工作模式:

  1. 流式模式(默认):响应数据一旦就绪就立即发送,避免单个请求阻塞整个批次
  2. 缓冲模式:等待所有响应完成后统一发送,适用于不支持流式传输的环境(如某些服务器less平台)

开发者可以根据运行环境动态选择模式:

new BatchLinkPlugin({
  mode: typeof window === 'undefined' ? 'buffered' : 'streaming'
})

与 Hey API 的无缝集成

v1.4.0 提供了将 Hey API 生成客户端转换为 oRPC 客户端的工具函数,使开发者能够轻松利用 oRPC 生态系统的全部功能:

import { experimental_toORPCClient } from '@orpc/hey-api'
import * as sdk from 'src/client/sdk.gen'

export const client = experimental_toORPCClient(sdk)

AWS Lambda 适配器支持

针对服务器less环境,新增了对 AWS Lambda 响应流的原生支持。开发者现在可以构建高性能的 serverless RPC 端点:

import { experimental_RPCHandler as RPCHandler } from '@orpc/server/aws-lambda'

const rpcHandler = new RPCHandler(router)

export const handler = awslambda.streamifyResponse(async (event, responseStream) => {
  await rpcHandler.handle(event, responseStream)
})

统一 TanStack Query 集成

新版提供了统一的 TanStack Query 集成方案,支持 React、Vue、Angular、Solid 和 Svelte 等所有基于 TanStack Query 的框架。迁移到新版本只需更新导入路径即可。

其他重要改进

  1. 括号表示法解析增强:现在会将同名参数自动解析为数组,符合常见 Web 标准
  2. 路由到合约转换工具:帮助开发者安全地将服务器路由导出为客户端合约,避免业务逻辑泄露
  3. 操作规范覆盖:通过 route.spec 可以完全覆盖自动生成的 OpenAPI 操作定义
  4. 验证库更新:升级 Zod 到 3.25.49 版本,并为 Valibot 添加了输出策略支持

这些改进使 oRPC 在性能、灵活性和开发者体验方面都达到了新的水平,为构建现代化 Web 应用提供了更强大的工具集。

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