知识卡片

普通读书笔记卡 · 6366.i.5.d.2

参数防护须符合修改契约

理解等级:中级

避免被调函数影响输入时,可在调用端或函数内部建立副本,但先确认接口是否本来就承诺原处修改。若调用者依赖该修改,悄悄换副本会违反契约;选定职责后再决定返回新对象还是修改传入对象。

避免调用者不知情的输入修改;若更新共享对象正是接口责任,应清楚说明,而非为追求表面自包含悄悄丢掉必要效果。封闭状态也能延续信息,不能把全局说成不用类就唯一或总是最佳方案。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 2 处

    • · 查看原书依据

      修改可能是一个定义良好的API的一部分,而我们不应该通过产生副本来违反该API。 但是,你必须要意识到这个属性:如果在你没有预期的情况下对象在外部发生了改变,检查一下是不是一个调用了的函数引起的,并且有必要的话当传入对象时进行拷贝。

    • · 查看原书依据

      不要改变可变类型的参数,除非调用者希望这样做。函数会改变传入的可变类型对象,但是就像全局变量一样,这会导致很多调用者和被调用者之间的耦合性,这种耦合性会导致一个函数过于特殊和不友好。 ·聚合性:每一个函数都应该有一个单一的、统一的目标。在设计完美的情况下,每一个函数中都应该做一件事:这件事可以用一个简单说明句来总结。如果这个句子很宽泛(例如,“这个函数实现了

    参考来源

    - 位置:《Python学习手册(原书第4版)》第18章《避免可变参数的修改》(spine730;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0701.html;u392-ch18-001)。 - 结论依据:原文在“修改可能是一个定义良好的API的一部分”附近的定义、例子或代码支撑本卡核心说明:避免被调函数影响输入时,可在调用端或函数内部建立副本,但先确认接口是否本来就承诺原处修改。边界按已读前提解释;示例未执行。 - 原始内容:修改可能是一个定义良好的API的一部分,而我们不应该通过产生副本来违反该API。 但是,你必须要意识到这个属性:如果在你没有预期的情况下对象在外部发生了改变,检查一下是不是一个调用了的函数引起的,并且有必要的话当传入对象时进行拷贝。 - 位置:《Python学习手册(原书第4版)》第19章《函数设计概念》(spine747;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0718.html;u412-ch18-001)。 - 结论依据:避免调用者不知情的输入修改;若更新共享对象正是接口责任,应清楚说明,而非为追求表面自包含悄悄丢掉必要效果。封闭状态也能延续信息,不能把全局说成不用类就唯一或总是最佳方案。 - 原始内容:不要改变可变类型的参数,除非调用者希望这样做。函数会改变传入的可变类型对象,但是就像全局变量一样,这会导致很多调用者和被调用者之间的耦合性,这种耦合性会导致一个函数过于特殊和不友好。 ·聚合性:每一个函数都应该有一个单一的、统一的目标。在设计完美的情况下,每一个函数中都应该做一件事:这件事可以用一个简单说明句来总结。如果这个句子很宽泛(例如,“这个函数实现了