Django模型（Models）：1、字段及属性

本是古典何须时尚 2022-11-30 01:19 269阅读 0赞

## 简介 ##

模型是一个用于表示数据的Python类，包含基本的数据字段和行为，在Django中，通常一个模型就代表一个数据库表。  
模型集成自django.db.models.Model，模型的每一个属性代表一个数据表的列。

## 举例介绍 ##

1.  在models.py文件中创建一个Person模型：

from django.db import models
    
    class Person(models.Model):
        name = models.CharField(max_length=30)
        age = models.IntegerField(default=0, db_column='age')

模型Persons包括两个字段：name和age，这两个字段都是模型的类属性，分别对应数据库表中的两个列。

1.  当执行 **makemigrations** 后，Django会自动生成模型的数据库迁移文件，在 $\{appName\}/migrations/ 文件夹下：

from django.db import migrations, models
    
    
    class Migration(migrations.Migration):
    
        initial = True
    
        dependencies = [
        ]
    
        operations = [
            migrations.CreateModel(
                name='Person',
                fields=[
                    ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
                    ('name', models.CharField(max_length=30)),
                    ('age', models.IntegerField(db_column='age', default=0)),
                ],
            ),
        ]

*Django会自动添加主键id*

1.  当执行 **migrate** 命令后，Django根据跟模型名一致的数据了标明，命名规则：**应用程序名\_模型名**

## 字段类型 ##

模型字段是模型的类的属性，它的命名不能和模型接口相同，如不能使用clean、save等字段，同时，字段名字中**不能出现连续的两个下划线**，因为联系两个下划线是Django数据库API的特殊语法。

为了支持不同的数据库，Django提供了十几种字段类型：

<table> 
 <thead> 
  <tr> 
   <th>序号</th> 
   <th>字段</th> 
   <th>说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td>AutoField</td> 
   <td>IntegerField的改进形式，字段根据已有的ID自动增长，一般用于主键。</td> 
   <td>Django会自动创建</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>BigAutoField</td> 
   <td>与AutoField相似，取值范围为1~9223372036854775807</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>BooleanField</td> 
   <td>字段值只包含True和False</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td>CharField</td> 
   <td>字符串类型</td> 
   <td>必要字段：max_length：表示能接受的最大字符数</td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td>DateField</td> 
   <td>日期类型</td> 
   <td>可选字段：auto_now：每当保存数据时，都会将该字段更新为当前时间；auto_now_add：该行数据第一次保存时才会保存当前时间；</td> 
  </tr> 
  <tr> 
   <td>6</td> 
   <td>DateTimeField</td> 
   <td>时间类型</td> 
   <td>与DateField一样，包含两个额外参数auto_now和auto_now_add</td> 
  </tr> 
  <tr> 
   <td>7</td> 
   <td>DecimalField</td> 
   <td>指定小数位数的数值类型</td> 
   <td>对应Python的Decimal类型；包含两个必要参数：max_digits：数值的总位数；decimal_places：小数点后位数</td> 
  </tr> 
  <tr> 
   <td>8</td> 
   <td>EmailField</td> 
   <td>本质是CharField，并会校验输入字符串是否是一个有效的邮件地址</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>9</td> 
   <td>FileField</td> 
   <td>文件上传控件</td> 
   <td>该字段不允许使用primary_key属性，包含两个可选参数；upload_to：文件上传后的保存位置；storage：负责文件存储的Python类；</td> 
  </tr> 
  <tr> 
   <td>10</td> 
   <td>FilePathField</td> 
   <td>文件列表显示字段</td> 
   <td>必选字段：path：文件路径；可选参数：match：正则表达式，只能过滤文件名，不能过滤路径；recursive：True或False，当为True时，FilePathField.path的子文件夹中符合条件的文件也会显示在下拉列表中，默认为True；allow_files：True或False。</td> 
  </tr> 
  <tr> 
   <td>11</td> 
   <td>FloatField</td> 
   <td>浮点数类型</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>12</td> 
   <td>ImageField</td> 
   <td>包含FileField字段的所有属性和方法，但是仅允许上传图片类型文件。</td> 
   <td>额外属性：height_field：图片高度；width_field，图片宽度；</td> 
  </tr> 
  <tr> 
   <td>13</td> 
   <td>IntegerField</td> 
   <td>整数字段，取值范围：-214783648~ 214783647</td> 
   <td>对于所有Django支持的数据库来说是安全的。</td> 
  </tr> 
  <tr> 
   <td>14</td> 
   <td>PositiveIntegerField</td> 
   <td>正整数类型，取值范围：0~214783647</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>15</td> 
   <td>PositiveSmallIntegerField</td> 
   <td>小正整数类型，取值范围：0~32767</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>16</td> 
   <td>SmallIntegerField</td> 
   <td>小整数类型，取值范围：-32768~32767</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>17</td> 
   <td>SlugField</td> 
   <td>Slug是用于新闻业的专业名词，slug是一个简短的文本，只允许包含字母，数字，下划线和连字符</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>18</td> 
   <td>TextField</td> 
   <td>超长文本类型</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>19</td> 
   <td>TimeField</td> 
   <td>时间类型，对应datatime.time</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>20</td> 
   <td>URLField</td> 
   <td>CharField类型，只能接受URL字符串</td> 
   <td>默认最大长度是200字符</td> 
  </tr> 
 </tbody> 
</table>

## 字段通用属性 ##

每一个字段都需要一系列的属性，如使用CharField时，必须给出max\_length属性，除了以上特殊字段属性外，Django还为所有字段提供了一系列通用属性，这些属性都是可选的：

<table> 
 <thead> 
  <tr> 
   <th>序号</th> 
   <th>属性</th> 
   <th>说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td>null</td> 
   <td>默认值True，此时保存模型时， Django在数据库的对应字段中保存空。</td> 
   <td>对于文本型字段，尽可能不使用null属性，因为当使用默认null时，数据库中就可能现两种空数据:NULL和空字符，而Django默认使用字符串。</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>blank</td> 
   <td>默认值为False，当设置Field.blank=True时,字段值允许为空。</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>choices</td> 
   <td>属性值为一个可迭代对象，如列表或者元组，迭代对象的每个成员包括两个字符串。当字段设置了 choices属性时，字段在网页中将会以下拉列表的形式显示。</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td>default</td> 
   <td>设置默认字段。可以是字符串或者方法，但不可以是可变对象</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td>help_text</td> 
   <td>HTML元素提示文本，在文本中可以使用HTML标记。</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>6</td> 
   <td>primary_key</td> 
   <td>将字段设置为数据表主键。如果模型中任何字段都不包含 primary_key=True属性，Django将会自动为模型添加一个 IntegerField字段作为主键。</td> 
   <td>主键永远是只读的，当修改一个模型对象的主键后，如果保存将会在数据库中创建一个新对象。</td> 
  </tr> 
  <tr> 
   <td>7</td> 
   <td>unique</td> 
   <td>当字段的unique属性设置为True时，该字段的所有值在整张数据表中不能重复，每一行数据都必须有唯一的字段值。</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>8</td> 
   <td>verbose＿name</td> 
   <td>字段说明。</td> 
   <td>ForeignKey、ManyToManyField、OneToOneField三种字段类型要求第一个参数必须是模型类，因此必须使用verbose＿name关键字。除此以外其他字段类型都包含一个默认的verbose_name属性，可以直接在字段属性列表的第一位输入文本作为verbose_name属性值。如果没有给出 verbose_name属性，Django会使用字段名作为verbose_name值，如果字段名中包含下画线时，下画线会被转换为空格。</td> 
  </tr> 
 </tbody> 
</table>