← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 2277.i.10

统一接口降低学习成本

理解等级:未标注

统一接口是理解面向资源价值的关键。登录注销若设计成 login()、logout() 两个服务,接口会随功能不断膨胀、逐个学习;若看作 Session 资源,登录是 PUT,注销是 DELETE,查询是 GET,一种资源就覆盖全部需求。以动词为中心的接口互相独立,以名词为中心的接口天然有集合与层次,调用者只需掌握一套通用操作语义。代价是 REST 绑定在 HTTP 之上,受其边界限制。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 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