Improved documents; Optimistic Locking support; Timestamp with time zone support; Mapper change to tableMapper and columnMapper & added PrefixMapper & SuffixMapper support custom table or column name's prefix and suffix;Insert now return affected, err instead of id, err; Added UseBool & Distinct;
This commit is contained in:
Lunny Xiao
parent
20bfc62f13
commit
cc0ce11294
|
|
@ -22,6 +22,9 @@ Xorm is a simple and powerful ORM for Go.
|
|||
|
||||
* Simple cascade loading support
|
||||
|
||||
* Optimistic Locking support
|
||||
|
||||
|
||||
# Drivers Support
|
||||
|
||||
Drivers for Go's sql package which currently support database/sql includes:
|
||||
|
|
@ -37,6 +40,7 @@ Drivers for Go's sql package which currently support database/sql includes:
|
|||
|
||||
# Changelog
|
||||
|
||||
* **v0.2.3** : Improved documents; Optimistic Locking support; Timestamp with time zone support; Mapper change to tableMapper and columnMapper & added PrefixMapper & SuffixMapper support custom table or column name's prefix and suffix;Insert now return affected, err instead of id, err; Added UseBool & Distinct;
|
||||
* **v0.2.2** : Postgres drivers now support lib/pq; Added method Iterate for record by record to handler；Added SetMaxConns(go1.2+) support; some bugs fixed.
|
||||
* **v0.2.1** : Added database reverse tool, now support generate go & c++ codes, see [Xorm Tool README](https://github.com/lunny/xorm/blob/master/xorm/README.md); some bug fixed.
|
||||
* **v0.2.0** : Added Cache supported, select is speeder up 3~5x; Added SameMapper for same name between struct and table; Added Sync method for auto added tables, columns, indexes;
|
||||
|
|
|
|||
|
|
@ -24,6 +24,8 @@ xorm是一个简单而强大的Go语言ORM库. 通过它可以使数据库操作
|
|||
|
||||
* 支持根据数据库自动生成xorm的结构体
|
||||
|
||||
* 支持记录版本（即乐观锁）
|
||||
|
||||
## 驱动支持
|
||||
|
||||
目前支持的Go数据库驱动如下：
|
||||
|
|
@ -39,6 +41,7 @@ xorm是一个简单而强大的Go语言ORM库. 通过它可以使数据库操作
|
|||
* Postgres: [github.com/bylevel/pq](https://github.com/bylevel/pq)
|
||||
|
||||
## 更新日志
|
||||
* **v0.2.3** : 改善了文档；提供了乐观锁支持；添加了带时区时间字段支持；Mapper现在分成表名Mapper和字段名Mapper，同时实现了表或字段的自定义前缀后缀；Insert方法的返回值含义从id, err更改为 affected, err，请大家注意；添加了UseBool 和 Distinct函数。
|
||||
* **v0.2.2** : Postgres驱动新增了对lib/pq的支持；新增了逐条遍历方法Iterate；新增了SetMaxConns(go1.2+)支持，修复了bug若干；
|
||||
* **v0.2.1** : 新增数据库反转工具，当前支持go和c++代码的生成，详见 [Xorm Tool README](https://github.com/lunny/xorm/blob/master/xorm/README.md); 修复了一些bug.
|
||||
* **v0.2.0** : 新增 [缓存](https://github.com/lunny/xorm/blob/master/docs/QuickStart.md#120)支持，查询速度提升3-5倍； 新增数据库表和Struct同名的映射方式； 新增Sync同步表结构；
|
||||
|
|
|
|||
|
|
@ -1446,7 +1446,7 @@ type Version struct {
|
|||
}
|
||||
|
||||
func testVersion(engine *Engine, t *testing.T) {
|
||||
/*err := engine.DropTables(new(Version))
|
||||
err := engine.DropTables(new(Version))
|
||||
if err != nil {
|
||||
t.Error(err)
|
||||
panic(err)
|
||||
|
|
@ -1507,7 +1507,7 @@ func testVersion(engine *Engine, t *testing.T) {
|
|||
err = errors.New("insert error")
|
||||
t.Error(err)
|
||||
panic(err)
|
||||
}*/
|
||||
}
|
||||
|
||||
/*
|
||||
newVer.Name = "-------"
|
||||
|
|
|
|||
|
|
@ -21,6 +21,7 @@ xorm 快速入门
|
|||
* [5.5.Iterate方法](#65)
|
||||
* [5.6.Count方法](#66)
|
||||
* [6.更新数据](#70)
|
||||
* [6.1.乐观锁](#71)
|
||||
* [7.删除数据](#80)
|
||||
* [8.执行SQL查询](#90)
|
||||
* [9.执行SQL命令](#100)
|
||||
|
|
@ -176,6 +177,9 @@ type User struct {
|
|||
</tr>
|
||||
<tr>
|
||||
<td>updated</td><td>这个Field将在Insert或Update时自动赋值为当前时间</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>version</td><td>这个Field将会在insert时默认为1，每次更新自动加1</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>default 0</td><td>设置默认值，紧跟的内容如果是Varchar等需要加上单引号</td>
|
||||
|
|
@ -518,6 +522,26 @@ affected, err := engine.Id(id).Cols("age").Update(&user)
|
|||
affected, err := engine.Table(new(User)).Id(id).Update(map[string]interface{}{"age":0})
|
||||
```
|
||||
|
||||
<a name="71" id="71"></a>
|
||||
### 6.1.乐观锁
|
||||
|
||||
要使用乐观锁，需要使用version标记
|
||||
type User struct {
|
||||
Id int64
|
||||
Name string
|
||||
Version int `xorm:"version"`
|
||||
}
|
||||
|
||||
在Insert时，version标记的字段将会被设置为1，在Update时，Update的内容必须包含version原来的值。
|
||||
|
||||
```Go
|
||||
var user User
|
||||
engine.Id(1).Get(&user)
|
||||
// SELECT * FROM user WHERE id = ?
|
||||
engine.Id(1).Update(&user)
|
||||
// UPDATE user SET ..., version = version + 1 WHERE id = ? AND version = ?
|
||||
```
|
||||
|
||||
<a name="80" id="80"></a>
|
||||
## 7.删除数据
|
||||
|
||||
|
|
|
|||
|
|
@ -20,6 +20,7 @@ Quick Start
|
|||
* [5.5.Iterate](#65)
|
||||
* [5.6.Count](#66)
|
||||
* [6.Update records](#70)
|
||||
* [6.1.Optimistic Locking](#71)
|
||||
* [7.Delete records](#80)
|
||||
* [8.Execute SQL command](#90)
|
||||
* [9.Execute SQL query](#100)
|
||||
|
|
@ -171,10 +172,13 @@ type User struct {
|
|||
<td><-</td><td>这个Field将只从数据库读取，而不写入到数据库</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>created</td><td>这个Field将在Insert时自动赋值为当前时间</td>
|
||||
<td>created</td><td>This field will be filled in current time on insert</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>updated</td><td>这个Field将在Insert或Update时自动赋值为当前时间</td>
|
||||
<td>updated</td><td>This field will be filled in current time on insert or update</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>version</td><td>This field will be filled 1 on insert and autoincrement on update</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>default 0</td><td>设置默认值，紧跟的内容如果是Varchar等需要加上单引号</td>
|
||||
|
|
@ -502,6 +506,27 @@ affected, err := engine.Id(id).Cols("age").Update(&user)
|
|||
affected, err := engine.Table(new(User)).Id(id).Update(map[string]interface{}{"age":0})
|
||||
```
|
||||
|
||||
|
||||
### 6.1.乐观锁
|
||||
|
||||
要使用乐观锁，需要使用version标记
|
||||
type User struct {
|
||||
Id int64
|
||||
Name string
|
||||
Version int `xorm:"version"`
|
||||
}
|
||||
|
||||
在Insert时，version标记的字段将会被设置为1，在Update时，Update的内容必须包含version原来的值。
|
||||
|
||||
```Go
|
||||
var user User
|
||||
engine.Id(1).Get(&user)
|
||||
// SELECT * FROM user WHERE id = ?
|
||||
engine.Id(1).Update(&user)
|
||||
// UPDATE user SET ..., version = version + 1 WHERE id = ? AND version = ?
|
||||
```
|
||||
|
||||
|
||||
<a name="80" id="80"></a>
|
||||
## 7.Delete one or more records
|
||||
Delete one or more records
|
||||
|
|
|
|||
|
|
@ -2072,7 +2072,9 @@ func (session *Session) Update(bean interface{}, condiBean ...interface{}) (int6
|
|||
}
|
||||
|
||||
if table.Cacher != nil && session.Statement.UseCache {
|
||||
session.cacheUpdate(sql, args...)
|
||||
//session.cacheUpdate(sql, args...)
|
||||
table.Cacher.ClearIds(session.Statement.TableName())
|
||||
table.Cacher.ClearBeans(session.Statement.TableName())
|
||||
}
|
||||
|
||||
return res.RowsAffected()
|
||||
|
|
|
|||
Loading…
Reference in New Issue