知识卡片
接口让块密码组合为流
Block 接口提供 BlockSize、Encrypt 和 Decrypt,分别约定块大小、单块加密与单块解密;Stream 只约定 XORKeyStream,用密钥流与输入数据异或完成处理。二者是不同的行为契约,Stream 不继承 Block。
译本示例把 Encrypt、Decrypt 的参数名写成 src, dst;现行 Go 接口使用 dst, src,调用时应以现行签名为准。
NewCTR(block Block, iv []byte) Stream 是构造函数:接收满足 Block 的块密码实现和初始向量 iv,返回满足 Stream 的流实现,将块密码适配为 CTR 流式使用。iv 的长度必须等于块大小。Go 类型只要具备接口要求的方法集合,就隐式实现该接口,无需声明继承。
调用方通过返回的 Stream 调用 XORKeyStream,无需依赖具体块密码类型。更换满足 Block 的实现,或更换返回 Stream 的模式构造函数时,可以将相应改动限制在构造环节;调用方仍按同一接口使用结果。这个替换边界成立的前提是调用方没有依赖具体实现的额外行为。
结构图:
类图(Encrypt、Decrypt 使用现行 Go 的参数名顺序;“实现”节点仅表示接口角色,不代表原文给出了具体类型或字段):
classDiagram
direction TB
class Block {
<<interface>>
+BlockSize() int
+Encrypt(dst, src []byte)
+Decrypt(dst, src []byte)
}
class Stream {
<<interface>>
+XORKeyStream(dst, src []byte)
}
class BlockImpl["块密码实现(示意)"]
class StreamImpl["返回的流实现(示意)"]
class Factory["NewCTR(构造函数,非类型)"] {
+NewCTR(block Block, iv []byte) Stream
}
class Caller["调用方"]
BlockImpl ..|> Block : 隐式实现
StreamImpl ..|> Stream : 隐式实现
Factory ..> Block : 参数依赖
Factory ..> Stream : 返回接口
Caller ..> Stream : 调用 XORKeyStream
虚线空心三角指向被实现的接口;虚线箭头表示使用依赖。NewCTR 的框用于展示函数签名与依赖,不表示 Go 中存在名为 Factory 的类。原文没有展开返回实现的字段,因此不画内部持有关系。
构造与使用结构图:
flowchart LR
A[块密码实现] -->|满足方法集合| B[Block 接口]
B --> C[NewCTR 适配]
D[初始向量] --> C
C --> E[Stream 接口]
E --> F[调用方按流处理]
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 接口和其它类型 · 查看原书依据
func NewCTR(block Block, iv []byte) Stream
参考来源
- 位置:《Effective Go中文版》第11章《接口和其它类型》(源文件:`_epub-src/OEBPS/接口和其它类型.md.html`)
- 结论依据:原文给出 `Block`、`Stream` 的方法集合及 `NewCTR(block Block, iv []byte) Stream`,并指出构造器依赖接口以隔离具体算法。
- 版本核验:[Go 官方 Effective Go](https://go.dev/doc/effective_go)、[现行 crypto/cipher 文档](https://pkg.go.dev/crypto/cipher)(2026-10-15 访问);译本的 `Encrypt`、`Decrypt` 参数名顺序与官方版本不同。
- 原始内容(方法集合):
```go
type Block interface {
BlockSize() int
Encrypt(src, dst []byte)
Decrypt(src, dst []byte)
}
type Stream interface {
XORKeyStream(dst, src []byte)
}
```
- 原始内容(构造签名与初始向量约束):
```go
// NewCTR returns a Stream that encrypts/decrypts using the given Block in
// counter mode. The length of iv must be the same as the Block's block size.
func NewCTR(block Block, iv []byte) Stream
```