乐观锁是 xorm 提供的一个比较实用的功能，通过在 tag 中指定 version 来开启它。开启之后，每次对记录进行更新的时候，该字段的值就会自动递增 1。如此一来，您就可以判断是否有其它地方同时修改了该记录，如果是，则应当重新操作，否则会出现错误的数据（同时对一个帐号进行取款操作却只扣了一次的数额）。
事务及回滚
废话不多说，直接上示例代码：
// 创建 Session 对象
sess := x.NewSession()
defer sess.Close()
// 开启事务
if err = sess.Begin(); err != nil {
return err
}
if _, err = sess.Update(a1); err != nil {
// 发生错误时进行回滚
sess.Rollback()
return err
}
// 完成事务
return sess.Commit()
统计记录条数- Count方法
统计数据使用Count方法，Count方法的参数为struct的指针并且成为查询条件。
a := new(Account)
//返回满足id>1的Account的记录条数
total, err := x.Where("id >?", 1).Count(a)
／／返回Account所有记录条数
total,err = x.Count(a)Iterate方法
Iterate方法提供逐条执行查询到的记录的方法，他所能使用的条件和Find方法完全相同
err := x.Where("id > ?=)", 30).Iterate(new(Account), func(i int, bean interface{})error{
user := bean.(*Account)
//do somthing use i and user
})
我们主要来看迭代函数的声明：它接受 2 个参数，第一个是当前记录所对应的索引（该索引和 ID 的值毫无关系，只是查询后结果的索引），第二个参数则是保存了相关类型的空接口，需要自行断言，例如示例中使用 bean.(*Account) 因为我们知道查询的结构是 Account。
查询特定字段
使用 Cols 方法可以指定查询特定字段，当只有结构中的某个字段的值对您有价值时，就可以使用它：
x.Cols("name").Iterate(new(Account), printFn)
var printFn = func(idx int, bean interface{}) error {
//dosomething
return nil
}此处，所查询出来的结构只有 Name 字段有值，其它字段均为零值。要注意的是，Cols 方法所接受的参数是数据表中对应的名称，而不是字段名称。
排除特定字段
当您希望刻意忽略某个字段的查询结果时，可以使用 Omit 方法：
x.Omit("name").Iterate(new(Account), printFn)
此处，所查询出来的结构只有 Name 字段为零值。要注意的是，Omit 方法所接受的参数是数据表中对应的名称，而不是字段名称。
查询结果偏移
查询结果偏移在分页应用中最为常见，通过 Limit 方法可以达到一样的目的：
x.Limit(3, 2).Iterate(new(Account), printFn)该方法最少接受 1 个参数，第一个参数表示取出的最大记录数；如果传入第二个参数，则表示对查询结果进行偏移。因此，此处的查询结果为偏移 2 个后，再最多取出 3 个记录。
日志记录
一般情况下，使用x.ShowSQL = true来开启 xorm 最基本的日志功能，所有 SQL 都会被打印到控制台，但如果您想要将日志保存到文件，则可以在获取到 ORM 引擎之后，进行如下操作：
f, err := os.Create("sql.log")
if err != nil {
log.Fatalf("Fail to create log file: %v\n", err)
return
}
x.Logger = xorm.NewSimpleLogger(f)
LRU 缓存
作为唯一支持 LRU 缓存的一款 ORM，如果不知道如何使用这个特性，那将是非常遗憾。不过，想要使用它也并不困难，只需要在获取到 ORM 引擎之后，进行如下操作：
cacher := xorm.NewLRUCacher(xorm.NewMemoryStore(), 1000)
x.SetDefaultCacher(cacher)这样就算是使用最基本的缓存功能了。该功能还支持只缓存某些表或排除缓存某些表，详情可以参见 文章首部的官方文档。
事件钩子
官方一共提供了 6 类 事件钩子，示例中只演示其中 2 种：BeforeInsert 和 AfterInsert。全部内容查看文章首部官方文档
它们的作用分别会在 进行插入记录之前 和 完成插入记录之后 被调用：
func (a *Account) BeforeInsert() {
log.Printf("before insert: %s", a.Name)
}
func (a *Account) AfterInsert() {
log.Printf("after insert: %s", a.Name)
}
下面是一个简单的银行存取款的小例子
package main
import (
"errors"
"log"
"github.com/go-xorm/xorm"
_ "github.com/mattn/go-sqlite3"
)
// 银行账户
type Account struct {
Id int64
Name string `xorm:"unique"`
Balance float64
Version int `xorm:"version"` // 乐观锁
}
// ORM 引擎
var x *xorm.Engine
func init() {
// 创建 ORM 引擎与数据库
var err error
x, err = xorm.NewEngine("mysql", "root:root@/hong?charset=utf8")
if err != nil {
log.Fatalf("Fail to create engine: %v\n", err)
}
// 同步结构体与数据表
if err = x.Sync(new(Account)); err != nil {
log.Fatalf("Fail to sync database: %v\n", err)
}
}
// 创建新的账户
func newAccount(name string, balance float64) error {
// 对未存在记录进行插入
_, err := x.Insert(&Account{Name: name, Balance: balance})
return err
}
// 获取账户信息
func getAccount(id int64) (*Account, error) {
a := &Account{}
// 直接操作 ID 的简便方法
has, err := x.Id(id).Get(a)
// 判断操作是否发生错误或对象是否存在
if err != nil {
return nil, err
} else if !has {
return nil, errors.New("Account does not exist")
}
return a, nil
}
// 用户转账
func makeTransfer(id1, id2 int64, balance float64) error {
// 创建 Session 对象
sess := x.NewSession()
defer sess.Close()
// 启动事务
if err = sess.Begin(); err != nil {
return err
}
a1, err := getAccount(id1)
if err != nil {
return err
}
a2, err := getAccount(id2)
if err != nil {
return err
}
if a1.Balance < balance {
return errors.New("Not enough balance")
}
a1.Balance -= balance
a2.Balance += balance
if _, err = sess.Update(a1); err != nil {
// 发生错误时进行回滚
sess.Rollback()
return err
}
if _, err = sess.Update(a2); err != nil {
sess.Rollback()
return err
}
// 完成事务
return sess.Commit()
return nil
}
// 用户存款
func makeDeposit(id int64, deposit float64) (*Account, error) {
a, err := getAccount(id)
if err != nil {
return nil, err
}
sess := x.NewSession()
defer sess.Close()
if err = sess.Begin(); err != nil {
return nil, err
}
a.Balance += deposit
// 对已有记录进行更新
if _, err = sess.Update(a); err != nil {
sess.Rollback()
return nil, err
}
return a, sess.Commit()
}
// 用户取款
func makeWithdraw(id int64, withdraw float64) (*Account, error) {
a, err := getAccount(id)
if err != nil {
return nil, err
}
if a.Balance < withdraw {
return nil, errors.New("Not enough balance")
}
sess := x.NewSession()
defer sess.Close()
if _, err = sess.Begin(); err != nil {
return nil, err
}
a.Balance -= withdraw
if _, err = sess.Update(a); err != nil {
return nil, err
}
return a, sess.Commit()
}
// 按照 ID 正序排序返回所有账户
func getAccountsAscId() (as []Account, err error) {
// 使用 Find 方法批量获取记录
err = x.Find(&as)
return as, err
}
// 按照存款倒序排序返回所有账户
func getAccountsDescBalance() (as []Account, err error) {
// 使用 Desc 方法使结果呈倒序排序
err = x.Desc("balance").Find(&as)
return as, err
}
// 删除账户
func deleteAccount(id int64) error {
// 通过 Delete 方法删除记录
_, err := x.Delete(&Account{Id: id})
return err
}
数据库列属性定义：
具体的Tag规则如下，另Tag中的关键字均不区分大小写，但字段名根据不同的数据库是区分大小写
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 设置默认值，紧跟的内容如果是Varchar等需要加上单引号\
1086
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
