本文介绍了如何在 Django 模型中确保姓名和姓氏的组合是唯一的。通过使用 `unique_together` 约束和模型验证，可以防止在数据库中保存重复的人员信息，从而避免数据不一致的问题。本文提供了详细的代码示例和解释，帮助开发者轻松实现这一功能。
在 Django 项目中，确保数据的唯一性至关重要，尤其是在处理人员信息时。如果允许重复的姓名和姓氏组合存在，可能会导致数据混淆和应用程序逻辑错误。本文将介绍如何使用 Django 提供的功能，强制 JrtnPerson 模型中的 name 和 surname 字段组合保持唯一。
使用 unique_together 约束
Django 的模型元选项 unique_together 允许你指定模型中哪些字段的组合必须是唯一的。 这是一种声明性方法，简单易用。
在 JrtnPerson 模型中，我们可以添加一个 Meta 类，并在其中定义 unique_together：
from django.db import models
from phonenumber_field.modelfields import PhoneNumberField
class Drtn(models.Model): # 假设 Drtn 模型已定义
name_short = models.CharField(max_length=200)
name_full = models.CharField(max_length=200)
def __str__(self):
return self.name_short
class JrtnPerson(models.Model):
rtn = models.ForeignKey(Drtn, verbose_name='Подразделение Ростехнадзора', on_delete=models.CASCADE)
name = models.CharField(max_length=200, verbose_name='Имя и Отчество')
surname = models.CharField(max_length=200, verbose_name='Фамилия')
tel_mob = PhoneNumberField(verbose_name="Номер телефона мобильный", blank=True, null=True)
tel_rab = PhoneNumberField(verbose_name="Номер телефона рабочий", blank=True, null=True)
email = models.EmailField(max_length=100, verbose_name="Электронная почта", blank=True, null=True)
class Meta:
unique_together = ('name', 'surname')
def __str__(self):
return f'{self.surname} {self.name}'这段代码会在数据库级别强制 name 和 surname 的组合是唯一的。如果尝试保存具有相同 name 和 surname 的 JrtnPerson 实例，Django 将会抛出一个 IntegrityError 异常。
模型验证
虽然 unique_together 约束在数据库级别强制了唯一性，但最好在保存模型之前进行验证，以便在更早的阶段捕获错误。 这可以通过覆盖模型的 save() 方法，并在其中调用 full_clean() 方法来实现。full_clean() 方法会执行模型的所有验证，包括 unique_together 约束。
from django.core.exceptions import ValidationError
class JrtnPerson(models.Model):
rtn = models.ForeignKey(Drtn, verbose_name='Подразделение Ростехнадзора', on_delete=models.CASCADE)
name = models.CharField(max_length=200, verbose_name='Имя и Отчество')
surname = models.CharField(max_length=200, verbose_name='Фамилия')
tel_mob = PhoneNumberField(verbose_name="Номер телефона мобильный", blank=True, null=True)
tel_rab = PhoneNumberField(verbose_name="Номер телефона рабочий", blank=True, null=True)
email = models.EmailField(max_length=100, verbose_name="Электронная почта", blank=True, null=Null)
class Meta:
unique_together = ('name', 'surname')
def save(self, *args, **kwargs):
try:
self.full_clean()
except ValidationError as e:
# 处理验证错误，例如记录日志或向用户显示错误消息
print(f"Validation Error: {e}")
raise # 重新引发异常，以便调用者知道保存失败
super().save(*args, **kwargs)
def __str__(self):
return f'{self.surname} {self.name}'在这个例子中，save() 方法首先调用 full_clean() 来验证模型。如果验证失败（例如，因为违反了 unique_together 约束），则会抛出一个 ValidationError 异常。你可以捕获这个异常并采取适当的措施，例如记录错误或向用户显示错误消息。 raise 语句重新引发异常，确保调用者知道保存操作失败。
注意事项
- 数据库迁移: 在添加或修改 unique_together 约束后，需要运行 python manage.py makemigrations 和 python manage.py migrate 来更新数据库模式。
- 错误处理: 确保正确处理 ValidationError 和 IntegrityError 异常，以便在发生唯一性冲突时提供友好的用户体验。
- 性能: 对于大型数据集，考虑在 name 和 surname 字段上创建索引，以提高查询性能。
总结
通过使用 unique_together 约束和模型验证，可以有效地防止在 Django 模型中保存重复的姓名和姓氏组合。 这有助于保持数据的完整性，并避免应用程序中出现潜在的问题。 记住，在添加或修改唯一性约束后，始终要运行数据库迁移，并确保正确处理可能发生的异常。
