Comment fonctionne le décorateur @property de Python pour créer des propriétés ?

Comprendre le décorateur @property en Python

En Python, le décorateur @property vous permet de créer des propriétés qui se comportent comme des attributs d'instance normaux. Cependant, contrairement aux fonctions de propriété intégrées qui acceptent des arguments, le décorateur @property ne reçoit explicitement aucun argument.

Comment ça marche

Pour comprendre comment le @property decorator fonctionne, il est important de comprendre d'abord que la fonction property() renvoie un objet descripteur. Il s'agit d'un intermédiaire qui se situe entre une instance et sa propriété, permettant d'appliquer une logique supplémentaire.

L'objet descripteur

L'objet descripteur renvoyé par la propriété( ) la fonction a trois méthodes intégrées :

• getter : Pour récupérer la propriété value
• setter : Pour définir la valeur de la propriété
• deleter : Pour supprimer la propriété

Création de propriétés avec le décorateur

Lorsque le décorateur @property est appliqué à un fonction, il renvoie un objet descripteur et l'attribue au nom de la propriété. Cet objet conserve la fonction getter de la fonction d'origine et inclut deux fonctions supplémentaires qui délèguent aux méthodes setter et deleter de la propriété.

Par exemple :

class C:
    def __init__(self):
        self._x = None

    @property
    def x(self):
        """I'm the 'x' property."""
        return self._x

Le code ci-dessus crée un propriété nommée "x" qui peut récupérer la valeur de self._x sans aucun objet de propriété explicite. La fonction getter est automatiquement créée par le décorateur.

Décorateurs Setter et Supprimer

Pour ajouter des méthodes setter et deleter, ajoutez simplement .setter et .deleter à la @property objet descripteur, en transmettant les fonctions prévues :

@x.setter
def x(self, value):
    self._x = value

@x.deleter
def x(self):
    del self._x

En utilisant ces méthodes, vous pouvez implémenter un comportement personnalisé pour définition et suppression de la valeur de la propriété.

Détails de mise en œuvre

La syntaxe @decorator pour @property est du sucre syntaxique. Dans les coulisses, le code suivant est exécuté :

def x(self): return self._x
x = property(x)

Exemple de descripteur

Voici un exemple de la façon dont fonctionnerait une implémentation Python pure d'un descripteur de propriété :

class Property:
    def __init__(self, fget=None, fset=None, fdel=None, doc=None):
        self.fget = fget
        self.fset = fset
        self.fdel = fdel
        self.__doc__ = doc

    def __get__(self, obj, objtype=None):
        if obj is None:
            return self
        if self.fget is None:
            raise AttributeError("unreadable attribute")
        return self.fget(obj)

Cette classe vous permet de créer manuellement des propriétés avec des fonctions getter, setter et deleter.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!