CKTIS / Python
property.setter — kontrolowany zapis właściwości
Użyj `property.setter`, aby zwykłe przypisanie do atrybutu instancji uruchamiało funkcję, która sprawdza nową wartość przed jej zapisaniem.
Wersja: Python 3.12
Składnia
class Task:
@property
def priority(self):
return self._priority
@priority.setter
def priority(self, value):
self._priority = value
# Functional form for an existing property p and a setter function set_priority:
# p = p.setter(set_priority)W Pythonie 3.12 dekorator @property tworzy właściwość z funkcją odczytu, czyli getterem. property.setter to metoda istniejącego obiektu property. Przyjmuje funkcję zapisu i zwraca nowy obiekt property z tą funkcją jako fset, zachowując getter i ewentualną funkcję usuwania. Nie zmienia pierwotnego obiektu.
Umieść @priority.setter po getterze i nazwij funkcję zapisu również priority. W ciele klasy dekorator przypisuje zwróconą właściwość do nazwy definiowanej funkcji. Inna nazwa nie zastąpiłaby pierwotnej właściwości priority.
Odczyt task.priority wywołuje getter, a task.priority = value przekazuje instancję jako self i nową wartość jako value do settera. Bez settera przypisanie zgłasza AttributeError. Setter nie zapisuje wartości automatycznie, a przypisanie ignoruje jego wartość zwracaną.
Sprawdź wartość przed zapisem do osobnego atrybutu, np. self._priority. Przypisanie do self.priority wewnątrz settera wywołałoby go ponownie. Podkreślenie to tylko konwencja: bezpośredni zapis do _priority omija walidację.
Przykłady
class Task:
def __init__(self, priority):
self.priority = priority
@property
def priority(self):
return self._priority
@priority.setter
def priority(self, value):
if type(value) is not int:
raise TypeError("priority must be an int")
if not 1 <= value <= 5:
raise ValueError("priority must be between 1 and 5")
self._priority = value
task = Task(2)
print(task.priority)
task.priority = 4
try:
task.priority = 0
except ValueError:
print("ValueError")
print(task.priority)Wynik
2 ValueError 4
Konstruktor i późniejsze przypisanie korzystają z tego samego settera. Setter przyjmuje wyłącznie wartości typu `int` od `1` do `5`. Próba zapisania `0` zgłasza `ValueError`; program przechwytuje wyjątek i pokazuje, że nadal zapisana jest wartość `4`.
Powiązane lekcje
- Python · Lekcja 2 · Zaawansowany · Wersja: 5