知识卡片
统一接口降低学习成本
统一接口是理解面向资源价值的关键。登录注销若设计成 login()、logout() 两个服务,接口会随功能不断膨胀、逐个学习;若看作 Session 资源,登录是 PUT,注销是 DELETE,查询是 GET,一种资源就覆盖全部需求。以动词为中心的接口互相独立,以名词为中心的接口天然有集合与层次,调用者只需掌握一套通用操作语义。代价是 REST 绑定在 HTTP 之上,受其边界限制。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 访问远程服务 · 查看原书依据
以前,人们面向方法去设计RPC API,譬如CORBA和DCOM,随着时间推移,接口与方法越来越多却又各不相同,开发人员必须了解每一个方法才能正确使用它们,这样既耗时又容易出错。 ——Google API Deign Guide,2017
参考来源
- 位置:《凤凰架构:构建可靠的大型分布式系统》第2章"访问远程服务"2.2.2节
"RESTful的系统"(源文件:_epub-src/OEBPS/Text/chapter21.xhtml)
- 结论依据:原文用login/logout对比"PUT Session/DELETE Session"、用商城
用户中心的资源层次结构(`GET /users/icyfenix/cart/2`)说明面向资源比
面向服务抽象程度更高、学习成本更低,并引用Google API Design Guide对
RPC逐方法学习负担的批评,直接支撑本卡片结论。
- 原始内容:以前,人们面向方法去设计RPC API,譬如CORBA和DCOM,随着时间推移,接口与方法越来越多却又各不相同,开发人员必须了解每一个方法才能正确使用它们,这样既耗时又容易出错。——Google API Deign Guide,2017