O padrão <modelo>_set
ou default_related_name
essencialmente é responsável por fazer a relação reversa de um (seu objeto q
instanciado da classe Question
) para muitos (0 ou mais objetos criados da classe Choice
associados à instância da classe Question
por relação de ForeignKey
).
Resumindo, quando é estabelecida a relação de chave estrangeira (ou ForeignKey
supracitada) no modelo Choice
apontando para o modelo Question
automaticamente é estabelecida uma relação de um para muitos a partir da propriedade choice_set
(choice sendo baseado no nome do modelo adjacente, sempre em minúsculo) na instância q
.
Como você observou originalmente, ao utilizar o método q.choice_set.create
o objeto q
estará sendo automaticamente injetado na criação dos objetos da classe relacionada (Choice
); de forma análoga, ao acessar o método q.choice_set.all
você estará informando ao framework que você deseja obter todos os objetos da classe Choice
que estão relacionados à instância q
especificamente.
É importante ressaltar que Choice.objects.all
é diferente de q.choice_set.all
neste caso: o primeiro estará obtendo todos os objetos da classe Choice
sem filtrar a relação com a classe Question
; já no segundo, conforme foi dito no parágrafo anterior, é basicamente estabelecido um filtro para obter apenas os dados relacionados à instância q
.
Para exemplificar isso tudo, observe o seguinte caso:
from django.utils import timezone
# Criando um objeto Question
q = Question.objects.create(question_text='Que faz agora?', pub_date=timezone.now())
# Criando escolhas (Choice) relacionadas ao objeto Question
q.choice_set.create(choice_text='Programando', votes=0)
q.choice_set.create(choice_text='Jogando', votes=0)
'''
Demonstrando a criação de um novo objeto Question em que é definida
a associação diretamente na criação dos objetos Choice respectivos
'''
q2 = Question.objects.create(question_text='De onde fala?', pub_date=timezone.now())
Choice.objects.create(question=q2, choice_text='Brasil', votes=0)
Choice.objects.create(question=q2, choice_text='EUA', votes=0)
Finalmente, obtendo as Choice
s, temos os seguintes resultados:
# Obtendo as escolhas (Choice) da pergunta (Question) 'Que faz agora?'
>>> q.choice_set.all()
<QuerySet [<Choice: Programando>, <Choice: Jogando>]>
# Mesma coisa para a pergunta 'De onde fala?'
>>> q2.choice_set.all()
<QuerySet [<Choice: Brasil>, <Choice: EUA>]>
# Obtendo os objetos Choice sem filtrar por qualquer dos Question relacionados
>>> Question.objects.all()
<QuerySet [<Choice: Programando>, <Choice: Jogando>, <Choice: Brasil>, <Choice: EUA>]>