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	如果为真，这个字段在整个表中必须是唯一的。