Hướng dẫn python get file descriptor - python get bộ mô tả tệp

Mô tả tệp trong Linux là gì?

Các tập tin, thư mục, ổ cắm, v.v., tất cả đều là các tệp trong Linux. Mỗi tệp có một số nguyên không âm liên quan đến nó. Số nguyên không âm này được gọi là bộ mô tả tệp cho tệp cụ thể đó. Mô tả tệp được phân bổ theo thứ tự tuần tự, với giá trị số nguyên dương không phân bổ thấp nhất có thể được ưu tiên.

Các mô tả tệp sau luôn được mở bất cứ khi nào một chương trình được chạy/thực thi.

Đầu vào tiêu chuẩn (STDIN) là bộ mô tả đọc mặc định với giá 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 7.STDIN) is the default reading descriptor with a value of >>> 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.
Đầu ra tiêu chuẩn (stdout) là bộ mô tả viết mặc định với giá 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 8.STDOUT) is the default writing descriptor with a value of >>> 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.
Lỗi tiêu chuẩn (STDERR) là bộ mô tả lỗi mặc định với giá 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 9.STDERR) is the default error descriptor with a value of >>> 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 9.

Phương phá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() 0

Trong Python, 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__() 0 là một phương thức thể hiện trên đối tượng tệp trả về bộ mô tả tệp cho tệp đã cho.

Cú pháp

fileObject.fileno()

Thông số

Phương pháp này không có tham số.

Giá trị trả về

Phương thức này trả về bộ mô tả tệp của 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__() 2 cụ thể.

Mã số

Nhận giá trị mô tả tệp của FileObject bằng fileno ()

Giải trình

Trong mã ở trên, chúng tôi tạo một tệp có tê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__() 3.

Dòng 1: Chúng tôi nhập gói 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.
Dòng 3: Chúng tôi xác định một biến gọi là 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 giữ tên tệp.
Dòng 4: Chúng tôi tạo một đối tượng tệp để đọc bằng cách sử dụng 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 với chế độ đọ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__() 7).
Dòng 6: Chúng tôi sử dụng 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__() 0 để có được bộ mô tả tệp cho đối tượng tệp.
Dòng 8: Chúng tôi sử dụng 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__() 9 để tạo ổ cắm TCP có tê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 0.
Dòng 9: Chúng tôi sử dụng 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__() 0 để có được bộ mô tả tệp cho đối tượ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 0 thu được trong dòng 8.

Lưu ý: Tham khảo lập trình ổ cắm trong Python để tìm hiểu thêm lập trình ổ cắm trong Python. Refer to Socket programming in Python to learn more socket programming in Python.

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:

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ả.
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ừ đó.
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.
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 3, >>> 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, >>> 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à __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 6 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 7 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 8:

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 9, toán tử DOT tìm thấy 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 trong từ điển lớp. Trong tra cứu 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 1, 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 2 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 8.

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 8 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 8 đượ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 7. 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 7 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 7 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 9 đượ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 >>> vars(vars(Person)['name']) {'public_name': 'name', 'private_name': '_name'} >>> vars(vars(Person)['age']) {'public_name': 'age', 'private_name': '_age'} 0 có hai trường hợp mô tả, tên và tuổi. Khi lớp >>> vars(vars(Person)['name']) {'public_name': 'name', 'private_name': '_name'} >>> vars(vars(Person)['age']) {'public_name': 'age', 'private_name': '_age'} 0 đượ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'} 2 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 >>> vars(vars(Person)['name']) {'public_name': 'name', 'private_name': '_name'} >>> vars(vars(Person)['age']) {'public_name': 'age', 'private_name': '_age'} 0 đã gọi >>> vars(vars(Person)['name']) {'public_name': 'name', 'private_name': '_name'} >>> vars(vars(Person)['age']) {'public_name': 'age', 'private_name': '_age'} 2 để 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'} 5 để 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 7, 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 9 hoặc >>> vars(vars(Person)['name']) {'public_name': 'name', 'private_name': '_name'} >>> vars(vars(Person)['age']) {'public_name': 'age', 'private_name': '_age'} 8.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 7, 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 9, or >>> vars(vars(Person)['name']) {'public_name': 'name', 'private_name': '_name'} >>> vars(vars(Person)['age']) {'public_name': 'age', 'private_name': '_age'} 8.

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'} 2. Đ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 class Ten: def __get__(self, obj, objtype=None): return 10 00, 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 3, >>> 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, >>> 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à class Ten: def __get__(self, obj, objtype=None): return 10 04 đề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 05 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 kế thừa từ class Ten: def __get__(self, obj, objtype=None): return 10 05 và phải cung cấp phương pháp class Ten: def __get__(self, obj, objtype=None): return 10 07 để 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ế:

class Ten: def __get__(self, obj, objtype=None): return 10 08 Xác minh rằng giá trị là một trong một tập hợp các tùy chọn bị hạn chế.
class Ten: def __get__(self, obj, objtype=None): return 10 09 xác minh rằng một giá trị là class Ten: def __get__(self, obj, objtype=None): return 10 10 hoặc class Ten: def __get__(self, obj, objtype=None): return 10 11. 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.
class Ten: def __get__(self, obj, objtype=None): return 10 12 xác minh rằng một giá trị là class Ten: def __get__(self, obj, objtype=None): return 10 13. 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 7, 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 9 và >>> vars(vars(Person)['name']) {'public_name': 'name', 'private_name': '_name'} >>> vars(vars(Person)['age']) {'public_name': 'age', 'private_name': '_age'} 8. 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 9 có chuỗi tra cứu bắt đầu với class Ten: def __get__(self, obj, objtype=None): return 10 18, sau đó class Ten: def __get__(self, obj, objtype=None): return 10 19 và tiếp tục thông qua thứ tự giải quyết phương pháp là class Ten: def __get__(self, obj, objtype=None): return 10 20. 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 21. 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 22

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

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

Đó 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 9 hoặc >>> vars(vars(Person)['name']) {'public_name': 'name', 'private_name': '_name'} >>> vars(vars(Person)['age']) {'public_name': 'age', 'private_name': '_age'} 8, 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 7 được gọi là mô tả không phải là 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 7 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 9 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 9 tăng class Ten: def __get__(self, obj, objtype=None): return 10 31 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 9 với một trình giữ chỗ nâng cao 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 33 hoặc class Ten: def __get__(self, obj, objtype=None): return 10 34.

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 35 tìm kiếm thuộc tính class Ten: def __get__(self, obj, objtype=None): return 10 36 trong chuỗi không gian tên cho class Ten: def __get__(self, obj, objtype=None): return 10 37. 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 38, 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 7 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 37 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 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 41 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 9, thì nó được gọi bằng: class Ten: def __get__(self, obj, objtype=None): return 10 43.

Logic cho một tra cứu chấm là trong class Ten: def __get__(self, obj, objtype=None): return 10 44. Đâ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ó móc class Ten: def __get__(self, obj, objtype=None): return 10 41 trong mã class Ten: def __get__(self, obj, objtype=None): return 10 46. Đó là lý do tại sao gọi class Ten: def __get__(self, obj, objtype=None): return 10 46 trực tiếp hoặc với class Ten: def __get__(self, obj, objtype=None): return 10 48 sẽ bỏ qua hoàn toàn class Ten: def __get__(self, obj, objtype=None): return 10 41.

Thay vào đó, chính toán tử DOT và chức năng class Ten: def __get__(self, obj, objtype=None): return 10 50 chịu trách nhiệm gọi class Ten: def __get__(self, obj, objtype=None): return 10 41 bất cứ khi nào class Ten: def __get__(self, obj, objtype=None): return 10 46 tăng class Ten: def __get__(self, obj, objtype=None): return 10 31. 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 54 là trong class Ten: def __get__(self, obj, objtype=None): return 10 55. Các bước tương tự như các bước cho class Ten: def __get__(self, obj, objtype=None): return 10 44 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 57.

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 58 và class Ten: def __get__(self, obj, objtype=None): return 10 59 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 46 cho đối tượng được trả về bởi class Ten: def __get__(self, obj, objtype=None): return 10 21.

Một tra cứu chấm chấm, chẳng hạn như class Ten: def __get__(self, obj, objtype=None): return 10 62 tìm kiếm class Ten: def __get__(self, obj, objtype=None): return 10 63 cho lớp cơ sở class Ten: def __get__(self, obj, objtype=None): return 10 64 ngay sau class Ten: def __get__(self, obj, objtype=None): return 10 65 và sau đó trả về class Ten: def __get__(self, obj, objtype=None): return 10 66. Nếu không phải là một mô tả, class Ten: def __get__(self, obj, objtype=None): return 10 67 đượ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 68 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 46 cho class Ten: def __get__(self, obj, objtype=None): return 10 70, class Ten: def __get__(self, obj, objtype=None): return 10 71 và class Ten: def __get__(self, obj, objtype=None): return 10 21.

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 46.
Các lớp kế thừa máy móc này từ class Ten: def __get__(self, obj, objtype=None): return 10 70, class Ten: def __get__(self, obj, objtype=None): return 10 71 hoặc class Ten: def __get__(self, obj, objtype=None): return 10 21.
Ghi đè class Ten: def __get__(self, obj, objtype=None): return 10 46 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 44 và class Ten: def __get__(self, obj, objtype=None): return 10 55 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 7. Đầ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 81 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 71 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'} 2, 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 84 và class Ten: def __get__(self, obj, objtype=None): return 10 85 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 86, 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'} 2 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 88 để 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 5 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 36:

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

Để xem >>> 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 triển khai theo giao thức mô tả như thế nào, đâ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

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 93. 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 5 hoặc tương đương class Ten: def __get__(self, obj, objtype=None): return 10 95 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 96 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 7 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 7. 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 7 chỉ trả về hàm 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 7 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 7 để 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 02 thành class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 03. Gọi class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 04 trở thành class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 05.

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 06 hoặc class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 07 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 08 hoặc class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 09. 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 10.

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 11 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 12 hoặc class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 13.

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 4 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 15 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:

Đường dẫn mã cho class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 17 đã đượ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 3 có thể hỗ trợ các nhà trang trí xích. Ví dụ, một lớp và tài sản có thể được xích lại với nhau. Trong Python 3.11, chức năng này đã bị phản đối.

Đố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 19, 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 tên thuộc tính được chỉ định trong class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 19:

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 19:

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 19 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 19 (đượ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 04 yêu cầu từ điển thể hiện để hoạt động chính xác:

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 19 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 class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 26 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:

Phương thức class Ten: def __get__(self, obj, objtype=None): return 10 86 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:

Phương pháp class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 28 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ử 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 29 và đặt Metaclass thành class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 30:metaclass to class A: x = 5 # Regular class attribute y = Ten() # Descriptor instance 30:

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

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 31 trong đó các thuộc tính được lưu trữ:

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ệ: