第一部分：模型--Models

0x01 说明

　　本文主要是记录笔记方便自己查看，以Django框架官方文档为例，创建一个基本的投票应用。

　　一个基本的投票应用，它包含两部分：
    　　　　一个公开的网站，可以让访客查看投票的结果并让他们进行投票。
   　　 　　一个后台管理网站，你可以添加、修改和删除选票。

0x02 创建项目

$ django-admin startproject mysite

 会当前目录下生成一个 mysite 目录，目录树结构如下；也可以通过IDE等软件创建

• 外层的mysite/根目录仅仅是项目的一个容器。它的命名对Django无关紧要；你可以把它重新命名为任何你喜欢的名字。

• manage.py：一个命令行工具，可以使你用多种方式对Django项目进行交互。

• 内层的mysite/目录是你的项目的真正的Python包。它是你导入任何东西时将需要使用的Python包的名字（例如 mysite.urls）。

• mysite/__init__.py：一个空文件，它告诉Python这个目录应该被看做一个Python包。 

• mysite/settings.py：该Django 项目的设置/配置。

• mysite/urls.py：该Django项目的URL声明；你的Django站点的“目录”。 起到路由转发作用
  

• mysite/wsgi.py：用于你的项目的与WSGI兼容的Web服务器入口。

0x03 数据建立

　　编辑mysite/settings.py文件，并在 DATABASES 'default'条目中修改以下的配置以匹配你的数据库连接的设置：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME':'test',  #数据库的名称
        'USER': 'root',
        'PASSWORD': '',
        'HOST': '192.168.2.203',
        'PORT': '3306',
    }
}

    ENGINE – 'django.db.backends.sqlite3', 'django.db.backends.postgresql_psycopg2', 'django.db.backends.mysql'或'django.db.backends.oracle'。其它的后台也可以支持。
    NAME –  数据库的名称。如果你使用SQLite，数据库将是你计算机上的一个文件； 如果是这样的话，NAME应该是这个文件的绝对路径，包括文件名。默认值是os.path.join(BASE_DIR, 'db.sqlite3')，它将文件保存在你项目的目录中。

　当你编辑mysite/settings.py时，请设置TIME_ZONE为你自己的时区。
　另外，请注意文件顶端的INSTALLED_APPS设置。它保存这个Django实例中激活的所有的Django应用的名字。 应用可以在多个项目中使用，而且你可以将这些应用打包和分发给其他人在他们的项目中使用。
　默认情况下，INSTALLED_APPS包含下面的应用，它们都是Django 与生俱来的：

• django.contrib.admin —— 管理站点。
• django.contrib.auth —— 认证系统。
• django.contrib.contenttypes —— 用于内容类型的框架。
• django.contrib.sessions —— 会话框架。
• django.contrib.messages —— 消息框架。
• django.contrib.staticfiles —— 管理静态文件的框架。

$ python manage.py migrate

 该命令将创建相应的django数据库表

0x04 运行该WEB

$ python manage.py runserver [port]
$ python manage.py runserver 0.0.0.0:8000

 0x05 创建应用和模型

项目与应用的关系：一个项目可以包含多个应用。一个应用可以运用到多个项目中去

要创建您的应用程序，请确保您与manage.py在同一目录中（项目的目录），并键入以下命令：

$ python manage.py startapp polls

 

在这个简单的投票应用中，我们将创建两个模型： Question和Choice。Question对象具有一个question_text（问题）属性和一个publish_date（发布时间）属性。 Choice有两个字段：选择的内容和选择的得票统计。 每个Choice与一个Question关联

编辑polls/models.py文件：

from django.db import models

class Question(models.Model):
    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

class Choice(models.Model):
    question = models.ForeignKey(Question)    #外键，定义多对一关系
    choice_text = models.CharField(max_length=200)
    votes = models.IntegerField(default=0)

更多字段：

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
　　对于参数，auto_now =True则每次更新都会更新这个时间；auto_now_add 则只是第一次创建添加，之后的更新不再改变。
6、models.DateTimeField　　日期类型 datetime
　　同DateField的参数
7、models.Decimal　　十进制小数类型= decimal
　　必须指定整数位max_digits和小数位decimal_places
8、models.EmailField　　字符串类型（正则表达式邮箱）=varchar
　　对字符串进行正则表达式
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.IPAddressField　　字符串类型（ip4正则表达式）
13、models.GenericIPAddressField　　字符串类型（ip4和ip6是可选的）
　　参数protocol可以是：both、ipv4、ipv6
　　验证时，会根据设置报错
14、models.NullBooleanField　　允许为空的布尔类型
15、models.PositiveIntegerFiel　　正Integer
16、models.PositiveSmallIntegerField　　正smallInteger
17、models.SlugField　　减号、下划线、字母、数字
18、models.SmallIntegerField　　数字
　　数据库中的字段有：tinyint、smallint、int、bigint
19、models.TextField　　字符串=longtext
20、models.TimeField　　时间 HH:MM[:ss[.uuuuuu]]
21、models.URLField　　字符串，地址正则表达式
22、models.BinaryField　　二进制
23、models.ImageField图片
24、models.FilePathField文件

 更多参数：

1、null=True
　　数据库中字段是否可以为空
2、blank=True
　　django的Admin中添加数据时是否可允许空值
3、primary_key =False
　　主键，对AutoField设置主键后，就会代替原来的自增 id 列
4、auto_now 和 auto_now_add
　　auto_now 自动创建---无论添加或修改，都是当前操作的时间
　　auto_now_add 自动创建---永远是创建时的时间
5、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、name|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

0x06 激活模型

再次编辑mysite/settings.py文件，并修改INSTALLED_APPS设置以包含字符串'polls'，安装名为：polls 的应用

运行命令：

$ python manage.py makemigrations [polls]
#通过运行makemigrations告诉Django，已经对模型做了一些更改,将更改记录为迁移文件。

python manage.py migrate    #将这些改变更新到数据库中

 另外，<Question: Question object>对于这个对象是一个完全没有意义的表示。 让我们来修复这个问题，编辑Question模型（在polls/models.py文件中）并添加一个__str__()方法给Question和Choice：

from django.db import models

class Question(models.Model):
    # ...
    def __str__(self):              # __unicode__ on Python 2
        return self.question_text

class Choice(models.Model):
    # ...
    def __str__(self):              # __unicode__ on Python 2
        return self.choice_text