Go語言學習教程：xorm表基本操作及高級操作

在上節內容中，我們介紹了xorm框架表結構的映射規則和表結構的操作。本節課，繼續來深入學習表結構基本操作和高級查詢的相關功能。

表結構基本操作

對表結構的操作最常見的操作是查詢和統計相關的方法，我們首先來看相關實現：

• 條件查詢

  • Id值查詢：參數接收主鍵字段的值。例如：

    var user User
    engine.Id(1).Get(&user)

    以上Id方法的使用，相當於如下sql語句：

  select * from user where id = 1

  如果數據庫表結構是復合主鍵，則在使用Id時進行主鍵分別指定，比如以下案例：

  engine.Id(core.PK(1,"davie").Get(&user)

  以上該句代碼表示的即是查詢多個復合主鍵的情況,core.PK中傳入的參數順序應該與結構體定義中的主鍵順序一致，否則匹配會出錯。對應的sql語句如下：

  select * from user where id = 1 and name = 'davie'

  • Where條件查詢 Where條件查詢與Sql語句中的where條件查詢功能一致。我們通過案例來查看Where的使用方法，如下所示：

  engine.Where(" user_name = ? and pwd = ? ", 'davie', '123').Get(&admin)

  如上xorm引擎操作即是如下sql語句的功能：

  select * from admin where user_name = 'davie' and pwd = '123'

  • And條件查詢 And條件查詢功能與Where語句的使用方式類似相同，作為並列條件和約束條件進行結果查詢。使用方式如下：

  engine.Id(1).And(" user_name = ?",'davie").Get(&user)

  以上的And方法並列查詢就相當於如下的sql語句：

  select * from user where id = 1 and user_name = 'davie' 

  • Or條件查詢 Or條件查詢的意思是或者的意思，與編程語言中的 “ || ”功能相同，在查詢時，如果有多個條件使用了Or語句，則對於同一條數據而言，只要符合其中一個條件，就會被查詢出來。具體的使用方法和對應的sql語句如下：

  engine.Id(1).Or("user_name = ?",'davie').Get(&user)

  如上的Or操作語句對應如下sql語句：

  select * from user where id = 1 or user_name = davie

  • Sql條件查詢 除了上述Id、Where、And、Or等方法的使用外，xorm同樣支持執行原生的sql語句，方便更願意使用原生SQL語句的開發者。

  engine.SQL(" select * from user where id = 1 nad user_name = 'davie')

  • 排序條件查詢 在數據庫查詢時，會涉及到查詢結果的排序問題。常規操作支持兩種排序：正排序和逆排序。 在xorm中的實現與sql語句中的兩種排序方式基本相同，分別定義為Asc方法和Desc方法。或者使用OrderBy方法對自定義的排序的字段進行指定。 注意：上述三個方法的參數都是string類型，用於指定表格字段。

  • In多值范圍查詢 In方法的多值范圍查詢，是用於某個字段中的條件查詢，該方法需要兩個參數：第一個參數為指定查詢的字段，第二個參數為字段多取值內容。我們同樣給出如下案例：

  engine.In('user_name','davie','pony','jack').Find()

  • Cols特定字段查詢 Cols方法可以接受一個或者多個特點的表字段名稱，用來表示限定於操作特定的表字段。依然通過案例來說明：

      engine.Cols("user_name","status").Find(&admins)
     //select user_name, status from admin

    上述Cols操作表示的sql語句就是注釋所對應的sql語句，表示從admin表中，查詢特定的user_name, status兩個字段，並將查詢后的集合進行返回。

      engine.Cols("user_name","status").Update(&admin)
     //update admin set user_name = admin.User_name and status = admin.Status

    我們可以看到，除了Find方法外，還可以調用Update方法，這里即表示更新表結構中的某條數據，且僅僅對該條數據的user_name和status兩個字段進行更新，這正是由Cols方法的參數限定的。

  • AllCols操作所有字段 除了上述的Cols指定一個或者多個字段以外，還可以通過AllCols方法來操作表所有字段，用法與Cols使用方法一致，我們不再贅述。

  • MustCols操作限定字段 MustCols意為操作必須對某些字段起作用，該方法的使用和Update方法相結合的情況較多。

增刪改查操作

說了這么多條件查詢的內容，我們還沒有介紹基本的表記錄的增刪改查操作呢。如下我們一一進行介紹：

• 增加記錄操作 增加一條記錄可以使用Insert方法完成。該方法接收一個參數，用於傳入實際我們要保存的數據對象的結構體對象類型。如下所示：

  var user
  ...
  engine.Insert(&user)

• Delete刪除記錄操作 刪除數據使用Delete方法來進行操作，但是我們在刪除的時候要知道刪除具體哪一條數據，因此在Delete操作前，需要使用我們之前講過的Id操作將數據進行定位查找出來，我們舉例如下：

    user := new(User)
   count,err := engine.Id(id).Delete(user)

  第一個返回值count表示刪除的記錄數，第二個參數為錯誤返回值，當刪除失敗時，err不為nil。

• Update修改記錄操作 我們已經講過MustCols的操作是用來限定必須影響某些表字段的操作的；這里再次我們強調，我們通常和Update操作放在一起來修改數據，作數據的更新操作。

    admin := new(Admin)
   admin.Status = "1"
   count,err := engine.Id(id).Update(user)

  以上的Update方法是用來更新全部的數據記錄，如果是限定更新某個或者某幾個字段，可以和Cols結合使用。

• 查詢記錄操作

  查詢方法有兩個，分為查詢單條數據和查詢多條數據。單條數據的查詢使用Get方法、多條數據的查詢使用Find方法。

Count表結構統計功能

在進行表數據查詢時，我們時長需要統計數據的條數，比如數據一共多少條，用來做分頁處理；再比如統計用戶數量，也需要使用到計數功能。框架提供給我們Count方法來實現數據統計功能，如下是一個簡單的案例：

admin := new(Admin)
count,err := engine.Count(admin)

事務處理

同其他數據庫框架一樣，xorm也是支持事物操作的。在有需要的批量操作數據時，事務的使用往往是必要的。在xorm中，事務操作和Session聯系在一起。一共三個步驟，分別為：創建session對象，Begin表示事務開始執行，Commit表示提交事務。中間為具體的數據庫操作。

創建事務

session := engine.NewSession()
defer session.Close()

事務開始

err := session.Begin()
//事務相關操作

事務提交

err = session.Commit()
if err != nil{
   panic(err.Error())
}

事務回滾

當在執行事務過程中遇到任何錯誤時，應該及時停止事務，將已經執行的進行回滾。回滾使用的方法是Rollback方法, 只是在執行出現錯誤時進行回滾操作。

...
if err != nil {
   session.Rollback()
   return 
}

中間的事務相關操作，與我們的正常的數據庫操作相同，支持開發者根據自己需求進行多種操作。比如插入數據和更改輸入：

• 事務插入數據

  admin := Admin{Name: "Davie", Status: "1"}
  _, err = session.Insert(&admin)

• 事務修改數據

  admin := Admin{ Name:"Davie"}
  count,err := session.Id(2).Update(&admin)
  if err != nil {
     seesion.Rollback()
     return
  }