1、ORM模型常用字段说明
1 <1> CharField 2 #字符串字段, 用于较短的字符串. 3 #CharField 要求必须有一个参数 maxlength, 用于从数据库层和Django校验层限制该字段所允许的最大字符数. 4 5 <2> IntegerField 6 #用于保存一个整数. 7 8 <3> FloatField 9 # 一个浮点数. 必须 提供两个参数: 10 # 11 # 参数 描述 12 # max_digits 总位数(不包括小数点和符号) 13 # decimal_places 小数位数 14 # 举例来说, 要保存最大值为 999 (小数点后保存2位),你要这样定义字段: 15 # 16 # models.FloatField(..., max_digits=5, decimal_places=2) 17 # 要保存最大值一百万(小数点后保存10位)的话,你要这样定义: 18 # 19 # models.FloatField(..., max_digits=19, decimal_places=10) 20 # admin 用一个文本框(<input type="text">)表示该字段保存的数据. 21 22 <4> AutoField 23 # 一个 IntegerField, 添加记录时它会自动增长. 你通常不需要直接使用这个字段; 24 # 自定义一个主键：my_id=models.AutoField(primary_key=True) 25 # 如果你不指定主键的话,系统会自动添加一个主键字段到你的 model. 26 27 <5> BooleanField 28 # A true/false field. admin 用 checkbox 来表示此类字段. 29 30 <6> TextField 31 # 一个容量很大的文本字段. 32 # admin 用一个 <textarea> (文本区域)表示该字段数据.(一个多行编辑框). 33 34 <7> EmailField 35 # 一个带有检查Email合法性的 CharField,不接受 maxlength 参数. 36 37 <8> DateField 38 # 一个日期字段. 共有下列额外的可选参数: 39 # Argument 描述 40 # auto_now 当对象被保存时,自动将该字段的值设置为当前时间.通常用于表示 "last-modified" 时间戳. 41 # auto_now_add 当对象首次被创建时,自动将该字段的值设置为当前时间.通常用于表示对象创建时间. 42 #（仅仅在admin中有意义...) 43 44 <9> DateTimeField 45 # 一个日期时间字段. 类似 DateField 支持同样的附加选项. 46 47 <10> ImageField 48 # 类似 FileField, 不过要校验上传对象是否是一个合法图片.#它有两个可选参数:height_field和width_field, 49 # 如果提供这两个参数,则图片将按提供的高度和宽度规格保存. 50 <11> FileField 51 # 一个文件上传字段. 52 #要求一个必须有的参数: upload_to, 一个用于保存上载文件的本地文件系统路径. 这个路径必须包含 strftime #formatting, 53 #该格式将被上载文件的 date/time 54 #替换(so that uploaded files don't fill up the given directory). 55 # admin 用一个<input type="file">部件表示该字段保存的数据(一个文件上传部件) . 56 57 #注意：在一个 model 中使用 FileField 或 ImageField 需要以下步骤: 58 #（1）在你的 settings 文件中, 定义一个完整路径给 MEDIA_ROOT 以便让 Django在此处保存上传文件. 59 # (出于性能考虑,这些文件并不保存到数据库.) 定义MEDIA_URL 作为该目录的公共 URL. 要确保该目录对 60 # WEB服务器用户帐号是可写的. 61 #（2） 在你的 model 中添加 FileField 或 ImageField, 并确保定义了 upload_to 选项,以告诉 Django 62 # 使用 MEDIA_ROOT 的哪个子目录保存上传文件.你的数据库中要保存的只是文件的路径(相对于 MEDIA_ROOT). 63 # 出于习惯你一定很想使用 Django 提供的 get_<#fieldname>_url 函数.举例来说,如果你的 ImageField 64 # 叫作 mug_shot, 你就可以在模板中以 {{ object.#get_mug_shot_url }} 这样的方式得到图像的绝对路径. 65 66 <12> URLField 67 # 用于保存 URL. 若 verify_exists 参数为 True (默认), 给定的 URL 会预先检查是否存在( 即URL是否被有效装入且 68 # 没有返回404响应). 69 # admin 用一个 <input type="text"> 文本框表示该字段保存的数据(一个单行编辑框) 70 71 <13> NullBooleanField 72 # 类似 BooleanField, 不过允许 NULL 作为其中一个选项. 推荐使用这个字段而不要用 BooleanField 加 null=True 选项 73 # admin 用一个选择框 <select> (三个可选择的值: "Unknown", "Yes" 和 "No" ) 来表示这种字段数据. 74 75 <14> SlugField 76 # "Slug" 是一个报纸术语. slug 是某个东西的小小标记(短签), 只包含字母,数字,下划线和连字符.#它们通常用于URLs 77 # 若你使用 Django 开发版本,你可以指定 maxlength. 若 maxlength 未指定, Django 会使用默认长度: 50. #在 78 # 以前的 Django 版本,没有任何办法改变50 这个长度. 79 # 这暗示了 db_index=True. 80 # 它接受一个额外的参数: prepopulate_from, which is a list of fields from which to auto-#populate 81 # the slug, via JavaScript,in the object's admin form: models.SlugField 82 # (prepopulate_from=("pre_name", "name"))prepopulate_from 不接受 DateTimeFields. 83 84 <13> XMLField 85 #一个校验值是否为合法XML的 TextField,必须提供参数: schema_path, 它是一个用来校验文本的 RelaxNG schema #的文件系统路径. 86 87 <14> FilePathField 88 # 可选项目为某个特定目录下的文件名. 支持三个特殊的参数, 其中第一个是必须提供的. 89 # 参数 描述 90 # path 必需参数. 一个目录的绝对文件系统路径. FilePathField 据此得到可选项目. 91 # Example: "/home/images". 92 # match 可选参数. 一个正则表达式, 作为一个字符串, FilePathField 将使用它过滤文件名. 93 # 注意这个正则表达式只会应用到 base filename 而不是 94 # 路径全名. Example: "foo.*.txt^", 将匹配文件 foo23.txt 却不匹配 bar.txt 或 foo23.gif. 95 # recursive可选参数.要么 True 要么 False. 默认值是 False. 是否包括 path 下面的全部子目录. 96 # 这三个参数可以同时使用. 97 # match 仅应用于 base filename, 而不是路径全名. 那么,这个例子: 98 # FilePathField(path="/home/images", match="foo.*", recursive=True) 99 # ...会匹配 /home/images/foo.gif 而不匹配 /home/images/foo/bar.gif 100 101 <15> IPAddressField 102 # 一个字符串形式的 IP 地址, (i.e. "24.124.1.30"). 103 <16># CommaSeparatedIntegerField 104 # 用于存放逗号分隔的整数值. 类似 CharField, 必须要有maxlength参数.
2、字段的参数
1 <1> null ： 数据库中字段是否可以为空 2 3 <2> blank： django的 Admin 中添加数据时是否可允许空值 4 5 <3> default：设定缺省值 6 7 <4> editable：如果为假，admin模式下将不能改写。缺省为真 8 9 <5> primary_key：设置主键，如果没有设置django创建表时会自动加上： 10 id = meta.AutoField('ID', primary_key=True) 11 primary_key=True implies blank=False, null=False and unique=True. Only one 12 primary key is allowed on an object. 13 14 <6> unique：数据唯一 15 16 <7> verbose_name Admin中字段的显示名称 17 18 <8> validator_list：有效性检查。非有效产生 django.core.validators.ValidationError 错误 19 20 21 <9> db_column，db_index 如果为真将为此字段创建索引 22 23 <10>choices：一个用来选择值的2维元组。第一个值是实际存储的值，第二个用来方便进行选择。 24 如SEX_CHOICES= (( ‘F’,'Female’),(‘M’,'Male’),) 25 gender = models.CharField(max_length=2,choices = SEX_CHOICES)
3、一对多（ForeignKey）的操作
在多的表（从表）里设置ForeignKey关联到一（主表）
我们首先创建两张具有一对多关系的表：
1 class department(models.Model): 2 name=models.CharField('部门名称',max_length=64,null=True,blank=True) 3 memo=models.CharField('备注',max_length=128,null=True,blank=True) 4 def __unicode__(self): 5 return self.name 6 class Meta: 7 verbose_name='部门表' 8 verbose_name_plural='部门表' 9 10 class worker(models.Model): 11 dep=models.ForeignKey('department',null=True,blank=True) 12 name=models.CharField('员工姓名',max_length=32,unique=True) 13 age=models.IntegerField('年龄',max_length=16,null=True,blank=True) 14 position=models.CharField('职位名',max_length=64,null=True,blank=True) 15 def __unicode__(self): 16 return self.name 17 class Meta: 18 verbose_name="员工表" 19 verbose_name_plural='员工表'
先来看创建数据
1 #一对多创建数据，一代表主表，多代表从表 2 #主表数据和从表的数据都需要创建 3 #第一种创建数据的方法 4 obj=models.department() #在主表(部门表)生成一个对象 5 obj.name="人力部" #添加一个部门 6 obj.save() 7 #添加从表(员工表)的数据 8 models.worker.objects.create(dep=obj,name='rl1',age='23',position='招聘专员') #通过对象设置 9 models.worker.objects.create(dep_id=1,name='rl1',age='23',position='招聘专员') #如果知道部门ID，这样直接写id也可以 10 11 #第二种创建数据的办法 12 models.department.objects.create(name='销售部') 13 obj=models.department.objects.filter(name='销售部') 14 models.worker.objects.create(dep=obj[0],name='xs1111',age='23',position='销售专员')
更新数据
1 #更新数据，xs1从销售部转到了财务部，并且年龄为25 2 #先在部门表中查到财务部的对象 3 obj_dep=models.department.objects.filter(name='财务部')[0] 4 #在员工表中查到xs1,然后在更新数据，以下两张方式都可以 5 obj_filter=models.worker.objects.filter(name='xs1').update(age='25',dep=obj_dep) 6 obj_filter=models.worker.objects.filter(name='xs1').update(age='25',dep_id='表中财务部的ID')
查询数据，正向查询
1 #查询,正向查询，通过从表查询主表 2 #查询员工表中员工叫cw3的所在部门 3 #get查询处理直接是一个model对象，filter和all查出来都是QuerySet对象 4 a_get = models.worker.objects.get(name='cw3').dep.name 5 a_filter=models.worker.objects.filter(name='cw3') #QuerySet对象是一个集合，需要获取集合中的对象才能继续取值 6 for i in a_filter: 7 print 'i',i.dep.name
查询数据，反向查询
1 #反向查询,通过主表查询从表 2 #通过部门表查询员工表中叫cw3所在的部门 3 4 models.department.objects.get(worker__name='cw3')
4、多对多
先创建两张多对多的表
1 class book(models.Model): 2 name=models.CharField('书籍名称',max_length=128) 3 author=models.ManyToManyField('author') 4 def __unicode__(self): 5 return self.name 6 class Meta: 7 verbose_name="书籍表" 8 verbose_name_plural="书籍表" 9 10 class author(models.Model): 11 name=models.CharField('作者姓名',max_length=128) 12 def __unicode__(self): 13 return self.name 14 class Meta: 15 verbose_name='作者表' 16 verbose_name_plural='作者表'
创建数据:
多对多的表创建数据需要先增加数据，然后再创建多对多关系
先插入数据
1 #增加数据 2 book_obj=models.book() 3 book_obj.name = '西游记' 4 book_obj.save() 5 models.book.objects.create(name='星辰变') 6 models.book.objects.create(name='盘龙') 7 models.author.objects.create(name='西红柿') 8 models.author.objects.create(name='番茄') 9 models.author.objects.create(name='番茄炒蛋')
添加多对多关系，正向添加
1 #给书籍星辰变添加一个作者番茄 2 author_obj=models.author.objects.get(name="番茄炒蛋") 3 models.book.objects.get(name="星辰变").author.add(author_obj)
反向添加，给书籍星辰变添加一个作者番茄炒蛋
1 #反向添加 2 book_obj=models.book.objects.get(name="星辰变") 3 models.author.objects.get(name='番茄炒蛋').book_set.add(book_obj)
查询数据：
正向查找，查询数据星辰变的作者
1 #正向查找，查找书籍星辰变的作者 2 book_obj=models.book.objects.get(name='星辰变').author.values('name')
反向查找
1 # 查找书籍星辰变的作者,双下划线方式 2 book_obj=models.author.objects.filter(book__name='星辰变').values('name') 3 #通过作者查找书籍 4 author_obj=models.author.objects.get(name='番茄') 5 book_obj=author_obj.book_set.all().values('name')