🔗 Django Relations Inverses : Maîtriser '_Set' Et 'Related_Name' (Many-To-Many)

Django crée automatiquement des outils pour naviguer dans les relations entre vos modèles, y compris les **relations inverses**. Ces outils sont appelés **gestionnaires de relations (RelatedManager)**. Pour les champs ManyToManyField, comprendre et maîtriser le gestionnaire par défaut (_set) et sa personnalisation (related_name) est fondamental.

Rappel : Un ManyToManyField ne doit être défini que sur l'un des deux modèles pour établir une relation bidirectionnelle (comme l'indique cet excellent lien sur StackOverflow : Différence entre les champs de relation).

1. Les Modèles de Base

Considérons les deux modèles suivants qui définissent une relation Plusieurs-à-Plusieurs (Many-to-Many) où un utilisateur peut appartenir à plusieurs entreprises et vice-versa :

class User(models.Model):
    username = models.CharField(max_length=100, unique=True)
    companies = models.ManyToManyField('Company', blank=True)

class Company(models.Model):
    name = models.CharField(max_length=255)

Accès Direct (Naturel)

Pour obtenir toutes les entreprises d'un utilisateur, on utilise le nom du champ :

user_instance.companies.all()

2. Le Gestionnaire d'Accès Inverse par Défaut (`_set`)

Puisque le modèle Company n'a pas de champ explicite pointant vers User, Django crée automatiquement un gestionnaire d'accès inverse. Ce gestionnaire est nommé en utilisant la syntaxe : <modèle_source_en_minuscule>_set.

Dans notre cas, le modèle source de la relation inverse est **`User`**. Le gestionnaire s'appelle donc user_set :

# Accès inverse par défaut : Obtenir tous les utilisateurs d'une entreprise
company_instance.user_set.all() 
# Retourne un QuerySet d’objets User.

Ce mécanisme est la manière dont Django gère par défaut l'accès depuis l'objet qui ne porte pas la définition du champ relationnel.

3. La Méthode Recommandée : Utiliser `related_name`

Le nom par défaut _set est souvent peu clair. Il est fortement recommandé d'utiliser l'argument **related_name** lors de la définition du champ ManyToManyField pour spécifier un nom de gestionnaire inverse plus explicite.

Modification du Modèle

Nous remplaçons user_set par le nom plus logique users :

class User(models.Model):
    username = models.CharField(max_length=100, unique=True)
    # Définition du nom de la relation inverse comme 'users'
    companies = models.ManyToManyField('Company', blank=True, related_name='users')

class Company(models.Model):
    name = models.CharField(max_length=255)

Utilisation du Nom Personnalisé

L'accès inverse devient alors plus intuitif :

# Accès inverse personnalisé : Obtenir tous les utilisateurs d'une entreprise
company_instance.users.all()

L'utilisation de related_name rend votre code plus lisible et évite les conflits potentiels si plusieurs relations pointent vers le même modèle.