课程大纲 第 68 课,共 148 课 · 没人能误用的 API
没人能误用的 API

让状态变得明确

为什么重要 有生命周期的对象(连接、文件、事务、支付),正是“在我的机器上是好的”所在的地方。一次顺序错误的调用应该当场失败,而不是在之后弄坏某样东西。

你正在为团队的其他人包装一个网络传输层。这个传输层本身是底层的:connect()、write(data)、disconnect(),让它做什么它就做什么。上个季度的一份事故复盘发现,有一个任务在关闭之后发送了数据,并悄悄地重新连接到了错误的服务器。你的包装器必须让这种情况变得不可能。

状态机:一小组状态(新建、打开、关闭),以及在每个状态下允许的调用。其他任何调用都会被拒绝。

c = Connection(transport)
c.open()
c.send(b"hello")
c.close()

with Connection(transport) as c:   # opens, and always closes
    c.send(b"hello")
轮到你了

编写 class Connection,带有 __init__(self, transport)、open()、send(data)、close(),并支持 with(进入时打开,退出时关闭,即使代码块抛出了异常)。它们会调用传输层的 connect()、write(data) 和 disconnect()。

隐藏的误用脚本会尝试下面的每一种。每一种都必须在出错的那次调用上、在任何东西到达传输层之前抛出异常:

  • RuntimeError(或其子类):在打开之前发送或关闭;打开两次;在关闭之后发送、关闭或再次打开(一个已关闭的连接就结束了;新建一个);在一个 with 代码块之后发送;
  • TypeError:发送任何不是类字节对象(bytes 或 bytearray)的东西。不要替调用者编码字符串。

发现这节课有问题?报告它 · 就这节课提问

这个练习即将开放

完成它前面的那一课,这一课就会解锁。整门课程免费,无需账号,而且你现在就可以阅读这节课。