Hướng dẫn python override __setattr__ - ghi đè python __setattr__

Vì vậy, gần đây tôi đã đưa ra một sự ghê tởm của một lớp trong khi tôi đang cố gắng thực hiện một số loại

>>> s = Directory('songs')
>>> g = Directory('games')
>>> s.size                              # The songs directory has twenty files
20
>>> g.size                              # The games directory has three files
3
>>> os.remove('games/chess')            # Delete a game
>>> g.size                              # File count is automatically updated
2
7 sẽ:

  • Kích hoạt truy cập dot giá trị khóa.
  • Chấp nhận
    >>> s = Directory('songs')
    >>> g = Directory('games')
    >>> s.size                              # The songs directory has twenty files
    20
    >>> g.size                              # The games directory has three files
    3
    >>> os.remove('games/chess')            # Delete a game
    >>> g.size                              # File count is automatically updated
    2
    
    8 ________ 59/________ 60 dưới dạng đối số bổ sung chứa các giá trị mặc định.
  • Thực hiện
    import logging
    
    logging.basicConfig(level=logging.INFO)
    
    class LoggedAgeAccess:
    
        def __get__(self, obj, objtype=None):
            value = obj._age
            logging.info('Accessing %r giving %r', 'age', value)
            return value
    
        def __set__(self, obj, value):
            logging.info('Updating %r to %r', 'age', value)
            obj._age = value
    
    class Person:
    
        age = LoggedAgeAccess()             # Descriptor instance
    
        def __init__(self, name, age):
            self.name = name                # Regular instance attribute
            self.age = age                  # Calls __set__()
    
        def birthday(self):
            self.age += 1                   # Calls both __get__() and __set__()
    
    1 đã sửa đổi khi được truy cập dot, bằng cách kiểm tra xem có thể tìm thấy giá trị mặc định trong
    >>> s = Directory('songs')
    >>> g = Directory('games')
    >>> s.size                              # The songs directory has twenty files
    20
    >>> g.size                              # The games directory has three files
    3
    >>> os.remove('games/chess')            # Delete a game
    >>> g.size                              # File count is automatically updated
    2
    
    8 hay không, trả về
    import logging
    
    logging.basicConfig(level=logging.INFO)
    
    class LoggedAgeAccess:
    
        def __get__(self, obj, objtype=None):
            value = obj._age
            logging.info('Accessing %r giving %r', 'age', value)
            return value
    
        def __set__(self, obj, value):
            logging.info('Updating %r to %r', 'age', value)
            obj._age = value
    
    class Person:
    
        age = LoggedAgeAccess()             # Descriptor instance
    
        def __init__(self, name, age):
            self.name = name                # Regular instance attribute
            self.age = age                  # Calls __set__()
    
        def birthday(self):
            self.age += 1                   # Calls both __get__() and __set__()
    
    3.

Ngoài ra, lớp nên chuyển đổi đệ quy bất kỳ

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAgeAccess:

    def __get__(self, obj, objtype=None):
        value = obj._age
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        obj._age = value

class Person:

    age = LoggedAgeAccess()             # Descriptor instance

    def __init__(self, name, age):
        self.name = name                # Regular instance attribute
        self.age = age                  # Calls __set__()

    def birthday(self):
        self.age += 1                   # Calls both __get__() and __set__()
4 nào được tìm thấy trong các giá trị của nó khi khởi tạo và cho mỗi giá trị mới thành
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAgeAccess:

    def __get__(self, obj, objtype=None):
        value = obj._age
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        obj._age = value

class Person:

    age = LoggedAgeAccess()             # Descriptor instance

    def __init__(self, name, age):
        self.name = name                # Regular instance attribute
        self.age = age                  # Calls __set__()

    def birthday(self):
        self.age += 1                   # Calls both __get__() and __set__()
5.

Đây là vẻ ngoài của nó:

class DotDict(dict):

    def __init__(self, base_dict=None, defaults=None):

        self.defaults = defaults if defaults is not None else SimpleNamespace()
        base_dict = base_dict if base_dict is not None else {}
        super().__init__(**base_dict)
        for key, value in base_dict.items():
            self[key] = self._convert(value)

    def __getattr__(self, key):

        if key in self:
            return self[key]

        elif hasattr(self.defaults, key):
            return getattr(self.defaults, key)

        else:
            return None

    def __setattr__(self, key, value):

        self[key] = value

    def __delattr__(self, key):

        try:
            del self[key]

        except KeyError as error:
            raise AttributeError(error)

    def _convert(self, element):

        if isinstance(element, dict):
            return DotDict(
                {key: self._convert(value) for key, value in element.items()},
                defaults=self.defaults,
            )

        elif isinstance(element, list):
            return [self._convert(subelement) for subelement in element]

        else:
            return element

Mặc dù nó có thể đi ngược lại với tất cả các ý nghĩa thông thường và khoảng một tá thực tiễn tốt nhất, nhưng loại công việc - ngoại trừ một chi tiết: Tôi vẫn chưa tìm cách gán thuộc tính de

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAgeAccess:

    def __get__(self, obj, objtype=None):
        value = obj._age
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        obj._age = value

class Person:

    age = LoggedAgeAccess()             # Descriptor instance

    def __init__(self, name, age):
        self.name = name                # Regular instance attribute
        self.age = age                  # Calls __set__()

    def birthday(self):
        self.age += 1                   # Calls both __get__() and __set__()
6 mà không cần thêm nó vào các trường hợp '
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAgeAccess:

    def __get__(self, obj, objtype=None):
        value = obj._age
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        obj._age = value

class Person:

    age = LoggedAgeAccess()             # Descriptor instance

    def __init__(self, name, age):
        self.name = name                # Regular instance attribute
        self.age = age                  # Calls __set__()

    def birthday(self):
        self.age += 1                   # Calls both __get__() and __set__()
7. Điều này có ý nghĩa, vì phương thức
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAgeAccess:

    def __get__(self, obj, objtype=None):
        value = obj._age
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        obj._age = value

class Person:

    age = LoggedAgeAccess()             # Descriptor instance

    def __init__(self, name, age):
        self.name = name                # Regular instance attribute
        self.age = age                  # Calls __set__()

    def birthday(self):
        self.age += 1                   # Calls both __get__() and __set__()
8 ngay lập tức bị ghi đè bởi phiên bản truy cập dấu chấm của nó.

Chỉnh sửa cho sự rõ ràng

Đoạn văn trên đã được đặt ra rất khủng khiếp đến thực tế, đặt câu hỏi sai. Tôi biết rằng có một vài cách để gán các thuộc tính mà không cần dùng đến

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAgeAccess:

    def __get__(self, obj, objtype=None):
        value = obj._age
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        obj._age = value

class Person:

    age = LoggedAgeAccess()             # Descriptor instance

    def __init__(self, name, age):
        self.name = name                # Regular instance attribute
        self.age = age                  # Calls __set__()

    def birthday(self):
        self.age += 1                   # Calls both __get__() and __set__()
8 của Classe, như được chỉ ra bởi
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
0, điều này thực sự sẽ giải quyết vấn đề cụ thể này.

Mã được mô tả ở trên có nghĩa là một minh họa cho quá trình khiến tôi tự hỏi mình câu hỏi thực sự của bài đăng này. Đọc toàn bộ điều với đôi mắt mới bây giờ khiến tôi nhận ra rằng hầu hết các chi tiết của câu hỏi ban đầu đều không cần thiết và có khả năng khó hiểu. Tôi sẽ để nó để minh bạch, nhưng nếu tôi viết lại câu hỏi từ đầu, thì đó chỉ đơn giản là:

Có cách nào để ghi đè bất kỳ phương thức lớp nào sau khi thể hiện đã được khởi tạo không?

Tác giả

Raymond Hettinger

Tiếp xúc

Mô tả cho phép các đối tượng tùy chỉnh Tra cứu, lưu trữ và xóa thuộc tính. let objects customize attribute lookup, storage, and deletion.

Hướng dẫn này có bốn phần chính:

  1. Các Primer Primer cung cấp một cái nhìn tổng quan cơ bản, di chuyển nhẹ nhàng từ các ví dụ đơn giản, thêm một tính năng tại một thời điểm. Bắt đầu ở đây nếu bạn mới mô tả.

  2. Phần thứ hai cho thấy một ví dụ mô tả hoàn chỉnh, thực tế. Nếu bạn đã biết những điều cơ bản, hãy bắt đầu từ đó.

  3. Phần thứ ba cung cấp một hướng dẫn kỹ thuật hơn đi vào cơ chế chi tiết về cách các mô tả hoạt động. Hầu hết mọi người không cần mức độ chi tiết này.

  4. Phần cuối cùng có các tương đương Python thuần túy cho các mô tả tích hợp được viết bằng C. Đọc điều này nếu bạn tò mò về cách các chức năng biến thành các phương thức ràng buộc hoặc về việc thực hiện các công cụ phổ biến như

    >>> mary = Person('Mary M', 30)         # The initial age update is logged
    INFO:root:Updating 'age' to 30
    >>> dave = Person('David D', 40)
    INFO:root:Updating 'age' to 40
    
    >>> vars(mary)                          # The actual data is in a private attribute
    {'name': 'Mary M', '_age': 30}
    >>> vars(dave)
    {'name': 'David D', '_age': 40}
    
    >>> mary.age                            # Access the data and log the lookup
    INFO:root:Accessing 'age' giving 30
    30
    >>> mary.birthday()                     # Updates are logged as well
    INFO:root:Accessing 'age' giving 30
    INFO:root:Updating 'age' to 31
    
    >>> dave.name                           # Regular attribute lookup isn't logged
    'David D'
    >>> dave.age                            # Only the managed attribute is logged
    INFO:root:Accessing 'age' giving 40
    40
    
    1,
    >>> mary = Person('Mary M', 30)         # The initial age update is logged
    INFO:root:Updating 'age' to 30
    >>> dave = Person('David D', 40)
    INFO:root:Updating 'age' to 40
    
    >>> vars(mary)                          # The actual data is in a private attribute
    {'name': 'Mary M', '_age': 30}
    >>> vars(dave)
    {'name': 'David D', '_age': 40}
    
    >>> mary.age                            # Access the data and log the lookup
    INFO:root:Accessing 'age' giving 30
    30
    >>> mary.birthday()                     # Updates are logged as well
    INFO:root:Accessing 'age' giving 30
    INFO:root:Updating 'age' to 31
    
    >>> dave.name                           # Regular attribute lookup isn't logged
    'David D'
    >>> dave.age                            # Only the managed attribute is logged
    INFO:root:Accessing 'age' giving 40
    40
    
    2,
    >>> mary = Person('Mary M', 30)         # The initial age update is logged
    INFO:root:Updating 'age' to 30
    >>> dave = Person('David D', 40)
    INFO:root:Updating 'age' to 40
    
    >>> vars(mary)                          # The actual data is in a private attribute
    {'name': 'Mary M', '_age': 30}
    >>> vars(dave)
    {'name': 'David D', '_age': 40}
    
    >>> mary.age                            # Access the data and log the lookup
    INFO:root:Accessing 'age' giving 30
    30
    >>> mary.birthday()                     # Updates are logged as well
    INFO:root:Accessing 'age' giving 30
    INFO:root:Updating 'age' to 31
    
    >>> dave.name                           # Regular attribute lookup isn't logged
    'David D'
    >>> dave.age                            # Only the managed attribute is logged
    INFO:root:Accessing 'age' giving 40
    40
    
    3 và __slots__.__slots__.

Lót¶

Trong phần mồi này, chúng tôi bắt đầu với ví dụ cơ bản nhất có thể và sau đó chúng tôi sẽ thêm các khả năng mới từng.

Ví dụ đơn giản: một mô tả trả về một hằng số

Lớp

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
4 là một bộ mô tả có phương thức
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 luôn trả về hằng số
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
6:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10

Để sử dụng bộ mô tả, nó phải được lưu trữ dưới dạng biến lớp trong một lớp khác:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance

Một phiên tương tác cho thấy sự khác biệt giữa tra cứu thuộc tính thông thường và tra cứu mô tả:

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10

Trong Tra cứu thuộc tính

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
7, toán tử DOT tìm thấy
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
8 trong từ điển lớp. Trong tra cứu
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
9, toán tử DOT tìm thấy một thể hiện mô tả, được nhận ra bằng phương pháp
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
0 của nó. Gọi phương thức đó trả về
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
6.

Lưu ý rằng giá trị

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
6 không được lưu trữ trong từ điển lớp hoặc từ điển thể hiện. Thay vào đó, giá trị
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
6 được tính theo yêu cầu.

Ví dụ này cho thấy cách thức hoạt động của một mô tả đơn giản, nhưng nó rất hữu ích. Để truy xuất các hằng số, tra cứu thuộc tính bình thường sẽ tốt hơn.

Trong phần tiếp theo, chúng tôi sẽ tạo ra một cái gì đó hữu ích hơn, một tra cứu năng động.

Tra cứu động

Các mô tả thú vị thường chạy tính toán thay vì trả về hằng số:

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute

Một phiên tương tác cho thấy rằng tra cứu là động - nó tính toán các câu trả lời được cập nhật khác nhau mỗi lần:

>>> s = Directory('songs')
>>> g = Directory('games')
>>> s.size                              # The songs directory has twenty files
20
>>> g.size                              # The games directory has three files
3
>>> os.remove('games/chess')            # Delete a game
>>> g.size                              # File count is automatically updated
2

Bên cạnh việc hiển thị cách các mô tả có thể chạy tính toán, ví dụ này cũng cho thấy mục đích của các tham số thành

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5. Tham số tự là kích thước, một thể hiện của thư mục. Tham số OBJ là G hoặc S, một ví dụ của thư mục. Đó là tham số OBJ cho phép phương thức
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 tìm hiểu thư mục đích. Tham số objtype là thư mục lớp.

Thuộc tính được quản lý

Một cách sử dụng phổ biến cho các mô tả là quản lý quyền truy cập vào dữ liệu thể hiện. Bộ mô tả được gán cho một thuộc tính công khai trong từ điển lớp trong khi dữ liệu thực tế được lưu trữ dưới dạng thuộc tính riêng tư trong từ điển thể hiện. Các phương thức mô tả

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 và
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
7 được kích hoạt khi thuộc tính công khai được truy cập.

Trong ví dụ sau, tuổi là thuộc tính công khai và _age là thuộc tính riêng tư. Khi thuộc tính công khai được truy cập, mô tả ghi lại tra cứu hoặc cập nhật:

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAgeAccess:

    def __get__(self, obj, objtype=None):
        value = obj._age
        logging.info('Accessing %r giving %r', 'age', value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', 'age', value)
        obj._age = value

class Person:

    age = LoggedAgeAccess()             # Descriptor instance

    def __init__(self, name, age):
        self.name = name                # Regular instance attribute
        self.age = age                  # Calls __set__()

    def birthday(self):
        self.age += 1                   # Calls both __get__() and __set__()

Một phiên tương tác cho thấy rằng tất cả các quyền truy cập vào tuổi thuộc tính được quản lý được ghi lại, nhưng tên thuộc tính thông thường không được ghi lại:

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40

Một vấn đề lớn với ví dụ này là tên riêng _age được làm cứng trong lớp LogGedageAccess. Điều đó có nghĩa là mỗi trường hợp chỉ có thể có một thuộc tính đã ghi và tên của nó là không thể thay đổi. Trong ví dụ tiếp theo, chúng tôi sẽ khắc phục vấn đề đó.

Tên tùy chỉnh

Khi một lớp sử dụng các mô tả, nó có thể thông báo cho từng mô tả về tên biến được sử dụng.

Trong ví dụ này, lớp

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
8 có hai trường hợp mô tả, tên và tuổi. Khi lớp
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
8 được xác định, nó sẽ gọi lại cho
>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
0 trong loggedAccess để có thể ghi lại tên trường, cung cấp cho mỗi bộ mô tả của riêng mình_name và private_name:

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1

Một phiên tương tác cho thấy lớp

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
8 đã gọi
>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
0 để các tên trường sẽ được ghi lại. Ở đây chúng tôi gọi
>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
3 để tra cứu bộ mô tả mà không kích hoạt nó:

>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}

Lớp mới hiện ghi nhật ký truy cập vào cả tên và tuổi:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
0

Các trường hợp hai người chỉ chứa tên riêng tư:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
1

Bớt tư tưởng¶

Một mô tả là những gì chúng ta gọi là bất kỳ đối tượng nào xác định

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5,
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
7 hoặc
>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
6.descriptor is what we call any object that defines
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5,
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
7, or
>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
6.

Tùy chọn, mô tả có thể có phương thức

>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
0. Điều này chỉ được sử dụng trong trường hợp một mô tả cần biết lớp nơi nó được tạo hoặc tên của biến lớp mà nó được gán cho. (Phương pháp này, nếu có, được gọi ngay cả khi lớp không phải là mô tả.)

Mô tả được gọi bởi toán tử DOT trong quá trình tra cứu thuộc tính. Nếu một mô tả được truy cập gián tiếp với

>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
8, phiên bản mô tả được trả về mà không cần gọi nó.

Mô tả chỉ hoạt động khi được sử dụng làm biến lớp. Khi đặt trong các trường hợp, chúng không có tác dụng.

Động lực chính cho các mô tả là cung cấp một móc cho phép các đối tượng được lưu trữ trong các biến lớp để kiểm soát những gì xảy ra trong quá trình tra cứu thuộc tính.

Theo truyền thống, lớp gọi kiểm soát những gì xảy ra trong quá trình tra cứu. Các mô tả đảo ngược mối quan hệ đó và cho phép dữ liệu được tra cứu có tiếng nói trong vấn đề này.

Mô tả được sử dụng trong suốt ngôn ngữ. Đó là cách các chức năng biến thành các phương thức bị ràng buộc. Các công cụ phổ biến như

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
1,
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
2,
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
3 và
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
02 đều được triển khai dưới dạng mô tả.

Hoàn thành ví dụ thực tế

Trong ví dụ này, chúng tôi tạo ra một công cụ thực tế và mạnh mẽ để định vị rất khó để tìm các lỗi tham nhũng dữ liệu.

Lớp xác thực

Trình xác nhận là một mô tả cho quyền truy cập thuộc tính được quản lý. Trước khi lưu trữ bất kỳ dữ liệu nào, nó xác minh rằng giá trị mới đáp ứng các hạn chế loại và phạm vi khác nhau. Nếu những hạn chế đó được đáp ứng, nó sẽ đặt ra một ngoại lệ để ngăn chặn sự tham nhũng dữ liệu tại nguồn của nó.

Lớp

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
03 này vừa là một lớp cơ sở trừu tượng vừa là bộ mô tả thuộc tính được quản lý:abstract base class and a managed attribute descriptor:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
2

Người xác nhận tùy chỉnh cần được kế thừa từ

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
03 và phải cung cấp phương pháp
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
05 để kiểm tra các hạn chế khác nhau khi cần thiết.

Người xác nhận tùy chỉnh Or

Dưới đây là ba tiện ích xác nhận dữ liệu thực tế:

  1. class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    06 xác minh rằng giá trị là một trong những tùy chọn bị hạn chế.

  2. class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    07 xác minh rằng giá trị là
    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    08 hoặc
    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    09. Tùy chọn, nó xác minh rằng một giá trị nằm giữa tối thiểu hoặc tối đa nhất định.

  3. class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    10 xác minh rằng một giá trị là
    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    11. Tùy chọn, nó xác nhận một chiều dài tối thiểu hoặc tối đa nhất định. Nó cũng có thể xác thực một vị ngữ do người dùng xác định là tốt.

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
3

Ứng dụng thực tế

Ở đây, cách thức sử dụng trình xác thực dữ liệu trong một lớp thực:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
4

Các mô tả ngăn chặn các trường hợp không hợp lệ được tạo:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
5

Hướng dẫn kỹ thuật

Những gì sau đây là một hướng dẫn kỹ thuật hơn cho các cơ chế và chi tiết về cách các mô tả hoạt động.

Trừu tượng¶

Xác định các mô tả, tóm tắt giao thức và cho thấy cách các mô tả được gọi. Cung cấp một ví dụ cho thấy cách ánh xạ quan hệ đối tượng hoạt động.

Tìm hiểu về các mô tả không chỉ cung cấp quyền truy cập vào bộ công cụ lớn hơn, nó tạo ra sự hiểu biết sâu sắc hơn về cách thức hoạt động của Python.

Định nghĩa và giới thiệu

Nói chung, một mô tả là một giá trị thuộc tính có một trong các phương thức trong giao thức mô tả. Những phương pháp đó là

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5,
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
7 và
>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
6. Nếu bất kỳ phương pháp nào được xác định cho một thuộc tính, nó được cho là một mô tả.descriptor.

Hành vi mặc định cho quyền truy cập thuộc tính là để có được, đặt hoặc xóa thuộc tính khỏi từ điển đối tượng. Chẳng hạn,

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
7 có chuỗi tra cứu bắt đầu với
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
16, sau đó
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
17 và tiếp tục thông qua thứ tự độ phân giải phương pháp của
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
18. Nếu giá trị tra cứu là một đối tượng xác định một trong các phương thức mô tả, thì Python có thể ghi đè hành vi mặc định và gọi phương thức mô tả thay thế. Trường hợp điều này xảy ra trong chuỗi ưu tiên phụ thuộc vào phương thức mô tả nào được xác định.

Mô tả là một giao thức mục đích mạnh mẽ, mạnh mẽ. Chúng là cơ chế đằng sau các thuộc tính, phương pháp, phương pháp tĩnh, phương pháp lớp và

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
19. Chúng được sử dụng trong suốt Python. Các mô tả đơn giản hóa mã C cơ bản và cung cấp một bộ công cụ mới linh hoạt cho các chương trình Python hàng ngày.

Giao thức mô tả

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
20

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
21

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
22

Đó là tất cả để có nó. Xác định bất kỳ phương thức nào trong số này và một đối tượng được coi là một mô tả và có thể ghi đè hành vi mặc định khi được tra cứu như một thuộc tính.

Nếu một đối tượng xác định

import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
7 hoặc
>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
6, thì nó được coi là mô tả dữ liệu. Các mô tả chỉ xác định
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 được gọi là mô tả không dữ liệu (chúng thường được sử dụng cho các phương pháp nhưng có thể sử dụng khác).

Các mô tả dữ liệu và không dữ liệu khác nhau về cách tính toán được tính toán liên quan đến các mục trong từ điển phiên bản. Nếu một từ điển phiên bản có một mục có cùng tên với bộ mô tả dữ liệu, bộ mô tả dữ liệu sẽ được ưu tiên. Nếu một từ điển phiên bản có một mục có cùng tên với bộ mô tả không phải là dữ liệu, thì mục từ điển sẽ được ưu tiên.

Để thực hiện mô tả dữ liệu chỉ đọc, hãy xác định cả

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 và
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
7 với
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
7 tăng
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
29 khi được gọi. Xác định phương pháp
import logging

logging.basicConfig(level=logging.INFO)

class LoggedAccess:

    def __set_name__(self, owner, name):
        self.public_name = name
        self.private_name = '_' + name

    def __get__(self, obj, objtype=None):
        value = getattr(obj, self.private_name)
        logging.info('Accessing %r giving %r', self.public_name, value)
        return value

    def __set__(self, obj, value):
        logging.info('Updating %r to %r', self.public_name, value)
        setattr(obj, self.private_name, value)

class Person:

    name = LoggedAccess()                # First descriptor instance
    age = LoggedAccess()                 # Second descriptor instance

    def __init__(self, name, age):
        self.name = name                 # Calls the first descriptor
        self.age = age                   # Calls the second descriptor

    def birthday(self):
        self.age += 1
7 với một trình giữ chỗ tăng ngoại lệ là đủ để biến nó thành một mô tả dữ liệu.

Tổng quan về lời mời mô tả

Một mô tả có thể được gọi trực tiếp với

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
31 hoặc
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
32.

Nhưng thông thường hơn cho một mô tả được gọi tự động từ quyền truy cập thuộc tính.

Biểu thức

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
33 tra cứu thuộc tính
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
34 trong chuỗi không gian tên cho
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
35. Nếu tìm kiếm tìm thấy một mô tả bên ngoài trường hợp
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
36, phương thức
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 của nó được gọi theo các quy tắc ưu tiên được liệt kê dưới đây.

Các chi tiết của lời mời phụ thuộc vào việc

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
35 có phải là đối tượng, lớp hoặc thể hiện của Super.

Bắt đầu từ một trường hợp

Tra cứu phiên bản quét thông qua một chuỗi các không gian tên mang lại cho các mô tả dữ liệu ưu tiên cao nhất, theo sau là các biến thể hiện, sau đó là các mô tả không gây dữ liệu, sau đó là các biến lớp và cuối cùng là

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
39 nếu nó được cung cấp.

Nếu một mô tả được tìm thấy cho

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
7, thì nó được gọi bằng:
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
41.

Logic cho một tra cứu chấm là trong

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
42. Đây là một python thuần túy tương đương:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
6

Lưu ý, không có hook

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
39 trong mã
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
44. Đó là lý do tại sao gọi
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
44 trực tiếp hoặc với
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
46 sẽ bỏ qua hoàn toàn
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
39.

Thay vào đó, chính toán tử DOT và hàm

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
48 chịu trách nhiệm gọi
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
39 bất cứ khi nào
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
44 tăng
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
29. Logic của họ được gói gọn trong hàm trợ giúp:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
7

Bắt đầu từ một lớp học

Logic cho một tra cứu chấm, chẳng hạn như

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
52 là trong
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
53. Các bước tương tự như các bước cho
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
42 nhưng Tra cứu từ điển thể hiện được thay thế bằng tìm kiếm thông qua thứ tự phân giải phương thức lớp.method resolution order.

Nếu một mô tả được tìm thấy, nó được gọi bằng

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
55.

Việc triển khai C đầy đủ có thể được tìm thấy trong

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
56 và
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
57 trong các đối tượng/typeObject.c.

Bắt đầu từ Super¶

Logic cho tra cứu chấm siêu tốc có trong phương thức

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
44 cho đối tượng được trả về bởi
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
19.

Tra cứu chấm chấm, chẳng hạn như

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
60 tìm kiếm
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
61 cho lớp cơ sở
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
62 ngay sau
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
63 và sau đó trả về
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
64. Nếu không phải là một mô tả,
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
65 được trả về không thay đổi.

Việc triển khai C đầy đủ có thể được tìm thấy trong

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
66 trong các đối tượng/typeObject.c. Một tương đương Python thuần túy có thể được tìm thấy trong hướng dẫn của Guido.

Tóm tắt Logic Lệnh gọi

Cơ chế cho các mô tả được nhúng trong các phương pháp

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
44 cho
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
68,
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
69 và
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
19.

Những điểm quan trọng cần nhớ là:

  • Các mô tả được gọi bằng phương pháp

    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    44.

  • Các lớp kế thừa máy móc này từ

    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    68,
    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    69 hoặc
    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    19.

  • Ghi đè

    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    44 ngăn chặn các cuộc gọi mô tả tự động vì tất cả logic mô tả đều nằm trong phương thức đó.

  • class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    42 và
    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    53 thực hiện các cuộc gọi khác nhau đến
    >>> mary = Person('Mary M', 30)         # The initial age update is logged
    INFO:root:Updating 'age' to 30
    >>> dave = Person('David D', 40)
    INFO:root:Updating 'age' to 40
    
    >>> vars(mary)                          # The actual data is in a private attribute
    {'name': 'Mary M', '_age': 30}
    >>> vars(dave)
    {'name': 'David D', '_age': 40}
    
    >>> mary.age                            # Access the data and log the lookup
    INFO:root:Accessing 'age' giving 30
    30
    >>> mary.birthday()                     # Updates are logged as well
    INFO:root:Accessing 'age' giving 30
    INFO:root:Updating 'age' to 31
    
    >>> dave.name                           # Regular attribute lookup isn't logged
    'David D'
    >>> dave.age                            # Only the managed attribute is logged
    INFO:root:Accessing 'age' giving 40
    40
    
    5. Đầu tiên bao gồm ví dụ và có thể bao gồm lớp. Cái thứ hai đặt trong
    class Ten:
        def __get__(self, obj, objtype=None):
            return 10
    
    79 cho ví dụ và luôn bao gồm lớp.

  • Mô tả dữ liệu luôn ghi đè từ điển thể hiện.

  • Các mô tả phi dữ liệu có thể bị ghi đè bởi từ điển ví dụ.

Thông báo tên tự động

Đôi khi, một mô tả là mong muốn để biết tên biến lớp mà nó được gán cho. Khi một lớp mới được tạo ra, Metaclass

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
69 sẽ quét từ điển của lớp mới. Nếu bất kỳ mục nào là mô tả và nếu chúng xác định
>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
0, phương thức đó được gọi với hai đối số. Chủ sở hữu là lớp nơi sử dụng mô tả và tên là biến lớp mà bộ mô tả được gán cho.

Các chi tiết triển khai nằm trong

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
82 và
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
83 trong các đối tượng/typeObject.C.

Vì logic cập nhật là trong

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
84, các thông báo chỉ diễn ra tại thời điểm tạo lớp. Nếu các mô tả được thêm vào lớp sau đó,
>>> vars(vars(Person)['name'])
{'public_name': 'name', 'private_name': '_name'}
>>> vars(vars(Person)['age'])
{'public_name': 'age', 'private_name': '_age'}
0 sẽ cần được gọi bằng tay.

Ví dụ Orm

Mã sau đây là một bộ xương đơn giản hóa cho thấy cách mô tả dữ liệu có thể được sử dụng để thực hiện ánh xạ quan hệ đối tượng.

Ý tưởng thiết yếu là dữ liệu được lưu trữ trong cơ sở dữ liệu bên ngoài. Các phiên bản Python chỉ giữ các khóa cho các bảng cơ sở dữ liệu. Người mô tả chăm sóc các bộ tra cứu hoặc cập nhật:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
8

Chúng ta có thể sử dụng lớp

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
86 để xác định các mô hình mô tả lược đồ cho mỗi bảng trong cơ sở dữ liệu:

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
9

Để sử dụng các mô hình, trước tiên hãy kết nối với cơ sở dữ liệu:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
0

Một phiên tương tác cho thấy cách lấy dữ liệu từ cơ sở dữ liệu và cách cập nhật nó:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
1

Tương đương Python thuần túy

Giao thức mô tả rất đơn giản và cung cấp các khả năng thú vị. Một số trường hợp sử dụng là phổ biến đến mức chúng đã được đóng gói sẵn thành các công cụ tích hợp. Các thuộc tính, phương thức ràng buộc, phương thức tĩnh, phương thức lớp và __Slots__ đều dựa trên giao thức mô tả.

Đặc tính¶

Gọi

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
3 là một cách ngắn gọn để xây dựng bộ mô tả dữ liệu kích hoạt lệnh gọi hàm khi truy cập vào một thuộc tính. Chữ ký của nó là:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
2

Tài liệu cho thấy một cách sử dụng điển hình để xác định thuộc tính được quản lý

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
34:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
3

Để xem cách

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
3 được thực hiện theo giao thức mô tả, đây là một tương đương Python thuần túy: tương đương:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
4

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
3 Buildin giúp bất cứ khi nào giao diện người dùng đã cấp quyền truy cập thuộc tính và sau đó các thay đổi tiếp theo yêu cầu sự can thiệp của phương thức.

Chẳng hạn, một lớp bảng tính có thể cấp quyền truy cập vào giá trị ô thông qua

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
91. Những cải tiến tiếp theo cho chương trình yêu cầu tế bào phải được tính toán lại trên mọi truy cập; Tuy nhiên, lập trình viên không muốn ảnh hưởng trực tiếp đến mã khách hàng hiện tại truy cập thuộc tính. Giải pháp là kết thúc quyền truy cập vào thuộc tính giá trị trong bộ mô tả dữ liệu thuộc tính:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
5

Tương đương

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
3 hoặc tương đương
class Ten:
    def __get__(self, obj, objtype=None):
        return 10
93 của chúng tôi sẽ hoạt động trong ví dụ này.

Chức năng và Phương pháp

Các tính năng định hướng đối tượng Python sườn được xây dựng trên một môi trường dựa trên chức năng. Sử dụng các mô tả không dữ liệu, cả hai được hợp nhất liền mạch.

Các chức năng được lưu trữ trong từ điển lớp được chuyển thành các phương thức khi được gọi. Các phương thức chỉ khác với các chức năng thông thường ở chỗ đối tượng được chuẩn bị cho các đối số khác. Theo quy ước, trường hợp được gọi là bản thân nhưng có thể được gọi là tên này hoặc bất kỳ tên biến nào khác.

Các phương thức có thể được tạo thủ công với

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
94 tương đương với:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
6

Để hỗ trợ tạo tự động các phương thức, các chức năng bao gồm phương thức

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 cho các phương thức liên kết trong quá trình truy cập thuộc tính. Điều này có nghĩa là các chức năng là các mô tả không phải là dữ liệu trả về các phương thức bị ràng buộc trong quá trình tra cứu chấm từ một trường hợp. Ở đây, cách thức hoạt động của nó:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
7

Chạy lớp sau trong trình thông dịch cho thấy cách thức mô tả chức năng hoạt động trong thực tế:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
8

Hàm có thuộc tính tên đủ điều kiện để hỗ trợ hướng nội:qualified name attribute to support introspection:

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
9

Truy cập chức năng thông qua từ điển lớp không gọi

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5. Thay vào đó, nó chỉ trả về đối tượng chức năng cơ bản:

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
0

Truy cập chấm từ một lớp gọi

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 chỉ trả về chức năng cơ bản không thay đổi:

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
1

Các hành vi thú vị xảy ra trong quá trình truy cập chấm từ một trường hợp. Tra cứu chấm chấm các cuộc gọi

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 trả về một đối tượng phương thức ràng buộc:

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
2

Trong nội bộ, phương thức ràng buộc lưu trữ chức năng cơ bản và thể hiện ràng buộc:

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
3

Nếu bạn đã từng tự hỏi bản thân đến từ đâu trong các phương pháp thông thường hoặc CLS đến từ các phương pháp trong lớp, thì đây là nó!

Các loại phương pháp

Các mô tả phi dữ liệu cung cấp một cơ chế đơn giản cho các biến thể trên các mẫu chức năng liên kết thông thường thành các phương thức.

Để tóm tắt lại, các hàm có phương thức

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
5 để chúng có thể được chuyển đổi thành phương thức khi được truy cập dưới dạng thuộc tính. Bộ mô tả không dữ liệu biến đổi cuộc gọi
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
00 thành
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
01. Gọi
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
02 trở thành
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
03.

Biểu đồ này tóm tắt ràng buộc và hai biến thể hữu ích nhất của nó:

Biến đổi

Được gọi từ một đối tượng

Được gọi từ một lớp học

function

f (obj, *args)

f(*args)

tĩnh

f(*args)

f(*args)

Lớp học

F (loại (obj), *args)

f (cls, *args)

Phương pháp tĩnh

Các phương thức tĩnh trả về chức năng cơ bản mà không thay đổi. Gọi

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
04 hoặc
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
05 tương đương với việc tra cứu trực tiếp vào
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
06 hoặc
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
07. Kết quả là, hàm trở nên có thể truy cập giống hệt nhau từ một đối tượng hoặc một lớp.

Các ứng cử viên tốt cho các phương pháp tĩnh là các phương pháp không tham chiếu biến

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
08.

Chẳng hạn, gói thống kê có thể bao gồm một lớp container cho dữ liệu thử nghiệm. Lớp cung cấp các phương pháp bình thường để tính toán trung bình, trung bình, trung bình và các số liệu thống kê mô tả khác phụ thuộc vào dữ liệu. Tuy nhiên, có thể có các chức năng hữu ích có liên quan về mặt khái niệm nhưng không phụ thuộc vào dữ liệu. Ví dụ,

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
09 là thói quen chuyển đổi tiện dụng xuất hiện trong công việc thống kê nhưng không phụ thuộc trực tiếp vào một bộ dữ liệu cụ thể. Nó có thể được gọi từ một đối tượng hoặc lớp:
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
10 hoặc
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
11.

Vì các phương thức tĩnh trả về chức năng cơ bản mà không có thay đổi, các cuộc gọi ví dụ không thể chịu đựng được:

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
4

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
5

Sử dụng giao thức mô tả không dữ liệu, phiên bản Python thuần túy của

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
2 sẽ trông như thế này:

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
6

Phương pháp lớp

Không giống như các phương thức tĩnh, các phương thức lớp dành cho tham chiếu lớp vào danh sách đối số trước khi gọi hàm. Định dạng này giống nhau cho dù người gọi là đối tượng hay một lớp:

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
7

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
8

Hành vi này rất hữu ích bất cứ khi nào phương thức chỉ cần có tham chiếu lớp và không dựa vào dữ liệu được lưu trữ trong một trường hợp cụ thể. Một cách sử dụng cho các phương thức lớp là tạo các hàm tạo lớp thay thế. Ví dụ: ClassMethod

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
13 tạo ra một từ điển mới từ danh sách các khóa. Tương đương Python thuần túy là:

>>> a = A()                     # Make an instance of class A
>>> a.x                         # Normal attribute lookup
5
>>> a.y                         # Descriptor lookup
10
9

Bây giờ, một từ điển mới của các khóa độc đáo có thể được xây dựng như thế này:

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
0

Sử dụng giao thức mô tả không dữ liệu, phiên bản Python thuần túy của

>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
1 sẽ trông như thế này:

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
1

Đường dẫn mã cho

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
15 đã được thêm vào Python 3.9 và giúp
>>> mary = Person('Mary M', 30)         # The initial age update is logged
INFO:root:Updating 'age' to 30
>>> dave = Person('David D', 40)
INFO:root:Updating 'age' to 40

>>> vars(mary)                          # The actual data is in a private attribute
{'name': 'Mary M', '_age': 30}
>>> vars(dave)
{'name': 'David D', '_age': 40}

>>> mary.age                            # Access the data and log the lookup
INFO:root:Accessing 'age' giving 30
30
>>> mary.birthday()                     # Updates are logged as well
INFO:root:Accessing 'age' giving 30
INFO:root:Updating 'age' to 31

>>> dave.name                           # Regular attribute lookup isn't logged
'David D'
>>> dave.age                            # Only the managed attribute is logged
INFO:root:Accessing 'age' giving 40
40
1 có thể hỗ trợ các nhà trang trí xích. Ví dụ, một lớp học và thuộc tính có thể được xích lại với nhau:

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
2

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
3

Đối tượng thành viên và __Slots__¶

Khi một lớp xác định

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
17, nó thay thế từ điển thể hiện bằng một mảng giá trị khe có độ dài cố định. Từ quan điểm của người dùng có một số hiệu ứng:

1. Cung cấp phát hiện ngay các lỗi do các bài tập thuộc tính sai chính tả. Chỉ cho phép các tên thuộc tính được chỉ định trong

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
17:

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
4

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
5

2. Giúp tạo các đối tượng bất biến trong đó các mô tả quản lý quyền truy cập vào các thuộc tính riêng được lưu trữ trong

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
17:

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
6

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
7

3. Lưu bộ nhớ. Trên bản dựng Linux 64 bit, một thể hiện với hai thuộc tính có 48 byte với

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
17 và 152 byte mà không có. Mô hình thiết kế hạng nặng này có thể chỉ quan trọng khi một số lượng lớn các trường hợp sẽ được tạo ra.

4. Cải thiện tốc độ. Đọc các biến thể hiện nhanh hơn 35% với

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
17 (được đo bằng Python 3.10 trên bộ xử lý Apple M1).

5. Khối các công cụ như

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
02 yêu cầu từ điển thể hiện để hoạt động chính xác:

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
8

import os

class DirectorySize:

    def __get__(self, obj, objtype=None):
        return len(os.listdir(obj.dirname))

class Directory:

    size = DirectorySize()              # Descriptor instance

    def __init__(self, dirname):
        self.dirname = dirname          # Regular instance attribute
9

Không thể tạo phiên bản Python thuần túy chính xác của

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
17 vì nó yêu cầu truy cập trực tiếp vào các cấu trúc C và kiểm soát phân bổ bộ nhớ đối tượng. Tuy nhiên, chúng ta có thể xây dựng một mô phỏng chủ yếu là trung thành trong đó cấu trúc C thực tế cho các vị trí được mô phỏng bởi một danh sách riêng tư. Đọc và ghi vào cấu trúc riêng được quản lý bởi các mô tả thành viên:

>>> s = Directory('songs')
>>> g = Directory('games')
>>> s.size                              # The songs directory has twenty files
20
>>> g.size                              # The games directory has three files
3
>>> os.remove('games/chess')            # Delete a game
>>> g.size                              # File count is automatically updated
2
0

Phương thức

class Ten:
    def __get__(self, obj, objtype=None):
        return 10
84 chăm sóc việc thêm các đối tượng thành viên vào các biến lớp:

>>> s = Directory('songs')
>>> g = Directory('games')
>>> s.size                              # The songs directory has twenty files
20
>>> g.size                              # The games directory has three files
3
>>> os.remove('games/chess')            # Delete a game
>>> g.size                              # File count is automatically updated
2
1

Phương pháp

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
26 chăm sóc việc tạo các trường hợp có vị trí thay vì từ điển thể hiện. Dưới đây là một mô phỏng thô trong Python thuần túy:

>>> s = Directory('songs')
>>> g = Directory('games')
>>> s.size                              # The songs directory has twenty files
20
>>> g.size                              # The games directory has three files
3
>>> os.remove('games/chess')            # Delete a game
>>> g.size                              # File count is automatically updated
2
2

Để sử dụng mô phỏng trong một lớp thực, chỉ cần kế thừa từ

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
27 và đặt metaclass thành
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
28:metaclass to
class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
28:

>>> s = Directory('songs')
>>> g = Directory('games')
>>> s.size                              # The songs directory has twenty files
20
>>> g.size                              # The games directory has three files
3
>>> os.remove('games/chess')            # Delete a game
>>> g.size                              # File count is automatically updated
2
3

Tại thời điểm này, Metaclass đã tải các đối tượng thành viên cho X và Y:

>>> s = Directory('songs')
>>> g = Directory('games')
>>> s.size                              # The songs directory has twenty files
20
>>> g.size                              # The games directory has three files
3
>>> os.remove('games/chess')            # Delete a game
>>> g.size                              # File count is automatically updated
2
4

Khi các phiên bản được tạo, chúng có danh sách

class A:
    x = 5                       # Regular class attribute
    y = Ten()                   # Descriptor instance
29 nơi các thuộc tính được lưu trữ:

>>> s = Directory('songs')
>>> g = Directory('games')
>>> s.size                              # The songs directory has twenty files
20
>>> g.size                              # The games directory has three files
3
>>> os.remove('games/chess')            # Delete a game
>>> g.size                              # File count is automatically updated
2
5

Các thuộc tính sai chính tả hoặc không được chỉ định sẽ tăng một ngoại lệ:

>>> s = Directory('songs')
>>> g = Directory('games')
>>> s.size                              # The songs directory has twenty files
20
>>> g.size                              # The games directory has three files
3
>>> os.remove('games/chess')            # Delete a game
>>> g.size                              # File count is automatically updated
2
6