[TOC] # RegisterDriver驅動的名字 三種默認數據庫類型 ~~~ // For version 1.6 orm.DRMySQL orm.DRSqlite orm.DRPostgres // < 1.6 orm.DR_MySQL orm.DR_Sqlite orm.DR_Postgres ~~~ # RegisterDataBase ORM 必須注冊一個別名為`default`的數據庫，作為默認使用。 ORM 使用 golang 自己的連接池 ~~~ // 參數1 數據庫的別名，用來在 ORM 中切換數據庫使用 // 參數2 driverName // 參數3 對應的鏈接字符串 orm.RegisterDataBase("default", "mysql", "root:root@/orm_test?charset=utf8") // 參數4(可選) 設置最大空閑連接 // 參數5(可選) 設置最大數據庫連接 (go >= 1.2) maxIdle := 30 maxConn := 30 orm.RegisterDataBase("default", "mysql", "root:root@/orm_test?charset=utf8", maxIdle, maxConn) ~~~ **SetMaxIdleConns** 根據數據庫的別名，設置數據庫的最大空閑連接 ~~~ orm.SetMaxIdleConns("default", 30) ~~~ **SetMaxOpenConns** 根據數據庫的別名，設置數據庫的最大數據庫連接 (go >= 1.2) ~~~ orm.SetMaxOpenConns("default", 30) ~~~ # 時區設置 ~~~ orm.DefaultTimeLoc = time.PRC ~~~ 也可以這樣 ~~~ root:root@/orm_test?charset=utf8&loc=Asia%2FShanghai ~~~ # 注冊模型 如果使用 orm.QuerySeter 進行高級查詢的話，這個是必須的。 反之，如果只使用 Raw 查詢和 map struct，是無需這一步的 ## RegisterModel注冊 將你定義的 Model 進行注冊，最佳設計是有單獨的 models.go 文件，在他的 init 函數中進行注冊 RegisterModel 也可以同時注冊多個 model ~~~ orm.RegisterModel(new(User), new(Profile), new(Post)) ~~~ ### RegisterModelWithPrefix表前綴 使用表名前綴 ~~~ orm.RegisterModelWithPrefix("prefix_", new(User)) ~~~ 創建后的表名為 prefix\_user ### NewOrmWithDB創建連接并使用orm 有時候需要自行管理連接池與數據庫鏈接（比如：go 的鏈接池無法讓兩次查詢使用同一個鏈接的） 但又想使用 ORM 的查詢功能 ~~~ var driverName, aliasName string // driverName 是驅動的名稱 // aliasName 是當前 db 的自定義別名 var db *sql.DB ... o := orm.NewOrmWithDB(driverName, aliasName, db) ~~~ #### GetDB獲取數據庫對象 從已注冊的數據庫返回 \*sql.DB 對象，默認返回別名為 default 的數據庫。 ~~~ db, err := orm.GetDB() if err != nil { fmt.Println("get default DataBase") } db, err := orm.GetDB("alias") if err != nil { fmt.Println("get alias DataBase") } ~~~ # 庫的操作 使用 ORM 必然接觸的 Ormer 接口，我們來熟悉一下 ~~~ var o orm.Ormer o = orm.NewOrm() // 創建一個 Ormer // NewOrm 的同時會執行 orm.BootStrap (整個 app 只執行一次)，用以驗證模型之間的定義并緩存。 ~~~ 切換數據庫，或者，進行事務處理，都會作用于這個 Ormer 對象，以及其進行的任何查詢。 所以：需要**切換數據庫**和**事務處理**的話，不要使用全局保存的 Ormer 對象 ## 切換庫 **Using** 切換為其他數據庫 ~~~ orm.RegisterDataBase("db1", "mysql", "root:root@/orm_db2?charset=utf8") orm.RegisterDataBase("db2", "sqlite3", "data.db") o1 := orm.NewOrm() o1.Using("db1") o2 := orm.NewOrm() o2.Using("db2") // 切換為其他數據庫以后 // 這個 Ormer 對象的其下的 api 調用都將使用這個數據庫 ~~~ 默認使用`default`數據庫，無需調用 Using ## 直接使用sql **Raw** 使用 sql 語句直接進行操作 Raw 函數，返回一個RawSete用以對設置的 sql 語句和參數進行操作 ~~~ o := orm.NewOrm() var r orm.RawSeter r = o.Raw("UPDATE user SET name = ? WHERE name = ?", "testing", "slene") ~~~ ## 驗證db信息 **Driver** 返回當前 ORM 使用的 db 信息 ~~~ type Driver interface { Name() string Type() DriverType } ~~~ ~~~ orm.RegisterDataBase("db1", "mysql", "root:root@/orm_db2?charset=utf8") orm.RegisterDataBase("db2", "sqlite3", "data.db") o1 := orm.NewOrm() o1.Using("db1") dr := o1.Driver() fmt.Println(dr.Name() == "db1") // true fmt.Println(dr.Type() == orm.DRMySQL) // true o2 := orm.NewOrm() o2.Using("db2") dr = o2.Driver() fmt.Println(dr.Name() == "db2") // true fmt.Println(dr.Type() == orm.DRSqlite) // true ~~~ # 調試 簡單的設置 Debug 為 true 打印查詢的語句 可能存在性能問題，不建議使用在生產模式 ~~~ func main() { orm.Debug = true ... ~~~ 默認使用 os.Stderr 輸出日志信息 改變輸出到你自己的 io.Writer ~~~ var w io.Writer ... // 設置為你的 io.Writer ... orm.DebugLog = orm.NewLog(w) ~~~ 日志格式 ~~~ [ORM] - 時間 - [Queries/數據庫名] - [執行操作/執行時間] - [SQL語句] - 使用標點 `,` 分隔的參數列表 - 打印遇到的錯誤 ~~~