1. 为什么要组合使用?
在 baseloader 代码中:
@property
@abstractmethod
def supported_extensions(self) -> list[str]:
"""return list of supported file extensions."""
pass
这种写法的核心目的是:定义一个只读的、强制子类提供的数据接口。
1.1 语义区别
- 方法 (method): 表示“动作”或“计算”。调用需要括号
()。 - 属性 (property): 表示“状态”、“特征”或“配置”。调用不需要括号。
supported_extensions 本质上是 loader 的一种静态特征(它支持什么后缀),而不是一个动作(比如 load())。因此,将其定义为属性在语义上更准确。
2. 子类如何实现?
这是这种模式最强大的地方:它给了子类极大的灵活度。
父类定义了“我需要一个名为 supported_extensions 的属性”,子类可以用以下两种方式之一来满足:
方式一:使用属性 (最简单推荐)
这也是 python 相比 java 的一大优势:抽象属性可以用普通的类属性或实例属性来覆盖。
class textloader(baseloader):
# 直接定义一个列表,甚至不需要写 @property 方法
supported_extensions = ['.txt', '.md']
这种写法非常干净,看起来就像是在写配置文件。
方式二:使用 @property 方法 (动态计算)
如果你的属性值不是固定的,而是需要计算得来的,可以使用这种方式。
class dynamicloader(baseloader):
@property
def supported_extensions(self) -> list[str]:
# 假设这里有复杂的逻辑
import os
return os.environ.get("allowed_exts", ".txt").split(",")
3. 完整示例对比
from abc import abc, abstractmethod
class base(abc):
@property
@abstractmethod
def config(self):
pass
# 实现 1: 静态配置 (推荐)
class simpleimpl(base):
config = {"timeout": 30}
# 实现 2: 动态逻辑
class compleximpl(base):
@property
def config(self):
return {"timeout": self._calculate_timeout()}
def _calculate_timeout(self):
return 100
# 使用
s = simpleimpl()
print(s.config) # {'timeout': 30}
c = compleximpl()
print(c.config) # {'timeout': 100}
4. 总结
使用 @property + @abstractmethod 的好处:
- 接口语义清晰:告诉使用者这是一个数据特征。
- 实现灵活:子类可以简单地用变量赋值,也可以用复杂的 getter 方法。
- 统一调用:无论子类怎么实现,使用者都用
obj.field来访问,不需要关心背后是变量还是函数。
以上为个人经验,希望能给大家一个参考,也希望大家多多支持代码网。
发表评论