django models字段类型和参数的选择

ksuper&2024-09-05 11:45

1. CharField

  • 解释: 用于存储短文本，如用户名、标题等。

  • 参数 :

    • max_length: 必需参数，指定最大长度。
    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • default: 字段的默认值。
    • choices: 选项列表，限制字段的值必须在选项中。

  • 示例 :

    python 复制代码 
    class UserProfile(models.Model):
    username = models.CharField(max_length=150, unique=True)
    status = models.CharField(max_length=20, choices=[('active', 'Active'), ('inactive', 'Inactive')], default='active')

  • 解释 :

    • username: 用户名，最大长度为 150 个字符，必须唯一。
    • status: 用户状态，最大长度为 20 个字符，值必须是 'active' 或 'inactive'，默认值为 'active'。

2. TextField

  • 解释: 用于存储长文本，如文章内容、评论等。

  • 参数 :

    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • default: 字段的默认值。

  • 示例 :

    python 复制代码 
    class BlogPost(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()

  • 解释 :

    • title: 文章标题，最大长度为 200 个字符。
    • content: 文章内容，没有长度限制。

3. IntegerField

  • 解释: 用于存储整数，如年龄、数量等。

  • 参数 :

    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • default: 字段的默认值。

  • 示例 :

    python 复制代码 
    class Product(models.Model):
    name = models.CharField(max_length=100)
    stock = models.IntegerField(default=0)

  • 解释 :

    • name: 产品名称，最大长度为 100 个字符。
    • stock: 库存数量，默认为 0。

4. BooleanField

  • 解释: 用于存储布尔值，如是否激活、是否管理员等。

  • 参数 :

    • default: 字段的默认值。

  • 示例 :

    python 复制代码 
    class User(models.Model):
    email = models.EmailField(unique=True)
    is_active = models.BooleanField(default=True)

  • 解释 :

    • email: 用户的电子邮件地址，必须唯一。
    • is_active: 用户是否激活，默认为 True。

5. DateField

  • 解释: 用于存储日期，如生日、发布日期等。

  • 参数 :

    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • auto_now: 每次保存对象时，自动将字段设置为当前日期。
    • auto_now_add: 在对象第一次创建时，自动将字段设置为当前日期。

  • 示例 :

    python 复制代码 
    class Event(models.Model):
    name = models.CharField(max_length=200)
    event_date = models.DateField()

  • 解释 :

    • name: 事件名称，最大长度为 200 个字符。
    • event_date: 事件日期。

6. DateTimeField

  • 示例 :

    python 复制代码 
    class Comment(models.Model):
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

  • 解释 :

    • content: 评论内容。
    • created_at: 评论创建时间，自动设置为对象创建时的当前时间。
    • updated_at: 评论更新时间，每次保存对象时自动更新为当前时间。

7. EmailField

  • 解释: 用于存储电子邮件地址。

  • 参数 :

    • max_length: 最大长度，默认值为 254。
    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • default: 字段的默认值。

  • 示例 :

    python 复制代码 
    class Contact(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField()

  • 解释 :

    • name: 联系人名称，最大长度为 100 个字符。
    • email: 联系人的电子邮件地址。

8. FloatField

  • 解释: 用于存储浮点数，如价格、评分等。

  • 参数 :

    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • default: 字段的默认值。

  • 示例 :

    python 复制代码 
    class Product(models.Model):
    name = models.CharField(max_length=100)
    price = models.FloatField()

  • 解释 :

    • name: 产品名称，最大长度为 100 个字符。
    • price: 产品价格。

9. DecimalField

  • 解释: 用于存储定点数，如精确的货币值。

  • 参数 :

    • max_digits: 数字的最大位数，包括小数点前后的位数。
    • decimal_places: 小数点后的位数。
    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • default: 字段的默认值。

  • 示例 :

    python 复制代码 
    class Product(models.Model):
    name = models.CharField(max_length=100)
    price = models.DecimalField(max_digits=10, decimal_places=2)

  • 解释 :

    • name: 产品名称，最大长度为 100 个字符。
    • price: 产品价格，最多 10 位数字，其中 2 位小数。

10. URLField

  • 解释: 用于存储 URL 地址。

  • 参数 :

    • max_length: 最大长度，默认值为 200。
    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • default: 字段的默认值。

  • 示例 :

    python 复制代码 
    class Website(models.Model):
    name = models.CharField(max_length=100)
    url = models.URLField()

  • 解释 :

    • name: 网站名称，最大长度为 100 个字符。
    • url: 网站的 URL 地址。

11. ForeignKey

  • 解释: 用于创建多对一的关系。

  • 参数 :

    • to: 关联的模型。
    • on_delete: 指定删除关联对象时的行为。
    • related_name: 反向关系的名称。
    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。

  • 示例 :

    python 复制代码 
    class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    title = models.CharField(max_length=200)
    author = models.ForeignKey(Author, on_delete=models.CASCADE, related_name='books')

  • 解释 :

    • title: 书名，最大长度为 200 个字符。
    • author: 书的作者，关联到 Author

12. OneToOneField

  • 解释: 用于创建一对一的关系。

  • 参数 :

    • to: 关联的模型。
    • on_delete: 指定删除关联对象时的行为。
    • related_name: 反向关系的名称。
    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。

  • 示例 :

    python 复制代码 
    class User(models.Model):
    username = models.CharField(max_length=150, unique=True)

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='profile')
    bio = models.TextField(blank=True)

  • 解释 :

    • user: 关联到 User 模型，删除用户时也删除关联的用户资料。
    • bio: 用户简介，可以为空。

13. ManyToManyField

  • 解释: 用于创建多对多的关系。

  • 参数 :

    • to: 关联的模型。
    • related_name: 反向关系的名称。
    • blank: 是否允许表单提交空值，默认为 False。

  • 示例 :

    python 复制代码 
    class Student(models.Model):
    name = models.CharField(max_length=100)

class Course(models.Model):
    title = models.CharField(max_length=200)
    students = models.ManyToManyField(Student, related_name='courses')

  • 解释 :

    • title: 课程标题，最大长度为 200 个字符。
    • students: 选修该课程的学生，关联到 Student 模型。

14. FileField

  • 解释: 用于存储文件。

  • 参数 :

    • upload_to: 文件上传的目录或处理函数。
    • max_length: 文件路径的最大长度，默认值为 100。
    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。

  • 示例 :

    python 复制代码 
    class Document(models.Model):
    title = models.CharField(max_length=200)
    file = models.FileField(upload_to='documents/')

  • 解释 :

    • title: 文件标题，最大长度为 200 个字符。
    • file: 上传的文件，存储在 documents/ 目录下。

15. ImageField

  • 解释: 用于存储图像文件。

  • 参数 :

    • upload_to: 文件上传的目录或处理函数。
    • max_length: 文件路径的最大长度，默认值为 100。
    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。

  • 示例 :

    python 复制代码 
    class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    avatar = models.ImageField(upload_to='avatars/', blank=True, null=True)

  • 解释 :

    • user: 关联到 User 模型。
    • avatar: 用户头像，存储在 avatars/ 目录下，可以为空。

16. SlugField

  • 解释: 用于存储短标签，通常用于 URL。

  • 参数 :

    • max_length: 最大长度，默认值为 50。
    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • unique: 是否唯一，默认为 False。

  • 示例 :

    python 复制代码 
    class Article(models.Model):
    title = models.CharField(max_length=200)
    slug = models.SlugField(unique=True)

  • 解释 :

    • title: 文章标题，最大长度为 200 个字符。
    • slug: 文章的短标签，必须唯一。

17. JSONField

  • 解释: 用于存储 JSON 格式的数据。

  • 参数 :

    • null: 是否允许数据库存储 NULL 值，默认为 False。
    • blank: 是否允许表单提交空值，默认为 False。
    • default: 字段的默认值，可以是一个可调用对象，如 dict。
    • encoder: 自定义 JSON 编码器。
    • decoder: 自定义 JSON 解码器。

  • 示例 :

    python 复制代码 
    from django.db import models

class Product(models.Model):
    name = models.CharField(max_length=100)
    attributes = models.JSONField(default=dict)

# 使用示例
product = Product.objects.create(name="Laptop", attributes={"color": "silver", "weight": "1.5kg"})

  • 解释 :

    • name: 产品名称，最大长度为 100 个字符。
    • attributes: 产品属性，存储为 JSON 格式，默认值为空字典。
相关推荐
严格格2 分钟前
三范式，面试重点
数据库·面试·职场和发展
微刻时光19 分钟前
Redis集群知识及实战
数据库·redis·笔记·学习·程序人生·缓存
单字叶28 分钟前
MySQL数据库
数据库·mysql
mqiqe32 分钟前
PostgreSQL 基础操作
数据库·postgresql·oracle
just-julie34 分钟前
MySQL面试题——第一篇
数据库·mysql
趋势大仙1 小时前
SQLiteDatabase insert or replace数据不生效
android·数据库
丁总学Java1 小时前
如何使用 maxwell 同步到 redis?
数据库·redis·缓存
爱吃南瓜的北瓜1 小时前
Redis的Key的过期策略是怎样实现的？
数据库·redis·bootstrap
一心只为学1 小时前
Oracle密码过期问题，设置永不过期
数据库·oracle
小光学长1 小时前
基于vue框架的宠物销售管理系统3m9h3（程序+源码+数据库+调试部署+开发环境）系统界面在最后面。
数据库
热门推荐
01RAG 实践- Ollama+RagFlow 部署本地知识库02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04Coze扣子平台完整体验和实践（附国内和国际版对比）05苍穹外卖面试总结06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）08CCF-CSP认证考试 202406-3 文本分词 100分题解09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10借助 LocatorJS ，快速定位本地代码