小接口更稳
接口方法越少,抽象越宽,组合空间越大。Go 鼓励用单方法小接口表达行为,再用组合形成更具体契约;这让模块能自然增长,而不是过早固化继承层次。
主题对照
比较接口粒度、隐式/显式实现、接口值表示与动态分派的取舍。
接口方法越少,抽象越宽,组合空间越大。Go 鼓励用单方法小接口表达行为,再用组合形成更具体契约;这让模块能自然增长,而不是过早固化继承层次。
Go 的类型不用声明“我实现了某个接口”。只要它的方法集包含接口要求的全部方法,就算实现了这个接口。
示例:书中的 Rectangle 写齐 Shape 要求的方法后,即使它还有别的方法,也没有写任何实现声明,就可以当作 Shape 使用。调用方只定义自己需要的行为,提供方不必互相知道对方。
非空接口在运行时带着两样东西:类型表记下当前装入的具体类型和方法入口,数据指针指向具体的值。空接口没有方法清单,只保留具体类型的元数据和数据指针。所以接口值不是单独一个对象,而是动态类型和动态值这一对组合。
接口等于 nil 只有在动态类型和动态值都为空时成立。一个保存了 *PathError 类型但值为 nil 的 error 并不等于 nil;边界返回错误时要避免把 nil 指针装进接口。
本书讨论的普通函数中,this 由调用方式决定:方法调用绑定到接收对象,非严格模式下直接函数调用绑定到全局对象,构造器调用绑定到新对象,apply 可显式指定。绑定发生在调用时,使同一函数可被不同对象复用。发散:排查旧式函数的 this 时,应先检查调用表达式;这组规则有本书所处语言版本与函数形式的适用边界。
查询不改变可观察状态,修改器改变状态。把二者分开能让调用顺序更可推理,也减少“取值顺便改状态”的隐性耦合。
泛化在软件视角下常对应继承,但有效继承依赖可替换性:任何需要超类型的地方都应能使用子类型。否则继承只是共享代码,容易破坏调用者假设。
按契约设计用前置条件、后置条件和不变式明确责任。前置条件把检查责任交给调用者,后置条件表达操作承诺,不变式维持类的长期一致性。
接口让客户依赖所需能力而不是具体实现。创建时短暂知道实现类通常可接受,但对象其余部分应尽量只面向最通用的接口编程。
操作(operation)和方法(method)常被混用,但严格来说不同:操作是对象上可调用的例程声明,方法是该例程的具体实现体。多态场景下差异会暴露——若超类型的getPrice操作被3个子类型分别覆盖,系统里只有1个操作,却对应4个实现(超类1个+子类3个)。讨论调用了什么说的是操作,讨论具体执行了哪段代码说的是方法,多态成立正是因为同一操作运行时能绑定到不同方法。
UML把不改变系统可观察状态、只取值的操作称为查询(query);把改变状态的操作称为修改器(modifier,也叫命令)。区分两者的价值:查询之间可任意调整执行顺序而不影响系统行为,给重构和推理代码留出空间。Meyer的命令-查询分离原则建议修改器不返回值,这样有返回值的操作就自动等于查询。获取/设置方法只是查询/修改器的具体实现,客户不该也不能从外部分辨查询是不是简单的获取方法。
泛化把共性抽到超类型、差异放进子类型,如Customer拆出Personal与Corporate Customer。判断子类型是否合格的关键原则是可替换性(Liskov替换原则):用到Customer的代码换成Corporate Customer都应照常工作,调用者不需关心差异。继承是实现可替换性的常见手段,但带来不必要的包袱,因此有人区分子类型化(接口继承,只要求可替换)与子类化(实现继承)。
按契约设计用断言(不应为假的布尔陈述,为假只因bug)精确划分接口责任,核心三种断言:前置条件(执行前世界应满足的条件,如求平方根要求input≥0)明确调用者的检查责任;后置条件(执行后世界应变成的样子,如input等于result乘result)说明操作承诺做什么而非怎么做;不变式(关于类本身任何时候都应为真的断言)约束实例状态一致性。三者共同把谁负责检查什么写清楚,避免漏检或重复检查。
继承的危险之一是子类重定义操作时可能和超类的承诺不一致,[[按契约设计的三种断言|契约]]限制子类能改什么来防止这种不一致:不变式和后置条件必须应用到所有子类,子类只能加强、不能减弱;前置条件则相反,只能减弱、不能加强。这个反直觉的规则背后是[[泛化与可替换性|可替换性原则]]——若子类加强了前置条件,超类操作按超类契约调用子类实例时就可能失败,破坏了动态绑定的基础。
抽象类(abstract class)不能被直接实例化,只能实例化其子类;通常带抽象操作(abstract operation)——只有声明没有实现体。接口是所有特性都抽象的类,用«interface»标注。类和接口有两种关系:类可替换接口使用即供给(provides)该接口(Java/.NET靠实现接口,C++靠继承接口类);类需要接口实例才能工作即需要(requires)该接口,本质是依赖它。
以Order用List接口而非直接用ArrayList为例:Order依赖List接口、只用equals/add/get几个方法,实际连接对象是ArrayList实例,但Order无需知道这点。好处是换实现更容易——换成性能更好的List实现,不改Order任何逻辑代码,因lineItems类型声明是List而非ArrayList,只需改创建时那行初始化代码,这正是对接口而非实现编程原则的体现。
收入确认的例子中,每个产品关联一个确认策略对象,不同产品类型对应不同策略子类,计算时从合同经产品传给策略。新增算法可通过策略子类扩展既有计算主链路;创建或配置产品时仍须选择新策略。更深的效果是:产品创建时一旦挂上策略,后续计算代码中就不再有条件判断,决策路径在建立对象关系时就已确定,而不是运行时靠 if-else 层层判断。领域模型应对一组相似判断的通用做法,就是把复杂性从算法内部转移到对象之间的关系里。
分离接口把接口定义在一个包、实现放在另一个包,客户只依赖接口,不知道实现包的存在。典型场景是框架代码调用应用代码、领域层调用数据映射器、调用其他团队的功能而不想被其 API 变动绑架。但给每个类都套上分离接口是过犹不及:保持分离要额外工作,往往还要配工厂类;一开始放在一起,真需要时再拆也只是一次简单重构。只有确实要打破依赖、会有多个实现,或要在编译期强制包依赖规则时,才值得引入。
空值破坏多态,使用引用前必须先判空,判空代码到处重复;它只是“特殊情况需特殊处理”中最常见的一种。特殊情况模式为这类情形建一个子类,如“空顾客”,重载所有方法提供无害的默认行为,原本返回空值的地方都返回它。通常可用享元共享实例,但需要各自累积欠费的居民客户就不能共享。“没有顾客”与“有一个身份不明的顾客”含义不同,宜用不同子类表达;其方法的返回值也应是特殊情况对象。
字段和参数尽量声明为满足需求的最通用接口,把具体实现隐藏在内部。用 Set 声明组、用 HashSet 实例化,使后续替换实现时影响更小。发散:接口声明表达契约,具体类表达当前策略。
像 connectTo 这种接收同类对象的方法,在Java类型系统中难以严格表达“只能连接同一具体类型”。泛型自类型惯用法能提高安全性,但仍依赖实现者遵守约定。
Open、Close、Read、Write、IOCTL 这类驱动接口把不同外设统一成少数操作,既能屏蔽设备差异,也能让调用方按能力而非型号编程。发散:好的驱动接口应表达“这个设备能做什么”,而不是泄露“这个芯片怎么接线”。
等待设备状态可由select/poll承担,共享映射由mmap承担;裸机不必强制实现完整POSIX模型,应从设备能力选择接口。
适配器模式把现有模块包装成系统需要的接口,使高层代码不必直接理解外设原生协议。发散:当硬件型号、通信协议或第三方库不可控时,适配层是保护架构稳定性的缓冲垫。
按钮、LED 等子系统可以在 I/O 处理层之上提供 ButtonPressed、LedOn 这样的门面接口,让调用方表达动作而非电平。发散:它把[[寄存器是硬件API]]进一步包成业务动作,使代码不被高低电平细节淹没。
门面着重简化使用,适配器着重转换接口,两者可以配合,但不是固定继承或通用化关系。
所有调用都汇入同一个invoke入口后,还要区分不同方法对应的不同HTTP请求。Feign在创建代理时先解析接口,为每个方法生成一个专属的方法处理器,封装该方法的URL拼装和调用逻辑,再建一张“方法反射对象→方法处理器”的映射表。invoke时按方法查表并交给对应处理器执行。统一入口和按方法分派由一张注册表同时满足。
Lambda只能赋给只有一个抽象方法的函数式接口,而订阅者接口有onNext、onCompleted、onError三个方法,无法直接用Lambda。RxJava没有改造订阅者接口,而是另定义了Action0、Action1等单方法接口,并提供接收它们的订阅方法,调用方只传自己关心的回调。多方法接口阻碍函数式调用时,可以拆出单方法的轻量入口,内部再适配回完整接口。
业务流程若直接依赖数据库库的具体 API,替换库时就要改动订单插入等核心流程。把业务所需的最小操作定义为接口,由适配层实现并在初始化时注入,可将替换影响限制在适配层;仍需验证新实现的业务语义。关联[[小接口更稳]]。
接口的类型断言 i.(T) 检查当前动态值是否为 T;单返回值形式失败会 panic,双返回值形式返回零值和 ok=false,适合处理可预期的类型分支。nil 接口也不会断言成功。
把源接口值赋给目标接口变量时,编译器先按源接口的方法集判断其是否实现目标接口;不满足就编译失败。i.(T) 则在运行时检查当前动态值是否满足 T,失败可用双返回值的 ok=false 处理。两者检查时机不同,不能把静态赋值失败推广为“接口之间绝不能转换”。关联[[断言失败要接收ok]]。
空接口没有方法要求,能承载任意具体类型;装入后只能按接口允许的操作使用,若要依据动态类型分支,可用类型断言或 type switch。它提供通用入口,也把一部分类型检查移到运行时。
点击箭头逐层展开,点击卡片标题查看详情。路径上下文仅用于连接层级,不计入主题卡片数。
来源书籍
编程语言类
书籍类型:未标注
清单覆盖 6/9
80 张卡片
来源书籍
编程语言类
书籍类型:经典原理
清单覆盖 8/9
182 张卡片
来源书籍
编程语言类
书籍类型:未标注
类别清单尚未核对
106 张卡片
来源书籍
书籍类型:经典原理
312 张卡片
来源书籍
框架类
书籍类型:工程实践
清单覆盖 8/8
42 张卡片
来源书籍
领域建模类
书籍类型:经典原理
清单覆盖 7/7
132 张卡片
来源书籍
领域建模类
书籍类型:未标注
清单覆盖 7/7
148 张卡片
来源书籍
系统架构类
书籍类型:经典原理
清单覆盖 3/6
177 张卡片
来源书籍
代码可读性与重构类
书籍类型:经典原理
清单覆盖 7/7
109 张卡片
来源书籍
分布式存储系统类
书籍类型:未标注
清单覆盖 5/5
75 张卡片
来源书籍
机器人与嵌入式系统实战类
书籍类型:未标注
清单覆盖 7/7
297 张卡片
来源书籍
书籍类型:工程实践
39 张卡片
来源书籍
系统架构类
书籍类型:未标注
清单覆盖 5/7
194 张卡片
来源书籍
书籍类型:未标注
357 张卡片
来源书籍
书籍类型:未标注
83 张卡片
来源书籍
书籍类型:未标注
84 张卡片
来源书籍
设计模式类
书籍类型:经典原理
清单覆盖 7/7
65 张卡片
来源书籍
设计模式类
书籍类型:经典原理
清单覆盖 7/7
175 张卡片
主题索引
比较 RPC 要解决的基本问题与历代框架取舍,以及 REST 的资源抽象、统一接口、成熟度与局限。
主题索引
比较嵌入式系统在资源约束下的硬件抽象、驱动与外设通信、执行器控制、固件更新与低功耗设计。
主题索引
比较以函数、闭包、包或服务划定模块边界并隐藏实现细节的方法。
主题索引
在类与对象的组合方式上做文章:适配器、桥接、组合、装饰、门面、享元、代理,以及包装家族的意图差异。
主题索引
串口、SPI、I2C、并行与单总线在时序与拓扑上的取舍,PWM 与定时器怎样用时间换幅度,ADC 采样率与位数怎样决定数据负担,传感器校准、执行器驱动与显示刷新各自的约束。
主题索引
事务脚本、领域模型、表模块与服务层的选型、演化与边界:业务逻辑放在哪里、以何种结构组织。
与 3 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;共享 2 个其他主题;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;共享 1 个其他主题;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 2 张主题卡片存在结构化链接;来自相同书籍;属于相同分类