知识卡片

普通读书笔记卡 · 5913.a.1.b.3.a.1

共享状态修改入口应明确

理解等级:中级

import first后可改first.X,这会改变模块对象的属性,而非仅改当前模块私有副本。把修改放进first.setX(new)之类明确入口,可让维护者发现哪些操作负责变化,并集中校验;函数包装本身仍不自动保证线程安全或禁止外部直接赋值。

本地x重绑不回写small.x;通过模块引用写small.x才修改该模块属性。取得模块引用未必只能用一条import,也可由参数等提供;核心是明确修改的是哪个对象。对共享列表的索引修改与名称改绑仍不同。

读取外部提供的接口与直接改写外部全局绑定有不同耦合效果。必要状态修改应由有责任的接口表达,不能只因模块可访问就到处赋值;函数调用也可能有副作用,仍需说明契约。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 3 处

    • · 查看原书依据

      使用accessor函数去管理这种变化。 这需要更多的代码,但是这在可读性和可维护性上有着天壤之别:当人们仅阅读第一个模块文件时看到这个函数,会知道这是一个接入点,并且知道这将改变变量X。换句话说,它删除了令人惊讶的元素,在软件项目中过多地使用它们并非好事。虽然我们无法避免修改文件间的变量,但是通常的做法是最小化文件间变量的修改。

    • · 查看原书依据

      修改另一个文件中的全局变量名,必须使用import。 这种现象已在第17章介绍过。因为像这样修改其他模块内的变量是常常困惑开发人员的原因之一(通常也是不良设计的选择),本书这一部分稍后会再谈到这个技巧。注意:前一个会话中对y[0]的修改是不同的。这是修改了一个对象,而不是一个变量名。

    • · 查看原书依据

      少去修改其他模块的变量。我们在第17章中以代码做过说明,但值得在这里重复:使用另一个模块定义的全局变量,这完全是可以的(毕竟这就是客户端导入服务的方式),但是,修改另一个模块内的全局变量,通常是出现设计问题的征兆。当然,也有些例外,但是应该试着通过函数参数返回值这类机制去传递结果,而不是进行跨模块的修改。否则,全局变量的值会变成依赖于其他文件内的任意远程赋值

    参考来源

    - 位置:《Python学习手册(原书第4版)》第17章《最小化文件间的修改》(spine719;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0690.html;u377-ch17-009)。 - 结论依据:原文在“使用accessor函数去管理这种变化”附近的定义、例子或代码支撑本卡核心说明:import first后可改first.X,这会改变模块对象的属性,而非仅改当前模块私有副本。边界按已读前提解释;示例未执行。 - 原始内容:使用accessor函数去管理这种变化。 这需要更多的代码,但是这在可读性和可维护性上有着天壤之别:当人们仅阅读第一个模块文件时看到这个函数,会知道这是一个接入点,并且知道这将改变变量X。换句话说,它删除了令人惊讶的元素,在软件项目中过多地使用它们并非好事。虽然我们无法避免修改文件间的变量,但是通常的做法是最小化文件间变量的修改。 - 位置:《Python学习手册(原书第4版)》第22章《文件间变量名的改变》(spine811;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0782.html;u492-ch17-009)。 - 结论依据:本地x重绑不回写small.x;通过模块引用写small.x才修改该模块属性。取得模块引用未必只能用一条import,也可由参数等提供;核心是明确修改的是哪个对象。对共享列表的索引修改与名称改绑仍不同。 - 原始内容:修改另一个文件中的全局变量名,必须使用import。 这种现象已在第17章介绍过。因为像这样修改其他模块内的变量是常常困惑开发人员的原因之一(通常也是不良设计的选择),本书这一部分稍后会再谈到这个技巧。注意:前一个会话中对y[0]的修改是不同的。这是修改了一个对象,而不是一个变量名。 - 位置:《Python学习手册(原书第4版)》第24章《模块设计理念》(spine845;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0816.html;u536-ch17-009)。 - 结论依据:读取外部提供的接口与直接改写外部全局绑定有不同耦合效果。必要状态修改应由有责任的接口表达,不能只因模块可访问就到处赋值;函数调用也可能有副作用,仍需说明契约。 - 原始内容:少去修改其他模块的变量。我们在第17章中以代码做过说明,但值得在这里重复:使用另一个模块定义的全局变量,这完全是可以的(毕竟这就是客户端导入服务的方式),但是,修改另一个模块内的全局变量,通常是出现设计问题的征兆。当然,也有些例外,但是应该试着通过函数参数返回值这类机制去传递结果,而不是进行跨模块的修改。否则,全局变量的值会变成依赖于其他文件内的任意远程赋值