知识卡片
定义边界集中安装扩展
把扩展放在函数或类定义旁边,可让读者直接看到它的管理意图,并集中安装逻辑,避免每个调用点重复加同一套操作。需要改变扩展策略时,可在这一处维护,而不是追踪所有调用方是否记得执行辅助步骤。
这是一种表达和维护取舍,不是必须使用新能力:显式辅助函数和手动重绑定也能实现许多相同功能。一次定义执行时应用装饰,不表示整个程序生命周期只可能定义一次;包装器仍可能为每次调用增加成本或改变对象类型,必须连同接口与状态契约一起判断。
873的02370将计数移到显式tracer(func,*args)辅助函数,需要每个调用点自选是否经过;装饰版重绑入口后普通按名调用经过包装,可减少忘记附加逻辑的机会。两者都可用手动重绑达到相近安装效果,语法本身不是不可绕过的控制边界。
882的02422-02425分别对照显式Wrapper(Spam())/装饰后Spam()、getInstance(类,*args)/装饰构造、getInstance(已建对象)和显式tracer调用。语法负担从每个调用点移到定义处;最后的显式tracer参数形态要与其具体辅助函数签名一致,不能拿一个装饰器原样当任意管理函数。
883逐项说明类型变化/额外调用,以及显式语法/维护/一致性三收益。单例保留返回实例的原类类型,只说明没有用额外代理包住它,不等于缓存构造入口完全没有函数调用;追踪代理则改变外部对象类型。是否影响性能或依赖类型判断的代码需按任务评估,不把作者“大多不显著”当测量结论,也不能只为提速移除承载必需行为的装饰。
894的02444-02446比较giveRaise(self,percent)内部if/assert和@rangetest(percent=(0.0,1.0))。统一检查可减少重复规则的维护位置;参数验证仅覆盖经过该入口的调用,不等于pay或其他属性本身已获得赋值验证。前两段是历史片段,包含Python2形式raise和省略类体,不当当前完整代码执行。
907的02473-02476逐步比较Extras继承、类后逐个赋extra、extras(Class)辅助函数、Extras(type)元类的init(Class,classname,superclasses,attributedict)。元类内按required()条件给Class.extra赋普通函数,客户声明metaclass=Extras。required与函数体均为示意,extra(self,arg)与X.extra()缺少arg也未补齐,不能当可运行演示。自动接入只对已纳入该机制的类生效,不会自动发现所有客户类。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 定义边界集中安装扩展
- · 跟踪调用
- · 装饰器与管理器函数的关系
- · 为什么使用装饰器(重访)
- · 目标
- · “辅助”函数的缺点
原书出处 · 6 处
- · 查看原书依据
最小化扩展代码的冗余,并且有助于确保正确的API使用: ·装饰器有一种非常明确的语法,这使得它们比那些可能任意地远离主体函数或类的辅助函数调用更容易为人们发现。 ·当主体函数或类定义的时候,装饰器应用一次;在对类或函数的每次调用的时候,不必添加额外的代码(在未来可能必须改变)。 ·由于前面两点,装饰器使得一个API的用户不太可能忘记根据API需求扩展一个函数
- · 查看原书依据
调用函数的每个地方需要额外的语法。此外,它的意图可能不够明显,并且它不能确保额外的层将会针对常规调用而调用。尽管装饰器不是必需的(我们总是可以手动地重新绑定名称),它们通常是最为方便的。
- · 查看原书依据
特殊语法需求从实例创建调用迁移到了类语句自身。对于本节前面的单体示例来说也是如此,我们直接将类及其构建参数传递到了一个管理器函数中,而不是装饰一个类并使用常规的实例创建调用: 作为替代方案,我们可以使用Python的内省工具来从一个已准备创建好的实例来获取类(假设创建一个初始化实例是可以接受的): 这对于我们前面所编写的跟踪器那样的函数装饰器也是成立的:我们
- · 查看原书依据
类型修改 正如我们所见到的,当插入包装器的时候,一个装饰器函数或类不会保持其最初的类型——其名称重新绑定到一个包装器对象,在使用对象名称或测试对象类型的程序中,这可能会很重要。在单体的例子中,装饰器和管理函数的方法都为实例保持了最初的类类型;在跟踪器的代码中,没有一种方法这么做,因为需要有包装器。 额外调用 通过装饰添加一个包装层,在每次调用装饰对象的时候,
- · 查看原书依据
在装饰器中隔离验证逻辑,这简化了客户类和未来的维护。 注意,我们这里的目标和前面编写的属性验证不同。这里,我们想要验证传入的函数参数的值,而不是设置的属性的值。Python的装饰器和内省工具允许我们很容易地编写这一新的任务。
- · 查看原书依据
避免代码冗余及其相关的维护成本。 为了便于说明,假设我们想要在一组类中自动插入一个方法。当然,如果在编写类的时候知道主体方法,我们可以用简单的继承来做到这点。在那种情况下,我们可以直接在超类中编写该方法,并且让所有涉及的类继承它: 然而,有时候,在编写类的时候不可能预计这样的扩展。考虑扩展类以响应在运行时用户界面中所做出的一个选择,或者在配置文件中指定类型的