多个构造函数：Pythonic 方式？ [复制]

Question

我有一个保存数据的容器类。创建容器时，有不同的方法来传递数据。

1. 传递包含数据的文件
2. 直接通过参数传递数据
3. 不传递数据；只需创建一个空容器

在 Java 中，我将创建三个构造函数。如果在 Python 中可行的话，它会是这样的：

class Container:

    def __init__(self):
        self.timestamp = 0
        self.data = []
        self.metadata = {}

    def __init__(self, file):
        f = file.open()
        self.timestamp = f.get_timestamp()
        self.data = f.get_data()
        self.metadata = f.get_metadata()

    def __init__(self, timestamp, data, metadata):
        self.timestamp = timestamp
        self.data = data
        self.metadata = metadata

在 Python 中，我看到了三个明显的解决方案，但没有一个是漂亮的：

A：使用关键字参数：

def __init__(self, **kwargs):
    if 'file' in kwargs:
        ...
    elif 'timestamp' in kwargs and 'data' in kwargs and 'metadata' in kwargs:
        ...
    else:
        ... create empty container

B：使用默认参数：

def __init__(self, file=None, timestamp=None, data=None, metadata=None):
    if file:
        ...
    elif timestamp and data and metadata:
        ...
    else:
        ... create empty container

C：只提供构造函数来创建空容器。提供用不同来源的数据填充容器的方法。

def __init__(self):
    self.timestamp = 0
    self.data = []
    self.metadata = {}

def add_data_from_file(file):
    ...

def add_data(timestamp, data, metadata):
    ...

解决方案 A 和 B 基本相同。我不喜欢执行 if/else，尤其是因为我必须检查是否提供了此方法所需的所有参数。如果要通过第四种方法扩展代码以添加数据，A 比 B 更灵活。

解决方案 C 似乎是最好的，但用户必须知道他需要哪种方法。例如：如果他不知道args 是什么，他就不能做c = Container(args)。

什么是最 Pythonic 的解决方案？

Answer 1

Python 中不能有多个同名的方法。函数重载 - 与 Java 不同 - 不受支持。

使用默认参数或**kwargs 和*args 参数。

您可以使用 @staticmethod 或 @classmethod 装饰器创建静态方法或类方法，以返回您的类的实例，或添加其他构造函数。

我建议你这样做：

class F:

    def __init__(self, timestamp=0, data=None, metadata=None):
        self.timestamp = timestamp
        self.data = list() if data is None else data
        self.metadata = dict() if metadata is None else metadata

    @classmethod
    def from_file(cls, path):
       _file = cls.get_file(path)
       timestamp = _file.get_timestamp()
       data = _file.get_data()
       metadata = _file.get_metadata()       
       return cls(timestamp, data, metadata)

    @classmethod
    def from_metadata(cls, timestamp, data, metadata):
        return cls(timestamp, data, metadata)

    @staticmethod
    def get_file(path):
        # ...
        pass

⚠ 在 python 中，从不将可变类型作为默认值。 ⚠ 见here。

Answer 2

你不能有多个构造函数，但你可以有多个恰当命名的工厂方法。

class Document(object):

    def __init__(self, whatever args you need):
        """Do not invoke directly. Use from_NNN methods."""
        # Implementation is likely a mix of A and B approaches. 

    @classmethod
    def from_string(cls, string):
        # Do any necessary preparations, use the `string`
        return cls(...)

    @classmethod
    def from_json_file(cls, file_object):
        # Read and interpret the file as you want
        return cls(...)

    @classmethod
    def from_docx_file(cls, file_object):
        # Read and interpret the file as you want, differently.
        return cls(...)

    # etc.

不过，您不能轻易阻止用户直接使用构造函数。 （如果很关键，作为开发过程中的安全预防措施，您可以分析构造函数中的调用堆栈，并检查调用是否来自预期的方法之一。）

Answer 3

大多数 Pythonic 将是 Python 标准库已经具备的功能。核心开发人员 Raymond Hettinger（collections 家伙）gave a talk on this，以及如何编写类的一般指南。

使用单独的类级函数来初始化实例，例如 dict.fromkeys() 不是类初始化器但仍返回 dict 的实例。这使您可以灵活地处理所需的参数，而无需随着需求的变化而更改方法签名。

Answer 4

此代码的系统目标是什么？从我的角度来看，您的关键短语是 but the user has to know which method he requires. 您希望您的用户对您的代码有什么体验？这应该会推动界面设计。

现在，转向可维护性：哪种解决方案最容易阅读和维护？同样，我觉得解决方案 C 较差。对于与我合作过的大多数团队来说，解决方案 B 比 A 更可取：它更易于阅读和理解，尽管两者都很容易分解成小代码块进行处理。

Answer 5

我不确定我的理解是否正确，但这行不通吗？

def __init__(self, file=None, timestamp=0, data=[], metadata={}):
    if file:
        ...
    else:
        self.timestamp = timestamp
        self.data = data
        self.metadata = metadata

或者你甚至可以这样做：

def __init__(self, file=None, timestamp=0, data=[], metadata={}):
    if file:
        # Implement get_data to return all the stuff as a tuple
        timestamp, data, metadata = f.get_data()

    self.timestamp = timestamp
    self.data = data
    self.metadata = metadata

感谢 Jon Kiparsky 的建议，有一种更好的方法可以避免在 data 和 metadata 上进行全局声明，所以这是新方法：

def __init__(self, file=None, timestamp=None, data=None, metadata=None):
    if file:
        # Implement get_data to return all the stuff as a tuple
        with open(file) as f:
            timestamp, data, metadata = f.get_data()

    self.timestamp = timestamp or 0
    self.data = data or []
    self.metadata = metadata or {}

Answer 6

如果您使用的是 Python 3.4+，则可以使用 functools.singledispatch 装饰器来执行此操作（在 methoddispatch 装饰器的一些额外帮助下，@ZeroPiraeus 为 his answer 编写）：

class Container:

    @methoddispatch
    def __init__(self):
        self.timestamp = 0
        self.data = []
        self.metadata = {}

    @__init__.register(File)
    def __init__(self, file):
        f = file.open()
        self.timestamp = f.get_timestamp()
        self.data = f.get_data()
        self.metadata = f.get_metadata()

    @__init__.register(Timestamp)
    def __init__(self, timestamp, data, metadata):
        self.timestamp = timestamp
        self.data = data
        self.metadata = metadata

Answer 7

最pythonic的方法是确保任何可选参数都有默认值。因此，包括您知道需要的所有参数并为其分配适当的默认值。

def __init__(self, timestamp=None, data=[], metadata={}):
    timestamp = time.now()

要记住的重要一点是，任何必需的参数都不应具有默认值，因为如果不包含它们，您希望引发错误。

您可以使用参数列表末尾的*args 和**kwargs 来接受更多可选参数。

def __init__(self, timestamp=None, data=[], metadata={}, *args, **kwards):
    if 'something' in kwargs:
        # do something