草庐IT

Django 中 models 用法及参数详解

江城撅嘴的川羌 2023-08-04 原文

一、 模型常用字段

01. models.AutoField

  • 自增列 (int(11))

  • 参数中必须填入 primary_key=True

  • 默认情况下 Django 会为 ORM 中定义的每一张表加上一个自增 ID 字段,并且用这个字段来做主键。Django 默认的行为就像这样:

    即不主动添加此 ID 字段 Django 会自动添加该自增字段

    class TestModel(models.Model):
        id = models.AutoField(primary_key=True)
    

    数据库层面对应的 SQL 语句如下:

    CREATE TABLE `myapp_testmodel` (
     `id` int(11) NOT NULL AUTO_INCREMENT,
     PRIMARY KEY (`id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    

注意
如果要显式的自定义一个自增列,必须设置 primary_key=True,否则会报错,即下面这种写法是不被允许的:

class TestModel(models.Model):
    tid = models.AutoField()

02. models.CharField

03. models.BooleanField

  • 布尔类型 tinyint(1)
  • 不能为空,可添加 Blank=True

04. models.ComaSeparatedIntegerField

  • 用逗号分割的数字 varchar
  • 继承 CharField,所以必须 max_length 参数

05. models.DateField

  • 日期类型 date
  • DateField.auto_now: 保存时自动设置该字段为现在日期,最后修改日期
  • DateField.auto_now_add: 当该对象第一次被创建是自动设置该字段为现在日期,创建日期

06. models.DateTimeField

  • 日期时间类型 datetime
  • DateField 的参数

07. models.DecimalField

  • 十进制小数类型 decimal
  • DecimalField.max_digits: 数字中允许的最大位数
  • DecimalField.decimal_places: 存储的十进制位数

08. models.EmailField

  • 带有检查 Email 合法性的 CharField

09. models.FloatField

  • 浮点类型 double

10. models.IntegerField

  • 整型 int

11. models.BigIntegerField

  • 长整型

12. models.GenericIPAddressField

  • 一个带有检查 IP地址合法性的 CharField

13. models.NullBooleanField

  • 允许为空的布尔类型

14. models.PositiveIntegerField

  • 正整数

15. models.PositiveSmallIntegerField

  • smallInteger

16. models.SlugField

  • 减号、下划线、字母、数字

17. models.SmallIntegerField

  • 数字 tinyintsmallintintbigint

18. models.TextField

  • 大文本。默认对应的 form 标签是 textarea

19. models.TimeField

  • 时间 HH:MM[:ss[.uuuuuu]]

20. models.URLField

  • 一个带有URL合法性校验的 CharField

21. models.BinaryField

  • 二进制
  • 存储二进制数据。不能使用 filter 函数获得 QuerySet

22. models.ImageField

  • 图片
  • ImageField.height_fieldImageField.width_field: 如果提供这两个参数,则图片将按提供的高度和宽度规格保存,该字段要求 Python Imaging 库 Pillow
  • 会检查上传的对象是否是一个合法图片

23. models.FileField

  • 文件
  • FileField.upload_to: 用于保存上传文件的本地文件系统路径,该路径由 MEDIA_ROOT 中设置

24. models.FilePathField

  • FilePathField.path: 文件的绝对路径,必填
  • FilePathField.match: 用于过滤路径下文件名的正则表达式,该表达式将用在文件名上(不包括路径)
  • FilePathField.recursive: TrueFalse,默认为 False,指定是否应包括所有子目录的路径。

二、 字段常用参数

01. null

  • 如果是 TrueDjango 会在数据库中将此字段的值置为 NULL,默认值是 False

02. blank

  • 如果为 TruedjangoAdmin 中添加数据时可允许空值,可以不填。如果为 False 则必须填。默认是 False
  • null 纯粹是与数据库有关系的;而 blank 是与页面必填项验证有关的

03. primary_key

  • 主键,对 AutoField 类型设置主键后,就会代替原来的自增 id 字段

04. auto_now

  • 自动创建-无论添加或修改,都是当前操作的时间

05. auto_now_add

  • 自动创建-永远是创建时的时间

06. choices

  • 一个二维的元组被用作 choices,如果这样定义,Djangoselect box 代替普通的文本框

07. max_length

  • 字段长度

08. default

  • 默认值

09. verbose_name

  • Admin 中字段的显示名称,如果不设置该参数时,则为属性名

10. db_column

  • 数据库中的字段名称

11. unique

  • 不允许重复

12. db_index

  • 数据库索引

13. editable

  • Admin 里是否可编辑

14. error_messages

  • 错误提示

15. auto_created

  • 自动创建

16. help_text

  • Admin 中提示帮助信息

17. validators

  • 验证器

18. upload-to

  • 文件上传时的保存上传文件的目录

有关Django 中 models 用法及参数详解的更多相关文章

  1. ruby-on-rails - rails : keeping DRY with ActiveRecord models that share similar complex attributes - 2

    这似乎应该有一个直截了当的答案,但在Google上花了很多时间,所以我找不到它。这可能是缺少正确关键字的情况。在我的RoR应用程序中,我有几个模型共享一种特定类型的字符串属性,该属性具有特殊验证和其他功能。我能想到的最接近的类似示例是表示URL的字符串。这会导致模型中出现大量重复(甚至单元测试中会出现更多重复),但我不确定如何让它更DRY。我能想到几个可能的方向...按照“validates_url_format_of”插件,但这只会让验证干给这个特殊的字符串它自己的模型,但这看起来很像重溶液为这个特殊的字符串创建一个ruby​​类,但是我如何得到ActiveRecord关联这个类模型

  2. ruby-on-rails - 如何在 ruby​​ 中使用两个参数异步运行 exe? - 2

    exe应该在我打开页面时运行。异步进程需要运行。有什么方法可以在ruby​​中使用两个参数异步运行exe吗?我已经尝试过ruby​​命令-system()、exec()但它正在等待过程完成。我需要用参数启动exe,无需等待进程完成是否有任何ruby​​gems会支持我的问题? 最佳答案 您可以使用Process.spawn和Process.wait2:pid=Process.spawn'your.exe','--option'#Later...pid,status=Process.wait2pid您的程序将作为解释器的子进程执行。除

  3. ruby - RSpec - 使用测试替身作为 block 参数 - 2

    我有一些Ruby代码,如下所示:Something.createdo|x|x.foo=barend我想编写一个测试,它使用double代替block参数x,这样我就可以调用:x_double.should_receive(:foo).with("whatever").这可能吗? 最佳答案 specify'something'dox=doublex.should_receive(:foo=).with("whatever")Something.should_receive(:create).and_yield(x)#callthere

  4. ruby - 如何在 Ruby 中拆分参数字符串 Bash 样式? - 2

    我正在为一个项目制作一个简单的shell,我希望像在Bash中一样解析参数字符串。foobar"helloworld"fooz应该变成:["foo","bar","helloworld","fooz"]等等。到目前为止,我一直在使用CSV::parse_line,将列分隔符设置为""和.compact输出。问题是我现在必须选择是要支持单引号还是双引号。CSV不支持超过一个分隔符。Python有一个名为shlex的模块:>>>shlex.split("Test'helloworld'foo")['Test','helloworld','foo']>>>shlex.split('Test"

  5. ruby - 检查方法参数的类型 - 2

    我不确定传递给方法的对象的类型是否正确。我可能会将一个字符串传递给一个只能处理整数的函数。某种运行时保证怎么样?我看不到比以下更好的选择:defsomeFixNumMangler(input)raise"wrongtype:integerrequired"unlessinput.class==FixNumother_stuffend有更好的选择吗? 最佳答案 使用Kernel#Integer在使用之前转换输入的方法。当无法以任何合理的方式将输入转换为整数时,它将引发ArgumentError。defmy_method(number)

  6. ruby-on-rails - 在默认方法参数中使用 .reverse_merge 或 .merge - 2

    两者都可以defsetup(options={})options.reverse_merge:size=>25,:velocity=>10end和defsetup(options={}){:size=>25,:velocity=>10}.merge(options)end在方法的参数中分配默认值。问题是:哪个更好?您更愿意使用哪一个?在性能、代码可读性或其他方面有什么不同吗?编辑:我无意中添加了bang(!)...并不是要询问nobang方法与bang方法之间的区别 最佳答案 我倾向于使用reverse_merge方法:option

  7. ruby - 定义方法参数的条件 - 2

    我有一个只接受一个参数的方法:defmy_method(number)end如果使用number调用方法,我该如何引发错误??通常,我如何定义方法参数的条件?比如我想在调用的时候报错:my_method(1) 最佳答案 您可以添加guard在函数的开头,如果参数无效则引发异常。例如:defmy_method(number)failArgumentError,"Inputshouldbegreaterthanorequalto2"ifnumbereputse.messageend#=>Inputshouldbegreaterthano

  8. ruby - rails 3 redirect_to 将参数传递给命名路由 - 2

    我没有找到太多关于如何执行此操作的信息,尽管有很多关于如何使用像这样的redirect_to将参数传递给重定向的建议:action=>'something',:controller=>'something'在我的应用程序中,我在路由文件中有以下内容match'profile'=>'User#show'我的表演Action是这样的defshow@user=User.find(params[:user])@title=@user.first_nameend重定向发生在同一个用户Controller中,就像这样defregister@title="Registration"@user=Use

  9. ruby - 字符串文字中的转义状态作为 `String#tr` 的参数 - 2

    对于作为String#tr参数的单引号字符串文字中反斜杠的转义状态,我觉得有些神秘。你能解释一下下面三个例子之间的对比吗?我特别不明白第二个。为了避免复杂化,我在这里使用了'd',在双引号中转义时不会改变含义("\d"="d")。'\\'.tr('\\','x')#=>"x"'\\'.tr('\\d','x')#=>"\\"'\\'.tr('\\\d','x')#=>"x" 最佳答案 在tr中转义tr的第一个参数非常类似于正则表达式中的括号字符分组。您可以在表达式的开头使用^来否定匹配(替换任何不匹配的内容)并使用例如a-f来匹配一

  10. ruby-on-rails - 如何生成传递一些自定义参数的 `link_to` URL? - 2

    我正在使用RubyonRails3.0.9,我想生成一个传递一些自定义参数的link_toURL。也就是说,有一个articles_path(www.my_web_site_name.com/articles)我想生成如下内容:link_to'Samplelinktitle',...#HereIshouldimplementthecode#=>'http://www.my_web_site_name.com/articles?param1=value1¶m2=value2&...我如何编写link_to语句“alàRubyonRailsWay”以实现该目的?如果我想通过传递一些

随机推荐