go xorm框架的使用

一、創建數據庫連接

xorm支持單引擎和多引擎,多引擎的場景對於初學者來說,沒有必要考慮,所以我們主要學習的是單引擎的數據庫連接,為瞭方便檢查SQL,需要啟用打印功能,默認不開啟

var engine *xorm.Engine

func main() {
	var err error
	engine, err = xorm.NewEngine("mysql", "root:123456@tcp(127.0.0.1:3306)/myschool?charset=utf8")
	if err != nil {
		log.Println(err)
	}
    // 控制臺打印出生成的SQL語句
	engine.ShowSQL(true)
}

二、操作mysql數據庫

查詢

建表語句

CREATE TABLE `student`  (
  `id` varchar(225) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,
  `name` varchar(225) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
  `age` int(11) NULL DEFAULT NULL,
  `gradeid` int(11) NULL DEFAULT NULL,
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;

CREATE TABLE `grade`  (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `gradename` varchar(20) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 3 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;

struct結構體

student.go

type Student struct {
	Id      string `orm:"id,primary" json:"id"`
	Name    string `orm:"name"       json:"name"`
	Age     int    `orm:"age"        json:"age"`
	Gradeid int    `orm:"gradeid"    json:"gradeid"`
}

grade.go

type Grade struct {
	Id        int    `orm:"id,primary" json:"id"`
	Gradename string `orm:"gradename"  json:"gradename"`
}

1、Get方法

Get方法用於獲取單條數據,如:

結合Where查詢 ,寫法很多,主要是剛入門,都可以嘗試一下。最終的實現都是一個意思

var stu student.Student
has, err := engine.Where("id=?", "1").Get(&stu)
  
stu := new(student.Student)
has, err := engine.Where("id=?", "1").Get(stu)
  
stu := student.Student{}
has, err := engine.Where("id=?", "1").Get(&stu)
  
stu := &student.Student{}
has, err := engine.Where("id=?", "1").Get(stu)
  
if err != nil {
  log.Println(err)
}
log.Println("是否存在:",has)
log.Println(stu)

結構體中已有的非空數據查詢

stu := &student.Student{Id:"1"}
has, err := engine.Get(stu)
if err != nil {
   log.Println(err)
}
log.Println("是否存在:",has)
log.Println(stu)

has返回一個boolean類型,表明數據是否存在,err接收如果在查詢中產生的錯誤

2、Exist方法

Exist方法用於判斷數據是否存在,Get方法是以id字段舉例,那麼現在就以name字段舉例

下面的寫法也很怪異,猜測著去寫,很多東西都可以拓展開,剛入門,看啥都很神奇,隨便舉幾個例子,後面慢慢的去嘗試

has, err := engine.Where("name=?", "少傑").Exist(&student.Student{})

has, err := engine.Table(&student.Student{}).Where("name=?", "少傑").Exist()

has, err := engine.Exist(&student.Student{Name: "少傑"})
if err != nil {
    log.Println(err)
}
log.Println("是否存在:", has)

3、Find方法

Find方法用於查詢多條數據 ,Find方法的第一個參數為slice的指針或Map指針,即為查詢後返回的結果,第二個參數可選,為查詢的條件struct的指針。

stu := make([]student.Student, 0)
// Cols 查詢指定字段
// Limit 分頁查詢 (顯示的條數,從第幾個開始)
err := engine.Where("id=?", "1").Cols("name").Limit(10, 0).Find(&stus)
if err != nil {
    log.Println(err)
}
log.Println("查詢到的信息:", stu)

查詢時可以加入各種條件,也可以不加。不加時err := engine.Find(&stus)查詢所有,如果隻選擇單個字段,也可使用非結構體的Slice

var strings []string
// Table 需要操作的表名稱
err := engine.Table("student").Cols("id").Find(&strings)
if err != nil {
    log.Println(err)
}
log.Println("查詢到的信息:",strings)

4、Join方法

第一個參數為連接類型,當前支持INNER, LEFT OUTER, CROSS中的一個值, 第二個參數為string類型的表名,表對應的結構體指針或者為兩個值的[]string,表示表名和別名, 第三個參數為關聯鍵。

每個學生隻在一個班級出現,所以對應的結構體應該加上xorm的index標記

type Student struct {
	Id      string `orm:"id,primary" json:"id"`
	Name    string `orm:"name"       json:"name"`
	Age     int    `orm:"age"        json:"age"`
	Gradeid int    `orm:"gradeid"    json:"gradeid" xorm:"index"`
}
type Grade struct {
	Id        int    `orm:"id,primary" json:"id"`
	Gradename string `orm:"gradename"  json:"gradename"`
}

如果我們想查詢出兩張表的具體數據,還需要借助xorm的extend關鍵字,類似於java中的vo,而extend關鍵字的用處就是讀取的數據引用到struct,結構體中extends標記對應的結構順序應和最終生成SQL中對應的表出現的順序相同。

type Student struct {
	modle.Student `xorm:"extends"`
	modle.Grade   `xorm:"extends"`
}

// 查詢年紀時三年紀的學生
stu := make([]Student, 0)
err := engine.Where("gradeid=?", "3").Join("INNER", "grade", "grade.id = student.gradeid").Find(&stu)
if err != nil {
    log.Println(err)
}
log.Println("查詢到的信息:" , stu)

因為查詢到的數據格式時數組,如果想獲取查詢出的數據,可以采取循環數組的方式去遍歷

for _, value := range stu {
    log.Println("value:", value)
}

或者通過下標去操作stu[0]去獲取學生的信息

5、Iterate方法

Iterate方法提供逐條執行查詢到的記錄的方法,它所能使用的條件和Find方法完全相同

// Iterate 方法
err := engine.Where("age > ? ", 10).Iterate(new(modle.Student), func(i int, bean interface{}) error {
    stu := bean.(*modle.Student)
    log.Println("查詢到的信息:", stu, i)
    return nil
})

6、Count方法

統計數據使用Count方法,Count方法的參數為struct的指針並且成為查詢條件。

// Count 判斷有幾個
stuCount := new(modle.Student)
total, err := engine.Where("age >?", 10).Count(stuCount)
if err != nil {
    log.Println(err)
}
log.Println("年齡大於10的有", total, "個")

7、Rows方法

Rows方法和Iterate方法類似,提供逐條執行查詢到的記錄的方法,不過Rows更加靈活好用。

stu := new(modle.Student)
rows, err := engine.Where("age >?", 10).Rows(stu)
if err != nil {
    log.Println(err)
}
defer rows.Close()
for rows.Next() {
    err = rows.Scan(stu)
    if err != nil {
        log.Println(err)
    }
    log.Println("========", stu)
}

插入

Created可以讓您在數據插入到數據庫時自動將對應的字段設置為當前時間

engine.TZLocation, _ = time.LoadLocation(“Asia/Shanghai”) 改變xorm的時區

type Student struct {
	Id      string `orm:"id,primary" json:"id"`
	Name    string `orm:"name"       json:"name"`
	Age     int    `orm:"age"        json:"age"`
	Gradeid int    `orm:"gradeid"    json:"gradeid" xorm:"index"`
	CreatedTime time.Time `xorm:"created"`
}
// 創建一個結構體
var stuInsert modle.Student
stuInsert.Id = "3"
stuInsert.Name = "王五"
stuInsert.Age = 20
engine.Insert(&stuInsert)

更新

// 將id=1的用戶名稱修改為少傑
var stuUpdate modle.Student
stuUpdate.Name = "少傑"
affected, err := engine.Where("id=?", "1").Update(&stuUpdate)
if err != nil {
    log.Println(err)
}
log.Println("是否更新成功:", affected)

刪除

// 刪除一個id=3的學生
var stuDelete modle.Student
affected, err := engine.Where("id=?", "3").Delete(&stuDelete)
if err != nil {
    log.Println(err)
}
log.Println("是否刪除成功:", affected)

Column屬性定義

name 當前field對應的字段的名稱,可選,如不寫,則自動根據field名字和轉換規則命名,如與其它關鍵字沖突,請使用單引號括起來。
pk 是否是Primary Key,如果在一個struct中有多個字段都使用瞭此標記,則這多個字段構成瞭復合主鍵,單主鍵當前支持int32,int,int64,uint32,uint,uint64,string這7種Go的數據類型,復合主鍵支持這7種Go的數據類型的組合。
當前支持30多種字段類型,詳情參見本文最後一個表格 字段類型
autoincr 是否是自增
[not ]null 或 notnull 是否可以為空
unique或unique(uniquename) 是否是唯一,如不加括號則該字段不允許重復;如加上括號,則括號中為聯合唯一索引的名字,此時如果有另外一個或多個字段和本unique的uniquename相同,則這些uniquename相同的字段組成聯合唯一索引
index或index(indexname) 是否是索引,如不加括號則該字段自身為索引,如加上括號,則括號中為聯合索引的名字,此時如果有另外一個或多個字段和本index的indexname相同,則這些indexname相同的字段組成聯合索引
extends 應用於一個匿名成員結構體或者非匿名成員結構體之上,表示此結構體的所有成員也映射到數據庫中,extends可加載無限級
這個Field將不進行字段映射
-> 這個Field將隻寫入到數據庫而不從數據庫讀取
<- 這個Field將隻從數據庫讀取,而不寫入到數據庫
created 這個Field將在Insert時自動賦值為當前時間
updated 這個Field將在Insert或Update時自動賦值為當前時間
deleted 這個Field將在Delete時設置為當前時間,並且當前記錄不刪除
version 這個Field將會在insert時默認為1,每次更新自動加1
default 0或default(0) 設置默認值,緊跟的內容如果是Varchar等需要加上單引號
json 表示內容將先轉成Json格式,然後存儲到數據庫中,數據庫中的字段類型可以為Text或者二進制
comment 設置字段的註釋(當前僅支持mysql)

xorm框架簡單的使用,慢慢學習,慢慢進步,加油少年!相信自己,本文章內容可以參考文檔 http://xorm.topgoer.com/

以上就是go xorm框架的使用的詳細內容,更多關於go xorm框架的資料請關註WalkonNet其它相關文章!

推薦閱讀: