Surcharger la méthode save

Exclusif Premium

Débloquez votre potentiel ! ✨

Cette session fait partie de notre programme Premium exclusif

+100h de formations exclusives
+180 exercices de code avancés
+100h de mentorats en réécriture
20 projets guidés pas à pas
Mentorats groupés hebdomadaires
Support individuel avec nos mentors

Prêt à passer au niveau supérieur ?

Découvrez tous les avantages Premium et transformez votre apprentissage dès aujourd'hui!

Découvrir la formule Premium

Inscris-toi

(c'est gratuit !)

Un compte est nécessaire pour participer aux discussions.

Créer un compte

Toutes les questions

Gabriel Trouvé

18 janvier 2023

Résolue
2 réponses

Surcharger la méthode save Django

Re,Il y a peut-être une chose que j'ai mal comprise.La fonction super est utilisée après ma condition.Mais est-ce que j'aurais pu coder ma condition après super() ?Car dans la formation de base Python on utilisait toujours super() en premier.Au passage, il faut avoir en paramètre args et kwargs.Args car on peut avoir plusieurs paramètres ? Et kwargs car on peut avoir une clé=valeur en paramètre ?Merci d'avancefrom django.db import models from django.utils.text import slugify # Create your models here. class BlogPost(models.Model): # pour CharField il faut absolument définir une longueur en param title = models.CharField(max_length=100) # pour transformer title en url on utilise un slug slug = models.SlugField(blank=True) # valeur par défaut en param published = models.BooleanField(default=False) # blank permet de spécifier que je peux laisser vide. Sinon obligé de renseigner date date = models.DateField(blank=True, null=True) content = models.TextField() description = models.TextField() # une info que je ne veux pas forcémment stocker dans ma BDD mais juste afficher ==> def publish_string(self): if self.published: return "L'article est publié" return "L'article est inaccessible" def save(self, *args, **kwargs): if not self.slug: self.slug = slugify(self.title) super().save(*args, **kwargs)

Surcharger la méthode save

De la même façon qu'il est possible d'ajouter des méthodes ou des propriétés à un modèle, nous pouvons également surcharger les méthodes existantes des modèles Django.

Parmi ces méthodes, la méthode save est appelée lors de la sauvegarde d'un modèle dans la base de données.

On peut donc surcharger cette méthode pour rajouter des fonctionnalités personnalisées à chaque sauvegarde du modèle, par exemple pour rajouter automatiquement un slug si celui-ci n'est pas défini par l'utilisateur :

# blog/models.py
class BlogPost(models.Model):
    title = models.CharField(max_length=100)
    slug = models.SLugField()
    published = models.BooleanField(default=False)
    date = models.DateField(blank=True, null=True)
    content = models.TextField()
    description = models.TextField()

    def save(self, *args, **kwargs):
        if not self.slug:
            self.slug = slugify(self.title)

        super().save(*args, **kwargs)
00:00:00 :Dans cette partie, on va voir qu'on peut également surcharger certaines méthodes spéciales àl'intérieur de notre classe. Pour ça, on va créer donc une nouvelle méthode qui est la méthode save
00:00:10 :qui est appelée quand on sauvegarde une instance de notre classe dans la base de données. Donc,à l'intérieur de cette fonction, il ne faut pas oublier de rajouter args et quarks. Donc là,
00:00:20 :je ne vais pas rentrer dans les détails, ce serait trop long à expliquer. Si vous ne savez pas ceque c'est, je vous conseille d'aller vous informer sur ce que sont les args et quarks. Donc, il faut
00:00:28 :bien les mettre ici puisqu'il peut y avoir pas mal de choses qui sont passées à cette méthode save.Donc, on les met au cas où pour les récupérer et on va également utiliser super pour appeler laméthode save du parent, donc de la classe modèle dont on hérite. Donc là encore, je ne rentre pas
00:00:41 :dans les détails, c'est de l'orienté objet et je considère que vous maîtrisez tous ces aspects del'orienté objet. Donc, pourquoi je fais ça ici ? Et bien tout simplement parce que ça va me permettre
00:00:50 :d'effectuer des opérations au moment où je sauvegarde mes instances. Donc, par exemple,un truc qui est très intéressant à faire, c'est de modifier directement le champ slog sur nosinstances avant de les sauvegarder. Vous voyez ici que je n'ai pas mis de valeur par défaut
00:01:05 :puisque je ne veux pas que mon slog est une valeur par défaut qui soit la même à chaque fois,je veux que le slog soit déterminé automatiquement en fonction du titre. Donc actuellement, il faut
00:01:15 :que je le rentre à la main, donc quand je crée un modèle, il faut que je dise que le slog estégal à quelque chose qui est similaire au titre. Et donc là, ce qu'on va faire, c'est l'automatiser
00:01:23 :à l'intérieur de cette méthode save. Donc ce qu'on va faire, c'est qu'on va dire que si on n'apas self.slog, donc si on n'a pas de slog de défini, et bien on va en ct1. Donc si je fais
00:01:33 :self.slog égal, là pour l'instant je vais vous montrer en mettant bonjour juste pour l'exemple.Donc là ce qu'on fait, c'est que s'il n'y a rien qui est défini pour ce champ slog, et bien on metune valeur par défaut. Donc je vais revenir dans mon terminal, dans un interpréteur Python
00:01:47 :interactif pour créer un objet et vous montrer qu'on a bien le slog qui est défini automatiquement.Donc je fais python manage.py shell, je vais importer ici donc from blog.models ma classe
00:02:00 :blog post, et on va tout simplement créer une nouvelle instance dans l'article de blog pourle créer dans notre base de données. Donc je vais dire blog post égal à blog post, donc je crée une
00:02:11 :nouvelle instance, title on va dire par exemple les bases de Django, on va donner une descriptionqui va être juste une chaîne de caractère vide, un content avec une chaîne de caractère vide,il y avait je crois un autre field à spécifier, donc ceux là non puisqu'ils ont des valeurs par
00:02:25 :défaut et blank. Alors il y a le slog, on n'a pas mis blank ici, donc ce qu'il faudrait faire icic'est mettre blank égale true pour qu'on n'ait pas forcément à le spécifier ici. Dans ce cas ci
00:02:35 :ce que je peux faire pour ne pas mettre quelque chose mais qu'il n'y ait rien à l'intérieur c'esttout simplement spécifier une chaîne de caractère vide. Donc là ça va fonctionner puisque une chaîne
00:02:43 :de caractère vide c'est considéré comme false, donc on va quand même passer à l'intérieur decette structure conditionnelle pour changer le slog à bonjour. Mais ce qu'on ferait normalement
00:02:52 :c'est qu'on mettrait blank égale true ici, ce qui nous permettrait quand on crée notre modèle,donc quand on crée une instance, de ne pas spécifier de slog et si le slog n'est pas spécifié ou alorssi on met une chaîne de caractère vide comme je le fais actuellement, eh bien on va mettre une
00:03:06 :valeur par défaut. Donc j'appuie sur entrée pour valider et si je fais blog post.save, donc là onn'a rien vu puisque je n'ai pas mis de print ou quoi que ce soit, mais je vais aller récupérer ledernier élément dans ma base de données pour vous montrer qu'on a bien le slog qui est égal à
00:03:19 :bonjour. Donc pour récupérer le dernier élément de ma base de données, je vais utiliser blog post.objectet on a une méthode last qui nous permet de récupérer le dernier élément. Donc je vais
00:03:29 :afficher b, donc là j'ai bien l'élément numéro 6 et si je fais b.slog, là vous voyez qu'on abien bonjour pour le slog. Donc ça a fonctionné correctement et ce qu'on va faire là c'est pas
00:03:39 :mettre bonjour puisque actuellement c'est juste une valeur par défaut, donc vous allez me direqu'on pourrait très bien mettre cette valeur par défaut ici directement, mais nous ce qu'on veutce n'est pas mettre une valeur par défaut, ce qu'on veut c'est mettre notre titre ici sous formede slog. Pour ça on a une petite fonction très pratique qui est disponible avec Django, vous
00:03:56 :allez voir qu'il y a plein de fonctions comme ça que Django vous fournit qui permettent de faire cegenre d'opération, que ce soit sur des slog ou pour des dates par exemple, ou pour filtrer certaineschoses. Donc là elle n'est pas importée dans PyCharm, donc je vais faire option entrée où
00:04:09 :vous pouvez cliquer également sur la petite ampoule ici pour choisir d'importer ce nomautomatiquement. Comme ça vous n'avez même pas besoin de savoir où se trouve cette fonction,
00:04:17 :PyCharm va la trouver pour vous. Donc là vous avez slogify qui est disponible à différentsendroits, soit dans les utils, soit dans les default filters, donc il me semble que c'estexactement la même fonction. Je n'ai jamais pris le temps de vérifier mais je crois que c'est la
00:04:29 :même. Moi je prends généralement celle qui est dans utils, donc utils.txt, je clique pour valider,comme ça ça l'a importé automatiquement en haut de mon fichier PyCharm ici. Donc là encore un
00:04:40 :point supplémentaire pour PyCharm, j'adore vraiment cette IDE et ça me permet de ne pasavoir à retenir le nom de tous les modules. Comme je vous le disais, il y a beaucoup beaucoup de
00:04:48 :petites fonctions très utiles comme ça, mais à chaque fois c'est planqué dans des trucs commeça, comme Django, utils.txt etc, ça finit jamais. Donc moi avec PyCharm ça me permet rapidement
00:04:57 :comme ça d'importer des fonctions. Je me souviens qu'elle s'appelle slogify mais je ne me souvienspas dans quel module elle est. Et donc cette fonction va pouvoir lui passer dans ce cas ci
00:05:05 :self.title et ça va automatiquement convertir notre chaîne de caractère en slog. Donc si onavait par exemple les bases de Django, automatiquement ça transforme ça en les bases deDjango comme ceci, donc tout en minuscules avec des tirés comme on l'avait vu dans une partieprécédente. Donc là je vais mettre ça ici et on va recréer un objet pour vous montrer que ça
00:05:25 :fonctionne comme il faut. Donc je vais reprendre cet objet que j'avais créé et je vais appuyersur entrée pour valider. Je reprends donc la ligne, donc j'appuie sur les flèches du haut pour
00:05:34 :revenir dans mon historique. Je reprends ma ligne qui me permet de récupérer la dernière entrée.Donc là on va avoir l'entrée numéro 6. Alors numéro 6 c'est... alors oui en fait c'est normal
00:05:43 :puisque je n'ai pas sauvegardé blog post. Donc vous voyez que là j'ai créé une instance deblog post mais je ne l'ai pas sauvegardé. Là j'ai directement récupéré last, donc pour ça je vais
00:05:52 :déjà faire blog post.save pour sauvegarder cette nouvelle instance dans ma base de données. Et jevais refaire donc le last pour récupérer ma dernière instance. Et là j'ai bien l'instance
00:06:01 :numéro 7, donc qui est la dernière que j'ai créée. Et là si je fais b.slug, alors cette fois-ci on atoujours bonjour. Et alors je sais pourquoi, vous voyez qu'il y a beaucoup de choses sur lesquelles
00:06:11 :il faut faire attention et je laisse ces erreurs volontairement. Je ne les coupe pas au montage,je pourrais les couper mais je préfère ne pas les couper pour vous montrer vraiment toutes cespetites subtilités. Là en fait le problème c'est tout simplement que je n'ai pas reloadé mon
00:06:23 :module, donc les changements n'ont pas été pris en compte. Donc on va réimporter from blog.modelsnotre classe. Donc voilà j'appuie sur entrée pour valider, je sauvegarde cet objet avec save et je
00:06:35 :vais récupérer donc le dernier objet qui a été inséré dans ma base de données, donc avec laméthode last. Si j'affiche b, on a bien l'objet numéro 8 cette fois. Et si j'affiche b.slug, là
00:06:47 :vous voyez qu'on a bien cette fois-ci le slug qui est automatiquement dérivé de mon titre. Donc ona les modèles avec Django, les accents ont été enlevés, les majuscules ont été enlevés et lesespaces ont été remplacés par des tirés. Donc voilà pour cette partie sur la surcharge de cette
00:07:02 :fonction save, vous voyez là encore que c'est très puissant. Django nous fournit un framework,c'est ce que c'est, c'est un framework, ça nous permet d'avoir tout un tas de choses qui sontdéfinies pour nous par défaut, mais ça ne veut pas dire qu'on est complètement bloqué. Quand on
00:07:14 :veut modifier des fonctions, rajouter des choses, c'est tout à fait possible. Il faut bien entendumaîtriser tous les concepts d'orienter objet puisque là on fait de la surcharge. Vous voyez
00:07:23 :d'ailleurs sur PyCharm qu'on a cette petite icône qui nous indique que cette fonction est en trainde changer une fonction qui existe dans ma classe. Donc on a ici override method in model, donc là
00:07:34 :encore un point en plus pour PyCharm qui nous indique que cette méthode est déjà définie dansla classe model. Donc voilà pour la surcharge de cette méthode save qui nous permet automatiquement
00:07:44 :de mettre un slug sur notre blog post. C'est quelque chose que je fais très souvent, ça mepermet d'éviter d'avoir à le faire à la main et d'avoir quelque chose qui est dynamique en fonctionde mes articles de blog.

Ce n'est pas fini...

✋

Tu as complété % du parcours 🔥

Termine l'intégralité de la formation pour pouvoir débloquer ton attestation de réussite.

Rechercher sur le site

Inscris-toi à Docstring

Pour commencer ton apprentissage.

Tu as déjà un compte ? Connecte-toi.