《Java 服务端通信工程》4.2 Interceptor 与 Metadata
请求 ID、租户、traceparent 不该散落在每个业务方法里。本节用 linkd-v3 的客户端与服务端拦截器,演示 Metadata 键的定义与校验、Context 的附着和清理、响应头回显,并给出拦截器顺序、异常与重试传播的边界。
category
请求 ID、租户、traceparent 不该散落在每个业务方法里。本节用 linkd-v3 的客户端与服务端拦截器,演示 Metadata 键的定义与校验、Context 的附着和清理、响应头回显,并给出拦截器顺序、异常与重试传播的边界。
Channel 管连接,Stub 管一次调用。本节用 linkd-v3 的 9093 端口拆开 ManagedChannel 的状态机、阻塞与异步 Stub 的不可变语义,给出预热、复用以及 shutdown、shutdownNow、awaitTermination 的完整代码,并用自包含探针验证 unary 调用。
区分 at-most-once、at-least-once 和 effectively-once,说明 x-idempotency-key 由谁生成、作用域怎么定、结果缓存多久,给出 20 ms 起、指数 2、±20% 抖动的退避实现,以及用 CompletableFuture 做并发去重的服务端代码。
从「回声」一次拉黑只在前端生效的事故写起:用户拉黑骚扰者后,换个客户端仍能看到对方内容。文章把拉黑、屏蔽与可见性拆成不同层次,给出 CanView 的判定顺序、可读原因、拉黑压过好友的实现、边界测试与真实输出,并说明为什么可见性必须在服务端最终响应处统一生效。
把 800 ms 总预算拆成每次尝试的可用时间,解释 grpc-timeout 为什么传相对时间、服务端为什么常看到 CANCELLED 而不是 DEADLINE_EXCEEDED,并给出 withDeadlineAfter、Context 剩余时间读取、setOnCancelHandler 清理的完整代码。
把 unary、server streaming、client streaming、bidi streaming 放进同一张分工表,说明每种模式的半关闭、流控和取消语义,给出 Library 四个方法的服务端实现,并用一段双向流客户端跑出 stream=echo:a / echo:b / stream-complete。
把兼容性拆成线上、源码、二进制、行为四个维度,给出新增、删除、改名、改类型、改枚举、动 oneof 的完整兼容矩阵,解释 int32 与 sint32 为什么不能互换,并用 Descriptors 的保留位检查写一条可在 CI 执行的契约回归测试。
把同一份 Book 数据分别写成 JSON 和 Protobuf,比较字节数、解析成本、演进能力和调试体验;说明 proto3 JSON 映射里 int64 变字符串、默认值省略、字段名转小驼峰的规则,并给出网关边界上用 JsonFormat 转换的代码。
从 tag、wire type 和 varint 三个部件拆开 Protobuf 的线格式,手算 Book 消息的十二个字节,解释字段号 1–15 为什么更省、负数为什么要用 sint32、proto3 默认值为什么不上线,并给出纯 JDK 的 varint 编解码代码。
契约不只是 .proto:字段号、错误原因码、metadata 键、超时预算和版本规则都算契约。本节给出 comm-api 的生成配置、兼容与破坏性改动清单、用 Descriptors 写契约基线和 JUnit 断言的方法,以及一次变更从提案到发布的流程。
把 gRPC 的 Status 码、trailers 与 google.rpc.ErrorInfo 分成三层,给出 linkd-v3 六个错误原因码到状态码的映射和可重试判定,并用 RpcError 的 toException/from 实现服务端抛错、客户端还原的完整闭环。
把「调用一个远程方法」拆成方法标识、参数、关联、时间和错误五个语义要素,再逐一映射到 HTTP/2 的 HEADERS、DATA 与 trailers,给出 gRPC 五字节消息前缀的编解码代码,并用 MethodDescriptor 在 9093 上跑通一次 unary 调用。
《Java 服务端通信工程》全书导航:给出把 RPC 用对、把治理做起来、把系统跑稳三条学习路径,列出十五章四十五节的入口、每章验收动作与通过判据、linkd-v3 四模块的推进状态、章节依赖、跳读后果和附录用法,方便按目标定位或按依赖跳读。
交代本书的三种读法、前置知识、JDK 25 与 gRPC 1.76.0 的环境搭建、comm-api 等四模块与 9093/9094/9095 端口约定,并给出全卷统一的代码风格、默认参数、验证命令和本机能力边界,方便在动手前把团队口径对齐。
从「回声」上线好友功能后的一次投诉写起:一方删除好友,另一方仍能看到仅好友可见的动态。文章拆解关注、好友与拉黑三种边的方向语义,说明关注后对方是否知情、好友请求被拒后关系如何落库,给出 Validate 与 Mutual 的 Go 实现、表驱动测试和真实运行输出,并列出关系建模的常见错误与边界。
按钮组件从 1.4 升到 1.5,发布说明写着「只加了可选属性」,四十多个业务包却在编译期报错。问题不在版本号,而在没人把组件契约当成可比较的对象。本节用 TypeScript 模块演示属性、事件、插槽与可访问性语义的变更分类、兼容判定、版本递增和契约快照比较。
《Java 服务端通信工程》开篇:从一条能跑通的 RPC 调用出发,说明上线后会遇到的超时、重试放大、错误码丢失、版本兼容与容量问题,交代 linkd-v3 的四模块、9093/9094/9095 端口,以及全书的最小可运行闭环和三卷本定位。
从实验组点击率涨了 8%、次留却跌了 2% 的事故写起,说明分桶必须稳定、指标必须先定、实验期间不能混入其他改动;给出基于 FNV 的 0 到 99 分桶、rollout 判定与相对提升计算的可测试 Go 实现,并讨论点击与留存的取舍,附真实运行输出。
从用户点过一条内容、刷新后它就消失的投诉写起,区分按内容 ID 去重与按事件去重,讨论已读是否应该影响排序,以及同作者相邻内容从哪里开始折叠;给出保持顺序、容忍 nil 入参的 Go 实现与边界测试,避免误删与重复曝光,并附上真实运行输出。
从三天前爆款占满首页的事故写起,拆解时间衰减、点赞热度与作者亲和度三种信号各自的偏差,说明多样性其实是限制同作者与同话题占比,而不是随机打散;给出带权重校验和稳定排序的可测试 Go 实现,以及新内容起不来的排查与修正路径,并附真实测试输出。