mirror of
				https://github.com/django/django.git
				synced 2025-10-31 09:41:08 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			93 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			93 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
| """
 | |
| Many-to-many relationships
 | |
| 
 | |
| To define a many-to-many relationship, use ``ManyToManyField()``.
 | |
| 
 | |
| In this example, an ``Article`` can be published in multiple ``Publication``
 | |
| objects, and a ``Publication`` has multiple ``Article`` objects.
 | |
| """
 | |
| 
 | |
| from django.db import models
 | |
| 
 | |
| 
 | |
| class Publication(models.Model):
 | |
|     title = models.CharField(max_length=30)
 | |
| 
 | |
|     class Meta:
 | |
|         ordering = ("title",)
 | |
| 
 | |
|     def __str__(self):
 | |
|         return self.title
 | |
| 
 | |
| 
 | |
| class Tag(models.Model):
 | |
|     id = models.BigAutoField(primary_key=True)
 | |
|     name = models.CharField(max_length=50)
 | |
| 
 | |
|     def __str__(self):
 | |
|         return self.name
 | |
| 
 | |
| 
 | |
| class NoDeletedArticleManager(models.Manager):
 | |
|     def get_queryset(self):
 | |
|         return super().get_queryset().exclude(headline="deleted")
 | |
| 
 | |
| 
 | |
| class Article(models.Model):
 | |
|     headline = models.CharField(max_length=100)
 | |
|     # Assign a string as name to make sure the intermediary model is
 | |
|     # correctly created. Refs #20207
 | |
|     publications = models.ManyToManyField(Publication, name="publications")
 | |
|     tags = models.ManyToManyField(Tag, related_name="tags")
 | |
|     authors = models.ManyToManyField("User", through="UserArticle")
 | |
| 
 | |
|     objects = NoDeletedArticleManager()
 | |
| 
 | |
|     class Meta:
 | |
|         ordering = ("headline",)
 | |
| 
 | |
|     def __str__(self):
 | |
|         return self.headline
 | |
| 
 | |
| 
 | |
| class User(models.Model):
 | |
|     username = models.CharField(max_length=20, unique=True)
 | |
| 
 | |
|     def __str__(self):
 | |
|         return self.username
 | |
| 
 | |
| 
 | |
| class UserArticle(models.Model):
 | |
|     user = models.ForeignKey(User, models.CASCADE, to_field="username")
 | |
|     article = models.ForeignKey(Article, models.CASCADE)
 | |
| 
 | |
| 
 | |
| # Models to test correct related_name inheritance
 | |
| class AbstractArticle(models.Model):
 | |
|     class Meta:
 | |
|         abstract = True
 | |
| 
 | |
|     publications = models.ManyToManyField(
 | |
|         Publication, name="publications", related_name="+"
 | |
|     )
 | |
| 
 | |
| 
 | |
| class InheritedArticleA(AbstractArticle):
 | |
|     pass
 | |
| 
 | |
| 
 | |
| class InheritedArticleB(AbstractArticle):
 | |
|     pass
 | |
| 
 | |
| 
 | |
| class NullableTargetArticle(models.Model):
 | |
|     headline = models.CharField(max_length=100)
 | |
|     publications = models.ManyToManyField(
 | |
|         Publication, through="NullablePublicationThrough"
 | |
|     )
 | |
| 
 | |
| 
 | |
| class NullablePublicationThrough(models.Model):
 | |
|     article = models.ForeignKey(NullableTargetArticle, models.CASCADE)
 | |
|     publication = models.ForeignKey(Publication, models.CASCADE, null=True)
 |