BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

Mike Amundsen有关API设计的研讨会(Workshop)

| 作者 Saul Caganoff 关注 1 他的粉丝 ,译者 臧秀涛 关注 4 他的粉丝 发布于 2013年9月12日. 估计阅读时间: 6 分钟 | QCon上海2018 关注大数据平台技术选型、搭建、系统迁移和优化的经验。

Mike Amundsen是Layer 7公司的首席API架构师,也是“Building Hypermedia APIs with HTML5 & Node”一书的作者。他最近进行了一次全球巡讲,分别在芝加哥、悉尼、墨尔本和多伦多等地组织了一系列有关API设计的研讨会。InfoQ于7月25日参加了他在墨尔本举行的研讨会。

Amundsen的设计技巧主要关注的是USE范型(USE paradigm),这是Usable(易用)、Scalable(可伸缩)和Evolvable(可演进)的缩写。Amundsen描述了3种常用的API实现风格,并使用USE范型中的各种原则比较了其优缺点。

Amundsen详细探讨了版本化(Versioning),建议“除非迫不得已,不要使用版本化”。应该首选演进式设计。

“易用性(Usability)是指人们设计的对象易于学习和使用”,Amundsen如是说。这提醒我们,API从字面上看就是“接口”,应该以用户和任务为重点。他还说到,“请准备好实验测量,并在接口设计上进行迭代。”

“可伸缩性(Scalability)是系统处理不断增长的工作的能力。” Amundsen提到,需要理解垂直伸缩(scale-up)和水平伸缩(scale-out)的区别。短期来看垂直伸缩比较容易,但不能持久。水平伸缩在短期内难于实现,但长期来看则更为可靠。Amundsen建议使用DevOps实践来支持水平伸缩。

“可演进性(Evolvability)是系统适应演进的能力。”Amundsen建议,只要可能就应该选择扩展API,而不是版本化。“除非万不得已,不要进行版本化,而必须进行版本化的场合非常少。”版本化对内部代码管理是有意义的,但Web API用户关注的只是是否存在破坏。通过“绝不删除条目”的方式,我们可以在不破坏现有实现的情况下完成修改。扩展接口意味着绝不修改现有数据结构的意义,将所有新加入内容都设计为可选的(optional)。但有时我们不得不引入破坏性的变化,这时就要使用“版本化”了。在这种情况下,要使版本信息易于识别。“要使之易于构建,易于测试,而且不容易在多个流之间出现交叉”,Amundsen提到。“要对客户端忽略这些信息有所准备,因为它们确实会这么做。”Amundsen建议将版本标识符放在URL中,而不要放在首部或有效载荷中,以方便客户端忽略它们。

Amundsen介绍了3种最常用的API实现风格:Tunnel风格(SOAP)、URI风格(CRUD)和超媒体风格(REST),并回顾了各种实现风格的历史及优缺点。他还强调,这些风格并不是标准的。

Tunnel风格使用SOAP以独立于转移协议的方式转运消息。该风格主要关注函数和方法,有很好的易用性。对企业而言,该风格有很好的工具支持和较强的治理机制。然而,它也存在一些不足:栈依赖导致了一种“全有或者全无(all or nothing)”的限制,对HTTP支持较差,在程序员之间的受欢迎程度在不断下降等。在可演进性方面,SOAP带来了很大的治理和版本化问题,因为即便模式(schema)上的微小变化,都有可能是破坏性的。Amundsen指出,很多人都不再使用SOAP代理模型,而更多地将SOAP用作一种消息模型,这避免了很多缺点。

URI风格使用HTTP动词和(通常是)JSON数据结构来操控Web资源。Amundsen提醒我们,该风格不是REST的,他引用了Roy Fielding在2008年的一篇博客中的论断:如果API不是超文本驱动的,那就不是REST的。URI风格是一种面向对象或面向实体的风格,今天大量的公开API都使用了这种风格。HTTP协议众所周知,对象池技术也不错,因此修改这样的API相对容易。然而该风格的易用性是有限制的,因为HTTP方法集较小,而且URI建模也不是标准的。用户必须把领域方法映射为资源和HTTP方法。Amundsen指出,URI风格“容易上手,但是难以伸缩和演进”。

Amundsen最后描述了超媒体风格,或者说REST。相对于URI风格,超媒体风格引入了媒体类型和链接关系,Amundsen认为这对消息各方达成共识至关重要,因此该风格的可用性有所增强。超媒体风格暴露出了任务和用例,而且在为文档化工作流程提供一种机器可读的方式这方面,它的做法与SOAP越来越接近。超媒体支持可演进性,这就使服务可以长期使用。但是人们认为这种风格深奥难懂,而且没有很好的工具支持。Amundsen认为Siren这种超媒体框架非常有趣,值得一看。

Amundsen经常向InfoQ贡献内容。他与Leonard Richardson和Sam Ruby合著的新书“RESTful Web APIs”预计本月上市。

查看英文原文:Mike Amundsen Workshop on API Design

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我
社区评论

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT