BinaryField – Django模型
BinaryField是一个特殊的字段用来存储原始二进制数据。它可以被分配为字节,字节数,或内存视图。默认情况下,BinaryField设置可编辑为False,也就是说它不能被包含在ModelForm中。由于BinaryField存储的是原始数据或者换句话说是一个Python对象,所以它不能被手动输入,需要通过视图或django shell来分配。这就是可编辑为False的意思,也就是它不能通过任何表单进行编辑。
语法
field_name = models.BinaryField(**options)
Django Model BinaryField解释
用一个例子说明BinaryField。考虑一个名为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.BinaryField()
在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.BinaryField()),
],
),
]
因此,当你在项目上运行makemigrations时,会创建一个geeks_field BigIntegerField.它是一个用于存储原始二进制数据的字段。
如何使用BinaryField
任何类型的数据都可以转换为字节,包括整数、字符串、图像等。让我们试着把一个字符串保存到二进制字段中。字符串可以通过通用字节函数转换为字节。这个函数在内部指向CPython库,该库隐含地调用encode函数,将字符串转换为指定的编码。
# importing the model
# from geeks app
from geeks.models import GeeksModel
# creating a string
test_string = "GFG is best"
# creating a bytes object
res = bytes(test_string, 'utf-8')
# creating a instance of
# GeeksModel
geek_object = GeeksModel.objects.create(geeks_field = res)
geek_object.save()
现在让我们在管理服务器中检查一下。我们已经创建了一个GeeksModel的实例
可能的错误
按照规定,BinaryField是一个不可编辑的字段,如果你手动尝试使用editable=True使其可编辑,将会产生意想不到的错误。它应该在一个函数中被创建,以便对象可以被分配到它。
字段选项
字段选项是给每个字段的参数,用于应用一些约束或赋予一个特定的字段以特定的特性。例如,在二进制字段中添加一个参数null = True将使它能够在关系数据库中为该表存储空值。
下面是一个二进制字段可以使用的选项和属性。
字段选项 | 描述 |
---|---|
Null | 如果为真,Django将在数据库中把空值存储为NULL。默认为假。 |
Blank | 如果为真,该字段允许为空白。默认为 “假”。 |
db_column | 这个字段要使用的数据库列的名称。如果没有给出,Django将使用该字段的名称。 |
Default | 该字段的默认值。这可以是一个值或一个可调用的对象。如果是可调用的,它将在每次创建新对象时被调用。 |
help_text | 额外的 “帮助 “文本将显示在表单部件上。即使你的字段不在表单中使用,它对文档也很有用。 |
primary_key | 如果为真,这个字段就是模型的主键。 |
editable | 如果是假的,该字段将不会显示在管理员或任何其他 ModelForm 中。它们也会在模型验证过程中被跳过。默认为True。 |
error_messages | error_messages参数让你覆盖字段将产生的默认信息。传入一个字典,其键值与你想覆盖的错误信息相匹配。 |
help_text | 额外的 “帮助 “文本将显示在表单部件上。即使你的字段不在表单中使用,它对文档也很有用。 |
verbose_name | 该字段的一个可读名称。如果没有给出verbose名称,Django会使用字段的属性名称自动创建它,并将下划线转换为空格。 |
validators | 对这个字段要运行的验证器列表。更多信息请参见验证器文档。 |
Unique | 如果为真,这个字段在整个表中必须是唯一的。 |