如何设计好的 API 以及为什么它很重要

How To Design A Good API and Why it Matters

频道:Google TechTalks · 时长:1:00:19 · 发布:2007-10-09 · 播放:453717

在 YouTube 观看

简介

Joshua Bloch 在 Google Tech Talk 中讲解如何设计好的 API 以及为什么它很重要,并给出具体原则和示例。他认为每个程序员都是偶尔的 API 设计者。

HN 为什么推荐

HN 反复称其为 API 设计的最佳资源,是任何“如何设计 API”问题的标准答案。

绝对是我找到的最好的资源,就是 Joshua Bloch 的这个 Google TechTalk。 — HN, 2012

Python、Ruby 与脚本语言 · 软件架构与设计

中文字幕节选

>> 首先,我要感谢并欢迎 大家参加我们系列讲座的最新一期, 主题是高级话题和编程语言。 这个系列讲座的目的是 分享谷歌在编程语言方面 积累的丰富领域知识。 所以——这意味着在座的每一位,所有为谷歌工作的天才们, 当然不包括我自己,都应该来做一次演讲。 所以,请来找我,我叫 Jeremy Manson, 给我发邮件、即时消息,随便什么方式,告诉我 你打算讲什么,我会安排并让你来做演讲。 你不必像 Josh 或我们即将邀请的 一些人那样是作者才能来讲。 Josh——我们时间有点晚了。 Josh 不想让我把他捧得太高,让他冲昏头脑。 所以,我想介绍一下他。 我只想说,在一个满是天才的公司里, 他的光芒可能是最耀眼的。 我只想…… >> BLOCH:我会找你算账的。 >> 我只想介绍这位我连他的鞋跟都不配舔的人,Joshua Bloch,女士们先生们。 >> BLOCH:通常这个时候,我会感谢 介绍人,但今天 我想我就不拘这个形式了。 所以,我应该——顺便说一句,我还应该说明 不幸的是,这是一个相当长的演讲。 我尽量做短演讲,只讲一两个关键 想法,但这个主题不适合那样。 所以,请把问题留到最后, 事实上,我们可能会用满一个小时 而不留提问时间,但之后我会留下来, 你们想留多久都行,我会回答你们所有的问题。 那么,为什么 API 设计很重要? 嗯,API 可以是一个公司最大的资产之一。 好的 API 是人们会大量投入的东西。 他们以明显的方式和不太明显的方式这样做。 明显的方式可能是围绕 API 构建的副产品。 他们基于 API 来编写代码。但不太明显的方式是他们学习它。 他们花上无数个小时——实际上,他们花几个月学习这些 API。 一旦他们这样做了,你知道,他们就不想再学新的了,因为 他们必须忘掉所知道的一切,用别的东西来替代。 此外,API 已经贯穿整个公司的基础设施。 所以,一个成功的 API 可以成就一个公司,可以带来持久的特许经营权。 所以——我想现在大约有二十五年了, 同样,一个糟糕的 API 也可以是一个公司最大的负债之一。 这有几个原因。 首先,一个糟糕的 API 会导致没完没了的 支持电话,因为 人们无法让这个东西做它应该 做的事,而且它会阻碍公司 前进的能力,因为一旦你有了糟糕的 API,你就不能随意更改它。 你基本上永远被它困住了。 你只有一次机会把它做对。 所以,这相当可怕,考虑到这一点, 你想学习如何制作能经受时间考验的 API。 现在你们知道了为什么 API 设计重要,但为什么它对你们重要? 不是所有人都认为自己是 API 设计师。 嗯,事实证明你们所有人都是 API 设计师。 任何编写计算机程序的人都是 API 设计师。 原因是好的编程本质上是模块化的,而这些模块间的 边界本身就是 API。 此外,好的 API 往往会被复用。 如果你写了一个模块,并且它擅长

HN 上的讨论

好文章。我也强烈推荐 Joshua Bloch(Java 的合著者)的“如何设计一个好的 API 以及它为何重要”视频。他挖掘得更深入,主要是在代码层面而非 JSON 层面,但同样的原则适用。尽管这个视频已经快 20 年了,但其中的主题在今天依然和当时一样重要。[VIDEO] — minzak, 2025-08
我在现在的工作中正在构建一个公共 API,几周前,我四处寻找好的 API 设计建议。绝对遥遥领先,我找到的最好的资源是 Joshua Bloch 的这个 Google TechTalk:[VIDEO] 如果你对这个话题感兴趣并且还没看过,我强烈建议你尽快去看。 — philbo, 2012-03
显然,这是营销而不是对主题的严肃处理。它似乎基本上在说:“为了设计一个系统,你应该接受过正规的本科计算机科学教育”,这似乎可能是一个先决条件(也许还能说明他们的招聘流程),但不太有用。然而,值得一提的是,我见过的关于系统设计的两个最佳资源是: 计算机系统设计提示:[LINK] 如何设计一个好的 API:[VIDEO] 这个参考书目中还应该有什么? — socratic, 2011-10
这里有一些我的最爱:如何设计一个好的API以及为什么它重要 [VIDEO] 敏捷方法:好的、炒作的和丑陋的 [LINK] — DanPristupov, 2018-10
a.) 关于 Java - 一小时的演讲但很好:* 如何设计一个好的 API 以及为什么它很重要 [VIDEO] b.) 一般代码结构 - 除非你喜欢,否则不要从头到尾读,你会无聊死的,但一定要在图书馆里看看。它会帮助你以正确的方式思考代码结构。* 重构:改善既有代码的设计 * 代码大全 c.) 面向对象编程 * 设计模式:可复用面向对象软件的基础 我推荐的三本书比较老,但面向对象编程的基础没有太大变化。它们可读性很好。我还建议读一些关于函数式编程的东西,主要是为了让你看到另一种方法,从而不会在对象设计不适合的地方走得太远。d.) 8.) 我读了一本关于估算的极好的书,我真的真的希望是这本:* 软件估算:黑匣子揭秘 长话短说:谈判和估算之间有区别,确保你知道你在做哪一个。把它分成更小的任务,然后估算最小值、最大值和最可能值。然后计算 (min+4*likely+max)/6。令人惊讶的是… — watwut, 2018-01

相关视频