Django学习笔记第十二篇--关于自定义数据库字段数据类型

Django学习笔记第十二篇--关于自定义数据库字段数据类型

一、需求背景:

django的models模块提供了很多数据字段的数据类型field,但是总有写奇葩需求不能依靠默认字段满足,所以需要自定义数据数据库数据字段类型。所有的自定义field应该在app路径下的fields.py文件里面定义。

二、自定义数据库数据类型字段:

1、知识点1->继承自filed类型

所以所有自定义类型都应该如下编写:

1 from django.db import models
2 
3 class myfiled(models.Filed):
4     pass

第一行引入继承的父类所在的models模块,然后定义自定义field类型,定义时候继承models.field类。

2、可以创建一个描述变量

1 from django.db import models
2 
3 class myfield(models.Field):
4     description = "This is my own field!"

3、初始化实例的构造函数

1 class myfield(models.Field):
2     def __init__(self,*args,**kwargs):
3         kwargs['max_length'] = 100
4         super(myfield,self).__init__(*args,**kwargs) 

这个函数可以不显性定义

4、对于1.7之前版本的django的自定义field迁移到1.7以及之后的版本,需要自定义deconsturct函数,但这里不在本文的介绍访问之内。

5、实现db_type方法,作用是返回其本身说属于的数据库中的字段数据类型,例如你自定义了一个时间类型,那么对应在MySQL中就是datetime类型。

1 def db_type(self,connection):
2     
3     if connection.settings_dict['ENGINE'] == 'django.db.backends.mysql':
4         return 'datetime'
5     else:
6         return 'timestamp'

这里的connection.setting_dict是一个保存着连接配置的字典数据结构,其中ENGINE表示的是数据库类型,django.db.backends.mysql就是mysql,其实,这里就相当于定义了你自定义数据字段类型说依赖的数据库数据字段类型,如果对长度要限制,则可以在实例化出事函数中,传入max_length值给属性,self.max_length属性,然后,在db_type里面初始化,完成动态构造。

1 class myfield(models.Field):
2     def __init__(self,max_length,*args,**kwargs):
3         self.max_length = max_length
4         super(myfield,self).__init__(*args,**kwargs)
5     def db_type(self):
6         return 'int(%s)'%self.max_length

6、如果需要自定义某个column,最好还是去数据库中使用sql语句创建或其他方式,请在db_type函数中返回None,通知migerate创建数据库表的时候跳过这个字段,因为migerate就是利用这个返回值来创建数据库表的。当然有些时候也可以使用另外一个函数:get_internal_type

1 def get_internal_type(self):
2     return 'CharField'

7、增删改查时候需要用到的几个API:

(1)将值转换为python对象:

这里有两个api需要实现from_db_value()和to_python()

引用官方文档中的一段内容来解释一下:

to_python()

from_db_value()

clean()方法调用。

to_python()应优雅地处理以下任何参数:

  • 正确类型的实例
  • 字符串
  • null=True

尤其请注意to_python通过反序列化和表单中的clean方法调用,这个要注意反序列化的问题,python的反序列化是一个比较严重的安全问题。

所以一般的这两个函数一般的定义范式:

 1 def from_db_value(self,value,expression,connection,content):
 2       if value is None:
 3           return value
 4       try:
 5           return field_function(value)
 6       except Exception:
 7           return value
 8 
 9 def to_python(self,value):
10       if value is None or isinstance(value,xxxx):
11           return value
12       try:
13           return field_function(value)
14       except Exception:
15           return value

当然field_function是对value的处理函数,需要自己定义。

(2)将python对象转换为查询值:

当重写to_python的时候,必须重写get_prep_value函数,基本上是field_function函数的逆向操作

1 def get_prep_value(self,value):
2     return do_something(value)

(3)将查询值转换为数据库值:

也就是类似像这一类操作的转换过程(p.s.日期存在数据库中是unix时间戳,后台处理是2018-01-01 11:07:23.123),都写在get_db_prep_value函数中

1 def get_db_prep_value(self, value, connection, prepared=False):
2     return do_something(value)

(4)此外还有很多API方法,详情请参考http://python.usyiyi.cn/documents/django_182/ref/models/fields.html

8、与表单相关可以覆盖重写formfield,此处不再展开。

9、关于序列化,这里要展开引一段官方文档:

HandField使用字符串作为其数据存储,我们可以重用一些现有的转换代码:

class HandField(models.Field):
    # ...

    def value_to_string(self, obj):
        value = self._get_val_from_obj(obj)
        return self.get_prep_value(value)

这里值得注意。