CharField – Django模型
CharField是一个字符串字段,用于小到大的字符串。它就像C/C++中的一个字符串字段。CharField通常用于存储小的字符串,如名字、姓氏等。为了存储较大的文本,则使用TextField。这个字段的默认窗体部件是TextInput 。
CharField有一个额外的必要参数:
CharField.max_length
该字段的最大长度(以字符为单位)。max_length在数据库层面和Django的验证中使用MaxLengthValidator强制执行。
语法:
field_name = models.CharField(max_length=200, **options)
Django模型CharField的解释
用一个例子说明CharField的情况。考虑一个名为geeksforgeeks的项目,有一个名为geeks的应用程序。
在geeks应用程序的models.py文件中输入以下代码。
from django.db import models
from django.db.models import Model
# Create your models here.
class GeeksModel(Model):
geeks_field = models.CharField(max_length = 200)
在INSTALLED_APPS中增加geek的应用程序。
# Application definition
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'geeks',
]
现在,当我们从终端运行makemigrations命令时。
Python manage.py makemigrations
在geeks目录下将创建一个名为migrations的新文件夹,其中有一个名为0001_initial.py的文件。
# Generated by Django 2.2.5 on 2019-09-25 06:00
from django.db import migrations, models
class Migration(migrations.Migration):
initial = True
dependencies = [
]
operations = [
migrations.CreateModel(
name ='GeeksModel',
fields =[
('id',
models.AutoField(
auto_created = True,
primary_key = True,
serialize = False,
verbose_name ='ID'
)),
('geeks_field',
models.CharField(
max_length = 200,
)),
],
),
]
运行,
Python manage.py migrate
因此,当你在项目上运行迁移时,会创建一个geeks_field CharField。它是一个用来存储大大小小的字符串的字段。
如何使用CharField
CharField用于在数据库中存储小尺寸的字符串。人们可以存储名字、姓氏、地址细节等。CharField应该有一个参数max_length,用于指定它需要存储的字符串的最大长度。在生产服务器中,Django应用程序部署后,空间非常有限。因此,根据字段的要求使用max_length总是最好的。让我们创建一个我们所创建的CharField的实例,并检查它是否能工作。
# importing the model
# from geeks app
from geeks.models import GeeksModel
# creating a instance of
# GeeksModel
geek_object = GeeksModel.objects.create(geeks_field ="GFG is Best")
geek_object.save()
现在让我们在管理服务器中检查一下。我们已经创建了一个GeeksModel的实例。
字段选项
字段选项是给每个字段的参数,用于应用一些约束或赋予特定字段以特定的特征。例如,给CharField添加一个参数null = True将使它在关系型数据库中为该表存储空值。
下面是CharField可以使用的字段选项和属性。
字段选项 | 描述 |
---|---|
Null | 如果为真,Django将在数据库中把空值存储为NULL。默认为假。 |
Blank | 如果为真,该字段允许为空白。默认为 “假”。 |
db_column | 这个字段要使用的数据库列的名称。如果没有给出,Django将使用该字段的名称。 |
db_index | 如果为真,将为该字段创建一个数据库索引。 |
db_tablespace | 如果这个字段有索引的话,这个字段的索引要使用的数据库表空间的名称。默认是项目的DEFAULT_INDEX_TABLESPACE设置(如果设置了),或者模型的db_tablespace(如果有)。如果后端不支持索引的表空间,这个选项会被忽略。 |
Default | 该字段的默认值。这可以是一个值或一个可调用对象。如果是可调用的,它将在每次创建新对象时被调用。 |
help_text | 额外的 “帮助 “文本将显示在表单部件上。即使你的字段不在表单中使用,它对文档也很有用。 |
primary_key | 如果为真,这个字段就是模型的主键。 |
editable | 如果是假的,该字段将不会显示在管理员或任何其他 ModelForm 中。它们也会在模型验证过程中被跳过。默认为True。 |
error_messages | error_messages参数让你覆盖字段将产生的默认信息。传入一个字典,其键值与你想覆盖的错误信息相匹配。 |
help_text | 额外的 “帮助 “文本将显示在表单部件上。即使你的字段不在表单中使用,它对文档也很有用。 |
verbose_name | 该字段的一个人类可读的名字。如果没有给出verbose名称,Django会使用字段的属性名称自动创建它,并将下划线转换为空格。 |
validators | 对这个字段要运行的验证器列表。更多信息请参见验证器文档。 |
Unique | 如果为真,这个字段在整个表中必须是唯一的。 |