知识卡片
事件入口应显露状态改变
passwordAttemptFailedNtimes(attempts)把一次失败次数通知系统,目的不是回答一个静态事实,而是驱动状态或后续处理。这样的无返回入口应在名称和上下文中显露其动作,避免被当作可任意重复的查询。是否允许重试、重复通知或忽略失败属于具体契约,本章只是用事件形式区分输入用途。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第3章 函数
原书出处 · 1 处
- 第3章 函数 3.5 使用描述性的名称 · 查看原书依据
程序将函数看作是一个事件
参考来源
- 位置:《代码整洁之道》全书 · 第3章 函数,spine012单元004;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0010.xhtml。
- 结论依据:原文明确事件接收输入并改变状态,支持通知动作与查询/转换区分;重试边界为使用时需确认事项,不补造书中处理协议。未在本机运行示例或改变环境。
- 原始内容:。在这种形式中,有输入参数而无输出参数。程序将函数看作是一个事件,使用该参数修改系统状态,例如void passwordAttemptFailedNtimes(int attempts)。小心使用这种形式。应该让读者很清楚地了解它是个