Django ORM常用的Field

一：django 模型models 常用字段

1：models.AutoField

   自增列 = int(11)
   如果没有的话，默认会生成一个名称为 id 的列
   如果要显式的自定义一个自增列，必须设置primary_key=True。

2：models.CharField

    字符串字段；必须设置max_length参数

3：models.BooleanField

   布尔类型=tinyint(1)；不能为空，可添加Blank=True

4：models.ComaSeparatedIntegerField

   用逗号分割的数字=varchar；继承CharField，所以必须 max_lenght 参数

5：models.DateField

   日期类型 date
　 DateField.auto_now：保存时自动设置该字段为现在日期，最后修改日期
   DateField.auto_now_add：当该对象第一次被创建是自动设置该字段为现在日期，创建日期。

6：models.DateTimeField

	日期时间类型 datetime；同DateField的参数

7：models.Decimal

   十进制小数类型 = decimal
   DecimalField.max_digits：数字中允许的最大位数
   DecimalField.decimal_places：存储的十进制位数

8：models.EmailField

	一个带有检查 Email 合法性的 CharField

9：models.FloatField

	浮点类型 = double

10：models.IntegerField

	整形

11：models.BigIntegerField

   长整形
　　integer_field_ranges = {
　　　　'SmallIntegerField': (-32768, 32767),
　　　　'IntegerField': (-2147483648, 2147483647),
　　　　'BigIntegerField': (-9223372036854775808, 9223372036854775807),
　　　　'PositiveSmallIntegerField': (0, 32767),
　　　　'PositiveIntegerField': (0, 2147483647),
　　}

12：models.GenericIPAddressField

	一个带有检查 IP地址合法性的 CharField

13：models.NullBooleanField

	允许为空的布尔类型

14：models.PositiveIntegerFiel

 	正整数

15：models.PositiveSmallIntegerField

	正smallInteger

16：models.SlugField

	减号、下划线、字母、数字

17：models.SmallIntegerField

	数字；数据库中的字段有：tinyint、smallint、int、bigint

18：models.TextField

	大文本。默认对应的form标签是textarea。

19：models.TimeField

	时间 HH:MM[:ss[.uuuuuu]]

20：models.URLField

	一个带有URL合法性校验的CharField

21：models.BinaryField

	二进制；存储二进制数据。不能使用filter函数获得QuerySet。

22：models.ImageField

   图片
   ImageField.height_field、ImageField.width_field：如果提供这两个参数，则图片将按提供的高度和宽度规格保存。
   该字段要求 Python Imaging 库Pillow。
   会检查上传的对象是否是一个合法图片。

23：models.FileField(upload_to=None[, max_length=100, ** options])

	文件
   FileField.upload_to：一个用于保存上传文件的本地文件系统路径，该路径由 MEDIA_ROOT 中设置
   这个字段不能设置primary_key和unique选项.在数据库中存储类型是varchar，默认最大长度为100

24：models.FilePathField(path=None[, math=None, recursive=False, max_length=100, **options])

   FilePathField.path：文件的绝对路径，必填
   FilePathField.match：用于过滤路径下文件名的正则表达式，该表达式将用在文件名上（不包括路径）。
   FilePathField.recursive：True 或 False，默认为 False，指定是否应包括所有子目录的路径。
   例如：FilePathField(path="/home/images", match="foo.*", recursive=True)
        将匹配“/home/images/foo.gif”但不匹配“/home/images/foo/bar.gif”  

二：django 模型models 字段常用参数

1、null

	如果是True，Django会在数据库中将此字段的值置为NULL，默认值是False

2、blank

	如果为True时django的 Admin 中添加数据时可允许空值，可以不填。如果为False则必须填。默认是False。
	null纯粹是与数据库有关系的。而blank是与页面必填项验证有关的

3、primary_key = False

	主键，对AutoField设置主键后，就会代替原来的自增 id 列

4、auto_now 和 auto_now_add

	auto_now   自动创建---无论添加或修改，都是当前操作的时间
	auto_now_add  自动创建---永远是创建时的时间

5、choices

	一个二维的元组被用作choices，如果这样定义，Django会select box代替普通的文本框，并且限定choices的值是元组中的值
  GENDER_CHOICE = (
        (u'M', u'Male'),
        (u'F', u'Female'),
  )
  gender = models.CharField(max_length=2,choices = GENDER_CHOICE)

6、max_length

	字段长度

7、default

	默认值

8、verbose_name

	Admin中字段的显示名称，如果不设置该参数时，则与属性名。

9、db_column

	数据库中的字段名称

10、unique=True

	不允许重复

11、db_index = True

	数据库索引

12、editable=True

	在Admin里是否可编辑

13、error_messages=None

	错误提示

14、auto_created=False

	自动创建

15、help_text

	在Admin中提示帮助信息

16、validators=[]

	验证器

17、upload-to

	文件上传时的保存上传文件的目录

三：使用UUID替代Django默认的id主键

首先安装UUID插件包：

pip install django-shortuuidfield

from django.contrib.auth.base_user import AbstractBaseUser, BaseUserManager
from django.contrib.auth.models import PermissionsMixin
from django.db import models
from shortuuidfield import ShortUUIDField

class UserManager(BaseUserManager):
    def _create_user(self, mobile, username, password, **kwargs):
        if not all([mobile, username, password]):
            raise ValueError('mobile, username, password all required')
        user = self.model(mobile=mobile, username=username, **kwargs)
        user.set_password(password)
        user.save()
        return user
    def create_user(self, mobile, username, password, **kwargs):
        kwargs['is_superuser'] = False
        return self._create_user(mobile, username, password, **kwargs)
    def create_superuser(self, mobile, username, password, **kwargs):
        kwargs['is_superuser'] = True
        kwargs['is_staff'] = True
        return self._create_user(mobile, username, password, **kwargs)

class UserProfile(AbstractBaseUser, PermissionsMixin):
    uid = ShortUUIDField(primary_key=True)
    mobile = models.CharField(max_length=11, unique=True)
    email = models.EmailField(unique=True)
    username = models.CharField(max_length=100)
    is_active = models.BooleanField(default=True)
    is_staff = models.BooleanField(default=False)
    date_joined = models.DateTimeField(auto_now_add=True)
    # USERNAME_FIELD：用户检验调用authenticate方法时默认使用的是username=username，下面指定了USERNAME_FIELD为mobile，即在检验时username = mobile
    USERNAME_FIELD = 'mobile'
    # REQUIRED_FIELDS：这里是创建createsuperuser时指定需要哪些字段，为空，说明需要上面的USERNAME_FIELD值与password字段
    # 下面指定了username字段，即在创建超级用户时需要指定mobile,username,password三个字段
    REQUIRED_FIELDS = ['username']
    objects = UserManager()

    def get_full_name(self):
        return self.username
    def get_short_name(self):
        return self.username