7.1 ORM簡介

MVC或者MVC框架中包括一個重要的部分，就是ORM，它實現了數據模型與數據庫的解耦，即數據模型的設計不需要依賴於特定的數據庫，通過簡單的配置就可以輕松更換數據庫，這極大的減輕了開發人員的工作量，不需要面對因數據庫變更而導致的無效勞動
ORM是“對象-關系-映射”的簡稱。

圖重 birthday DATA 改成DATE，後期會修改圖片內容

#sql中的表                                                      

 #創建表:
     CREATE TABLE employee(                                     
                id INT PRIMARY KEY auto_increment ,                    
                name VARCHAR (20),                                      
                gender BIT default 1,                                  
                birthday DATA ,                                         
                department VARCHAR (20),                                
                salary DECIMAL (8,2) unsigned,                          
              );

  #sql中的表紀錄                                                  
  #添加一條表紀錄:                                                          
      INSERT employee (name,gender,birthday,salary,department)            
             VALUES   ("alex",1,"1985-12-12",8000,"保潔部");               
  #查詢一條表紀錄:                                                           
      SELECT * FROM employee WHERE age=24;                               
  #更新一條表紀錄:                                                           
      UPDATE employee SET birthday="1989-10-24" WHERE id=1;              
  #刪除一條表紀錄:                                                          
      DELETE FROM employee WHERE name="alex"                             
#python的類
class Employee(models.Model):
     id=models.AutoField(primary_key=True)
     name=models.CharField(max_length=32)
     gender=models.BooleanField()
     birthday=models.DateField()
     department=models.CharField(max_length=32)
     salary=models.DecimalField(max_digits=8,decimal_places=2)
 #python的類對象
      #添加一條表紀錄:
          emp=Employee(name="alex",gender=True,birthday="1985-12-12",epartment="保潔部")
          emp.save()
      #查詢一條表紀錄:
          Employee.objects.filter(age=24)
      #更新一條表紀錄:
          Employee.objects.filter(id=1).update(birthday="1989-10-24")
      #刪除一條表紀錄:
          Employee.objects.filter(name="alex").delete()
 

7.2 單表操作

1 創建模型

創建名為book的app，在book下的models.py中創建模型：

from django.db import models
# Create your models here.

class Book(models.Model):
     id=models.AutoField(primary_key=True)
     title=models.CharField(max_length=32)
     state=models.BooleanField()
     pub_date=models.DateField()
     price=models.DecimalField(max_digits=8,decimal_places=2)
     publish=models.CharField(max_length=32)
 

2 更多字段和參數
每個字段有一些特有的參數，例如，CharField需要max_length參數來指定VARCHAR數據庫字段的大小。還有一些適用於所有字段的通用參數。 這些參數在文檔中有詳細定義，這裏我們只簡單介紹一些最常用的：

更多字段：

<1> CharField
       字符串字段, 用於較短的字符串.
       CharField 要求必須有一個參數 maxlength, 用於從數據庫層和Django校驗層限制該字段所允許的最大字符數.

<2> IntegerField
      #用於保存一個整數.

<3> FloatField
       一個浮點數. 必須 提供兩個參數:

       參數    描述
       max_digits    總位數(不包括小數點和符號)
       decimal_places    小數位數
               舉例來說, 要保存最大值為 999 (小數點後保存2位),你要這樣定義字段:

               models.FloatField(..., max_digits=5, decimal_places=2)
               要保存最大值一百萬(小數點後保存10位)的話,你要這樣定義:

               models.FloatField(..., max_digits=19, decimal_places=10)
               admin 用一個文本框(<input type="text">)表示該字段保存的數據.

<4> AutoField
       一個 IntegerField, 添加記錄時它會自動增長. 你通常不需要直接使用這個字段;
       自定義一個主鍵：my_id=models.AutoField(primary_key=True)
       如果你不指定主鍵的話,系統會自動添加一個主鍵字段到你的 model.

<5> BooleanField
       A true/false field. admin 用 checkbox 來表示此類字段.

<6> TextField
       一個容量很大的文本字段.
       admin 用一個 <textarea> (文本區域)表示該字段數據.(一個多行編輯框).

<7> EmailField
       一個帶有檢查Email合法性的 CharField,不接受 maxlength 參數.

<8> DateField
       一個日期字段. 共有下列額外的可選參數:
       Argument    描述
       auto_now    當對象被保存時,自動將該字段的值設置為當前時間.通常用於表示 "last-modified" 時間戳.
       auto_now_add    當對象首次被創建時,自動將該字段的值設置為當前時間.通常用於表示對象創建時間.
       （僅僅在admin中有意義...)

<9> DateTimeField
        一個日期時間字段. 類似 DateField 支持同樣的附加選項.

<10> ImageField
       類似 FileField, 不過要校驗上傳對象是否是一個合法圖片.#它有兩個可選參數:height_field和width_field,
       如果提供這兩個參數,則圖片將按提供的高度和寬度規格保存.    
<11> FileField
    一個文件上傳字段.
    要求一個必須有的參數: upload_to, 一個用於保存上載文件的本地文件系統路徑. 這個路徑必須包含 strftime #formatting,
    該格式將被上載文件的 date/time
    替換(so that uploaded files don‘t fill up the given directory).
    admin 用一個<input type="file">部件表示該字段保存的數據(一個文件上傳部件) .

    註意：在一個 model 中使用 FileField 或 ImageField 需要以下步驟:
           （1）在你的 settings 文件中, 定義一個完整路徑給 MEDIA_ROOT 以便讓 Django在此處保存上傳文件.
           (出於性能考慮,這些文件並不保存到數據庫.) 定義MEDIA_URL 作為該目錄的公共 URL. 要確保該目錄對
            WEB服務器用戶帳號是可寫的.
           （2） 在你的 model 中添加 FileField 或 ImageField, 並確保定義了 upload_to 選項,以告訴 Django
            使用 MEDIA_ROOT 的哪個子目錄保存上傳文件.你的數據庫中要保存的只是文件的路徑(相對於 MEDIA_ROOT).
            出於習慣你一定很想使用 Django 提供的 get_<#fieldname>_url 函數.舉例來說,如果你的 ImageField
            叫作 mug_shot, 你就可以在模板中以 {{ object.#get_mug_shot_url }} 這樣的方式得到圖像的絕對路徑.

<12> URLField
     用於保存 URL. 若 verify_exists 參數為 True (默認), 給定的 URL 會預先檢查是否存在( 即URL是否被有效裝入且
     沒有返回404響應).
     admin 用一個 <input type="text"> 文本框表示該字段保存的數據(一個單行編輯框)

<13> NullBooleanField
      類似 BooleanField, 不過允許 NULL 作為其中一個選項. 推薦使用這個字段而不要用 BooleanField 加 null=True 選項
      admin 用一個選擇框 <select> (三個可選擇的值: "Unknown", "Yes" 和 "No" ) 來表示這種字段數據.

<14> SlugField
      "Slug" 是一個報紙術語. slug 是某個東西的小小標記(短簽), 只包含字母,數字,下劃線和連字符.#它們通常用於URLs
      若你使用 Django 開發版本,你可以指定 maxlength. 若 maxlength 未指定, Django 會使用默認長度: 50.  #在
      以前的 Django 版本,沒有任何辦法改變50 這個長度.
      這暗示了 db_index=True.
      它接受一個額外的參數: prepopulate_from, which is a list of fields from which to auto-#populate
      the slug, via JavaScript,in the object‘s admin form: models.SlugField
      (prepopulate_from=("pre_name", "name"))prepopulate_from 不接受 DateTimeFields.

<13> XMLField
       一個校驗值是否為合法XML的 TextField,必須提供參數: schema_path, 它是一個用來校驗文本的 RelaxNG schema #的文件系統路徑.

<14> FilePathField
       可選項目為某個特定目錄下的文件名. 支持三個特殊的參數, 其中第一個是必須提供的.
       參數    描述
       path    必需參數. 一個目錄的絕對文件系統路徑. FilePathField 據此得到可選項目.
       Example: "/home/images".
       match    可選參數. 一個正則表達式, 作為一個字符串, FilePathField 將使用它過濾文件名.
       註意這個正則表達式只會應用到 base filename 而不是
       路徑全名. Example: "foo.*\.txt^", 將匹配文件 foo23.txt 卻不匹配 bar.txt 或 foo23.gif.
       recursive可選參數.要麽 True 要麽 False. 默認值是 False. 是否包括 path 下面的全部子目錄.
       這三個參數可以同時使用.
       match 僅應用於 base filename, 而不是路徑全名. 那麽,這個例子:
       FilePathField(path="/home/images", match="foo.*", recursive=True)
       ...會匹配 /home/images/foo.gif 而不匹配 /home/images/foo/bar.gif

<15> IPAddressField
       一個字符串形式的 IP 地址, (i.e. "24.124.1.30").
<16> CommaSeparatedIntegerField
       用於存放逗號分隔的整數值. 類似 CharField, 必須要有maxlength參數.
 

更多參數：

(1)null

如果為True，Django 將用NULL 來在數據庫中存儲空值。 默認值是 False.

(1)blank

如果為True，該字段允許不填。默認為False。
要註意，這與 null 不同。null純粹是數據庫範疇的，而 blank 是數據驗證範疇的。
如果一個字段的blank=True，表單的驗證將允許該字段是空值。如果字段的blank=False，該字段就是必填的。

(2)default

字段的默認值。可以是一個值或者可調用對象。如果可調用 ，每有新對象被創建它都會被調用。

(3)primary_key

如果為True，那麽這個字段就是模型的主鍵。如果你沒有指定任何一個字段的primary_key=True，
Django 就會自動添加一個IntegerField字段做為主鍵，所以除非你想覆蓋默認的主鍵行為，
否則沒必要設置任何一個字段的primary_key=True。

(4)unique

如果該值設置為 True, 這個數據字段的值在整張表中必須是唯一的

(5)choices
由二元組組成的一個可叠代對象（例如，列表或元組），用來給字段提供選擇項。 如果設置了choices ，默認的表單將是一個選擇框而不是標準的文本框，<br>而且這個選擇框的選項就是choices 中的選項。

3 settings配置

若想將模型轉為mysql數據庫中的表，需要在settings中配置：

DATABASES = {
    ‘default‘: {
        ‘ENGINE‘: ‘django.db.backends.mysql‘,
        ‘NAME‘:‘bms‘,     　　 　  # 要連接的數據庫，連接前需要創建好
        ‘USER‘:‘root‘,　　　　　　  # 連接數據庫的用戶名
        ‘PASSWORD‘:‘‘,　　　　　　  # 連接數據庫的密碼
        ‘HOST‘:‘127.0.0.1‘,       # 連接主機，默認本級
        ‘PORT‘：3306    　　　     #  端口 默認3306
    }
}

註意1：NAME即數據庫的名字，在mysql連接前該數據庫必須已經創建，而上面的sqlite數據庫下的db.sqlite3則是項目自動創建 USER和PASSWORD分別是數據庫的用戶名和密碼。設置完後，再啟動我們的Django項目前，我們需要激活我們的mysql。然後，啟動項目，會報錯：no module named MySQLdb 。這是因為django默認你導入的驅動是MySQLdb，可是MySQLdb 對於py3有很大問題，所以我們需要的驅動是PyMySQL 所以，我們只需要找到項目名文件下的init,在裏面寫入：

import pymysql
pymysql.install_as_MySQLdb()

最後通過兩條數據庫遷移命令即可在指定的數據庫中創建表 ：

python manage.py makemigrations
python manage.py migrate

註意2:確保配置文件中的INSTALLED_APPS中寫入我們創建的app名稱

INSTALLED_APPS = [
    ‘django.contrib.admin‘,
    ‘django.contrib.auth‘,
    ‘django.contrib.contenttypes‘,
    ‘django.contrib.sessions‘,
    ‘django.contrib.messages‘,
    ‘django.contrib.staticfiles‘,
    "book"
]

註意3:如果報錯如下：

django.core.exceptions.ImproperlyConfigured: mysqlclient 1.3.3 or newer is required; you have 0.7.11.None

MySQLclient目前只支持到python3.4，因此如果使用的更高版本的python，需要修改如下：

通過查找路徑C:\Programs\Python\Python36-32\Lib\site-packages\Django-2.0-py3.6.egg\django\db\backends\mysql 這個路徑裏的文件把

if version < (1, 3, 3):
     raise ImproperlyConfigured("mysqlclient 1.3.3 or newer is required; you have %s" % Database.__version__)

註釋掉 就OK了。
註意4: 如果想打印orm轉換過程中的sql，需要在settings中進行如下配置：

LOGGING = {
    ‘version‘: 1,
    ‘disable_existing_loggers‘: False,
    ‘handlers‘: {
        ‘console‘:{
            ‘level‘:‘DEBUG‘,
            ‘class‘:‘logging.StreamHandler‘,
        },
    },
    ‘loggers‘: {
        ‘django.db.backends‘: {
            ‘handlers‘: [‘console‘],
            ‘propagate‘: True,
            ‘level‘:‘DEBUG‘,
        },
    }
}

一、添加表紀錄

方式1

# create方法的返回值book_obj就是插入book表中的python葵花寶典這本書籍紀錄對象
  book_obj=Book.objects.create(title="python葵花寶典",state=True,price=100,publish="蘋果出版社",pub_date="2012-12-12")

方式2

book_obj=Book(title="python葵花寶典",state=True,price=100,publish="蘋果出版社",pub_date="2012-12-12")
book_obj.save()

二、查詢表紀錄

查詢API

<1> all():                  查詢所有結果

<2> filter(**kwargs):       它包含了與所給篩選條件相匹配的對象

<3> get(**kwargs):          返回與所給篩選條件相匹配的對象，返回結果有且只有一個，
                            如果符合篩選條件的對象超過一個或者沒有都會拋出錯誤。

<4> exclude(**kwargs):      它包含了與所給篩選條件不匹配的對象

<5> order_by(*field):       對查詢結果排序

<6> reverse():              對查詢結果反向排序

<8> count():                返回數據庫中匹配查詢(QuerySet)的對象數量。

<9> first():                返回第一條記錄

<10> last():                返回最後一條記錄

<11> exists():              如果QuerySet包含數據，就返回True，否則返回False

<12> values(*field):        返回一個ValueQuerySet——一個特殊的QuerySet，運行後得到的並不是一系列
                            model的實例化對象，而是一個可叠代的字典序列
<13> values_list(*field):   它與values()非常相似，它返回的是一個元組序列，values返回的是一個字典序列

<14> distinct():            從返回結果中剔除重復紀錄

基於雙下劃線的模糊查詢

Book.objects.filter(price__in=[100,200,300])
Book.objects.filter(price__gt=100)
Book.objects.filter(price__lt=100)
Book.objects.filter(price__range=[100,200])
Book.objects.filter(title__contains="python")
Book.objects.filter(title__icontains="python")
Book.objects.filter(title__startswith="py")
Book.objects.filter(pub_date__year=2012)

三、刪除表紀錄

刪除方法就是 delete()。它運行時立即刪除對象而不返回任何值。例如：

model_obj.delete()

你也可以一次性刪除多個對象。每個 QuerySet 都有一個 delete() 方法，它一次性刪除 QuerySet 中所有的對象。
例如，下面的代碼將刪除 pub_date 是2005年的 Entry 對象：

    Entry.objects.filter(pub_date__year=2005).delete()

在 Django 刪除對象時，會模仿 SQL 約束 ON DELETE CASCADE 的行為，換句話說，刪除一個對象時也會刪除與它相關聯的外鍵對象。例如：

b = Blog.objects.get(pk=1)
# This will delete the Blog and all of its Entry objects.
b.delete()

要註意的是： delete() 方法是 QuerySet 上的方法，但並不適用於 Manager 本身。這是一種保護機制，是為了避免意外地調用 Entry.objects.delete() 方法導致 所有的 記錄被誤刪除。如果你確認要刪除所有的對象，那麽你必須顯式地調用：

Entry.objects.all().delete()

如果不想級聯刪除，可以設置為:

pubHouse = models.ForeignKey(to=‘Publisher‘, on_delete=models.SET_NULL, blank=True, null=True)

四、修改表紀錄

Book.objects.filter(title__startswith="py").update(price=120)

此外，update()方法對於任何結果集（QuerySet）均有效，這意味著你可以同時更新多條記錄update()方法會返回一個整型數值，表示受影響的記錄條數。　　

五 、章節作業

1 圖書管理系統 實現功能：book單表的增刪改查 2 查詢操作練習

1 查詢老男孩出版社出版過的價格大於200的書籍
2 查詢2017年8月出版的所有以py開頭的書籍名稱
3 查詢價格為50,100或者150的所有書籍名稱及其出版社名稱
4 查詢價格在100到200之間的所有書籍名稱及其價格
5 查詢所有人民出版社出版的書籍的價格（從高到低排序，去重）

Django-05模型層之單表操作