Iris_xorm
阅读原文时间:2023年07月13日阅读:1

表结构基本操作

对表结构的操作最常见的操作是查询和统计相关的方法,我们首先来看相关实现:

  • 条件查询

    • 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
    }

代码:

package main

import (
"github.com/go-xorm/xorm"
"github.com/go-xorm/core"
"fmt"
_ "github.com/go-sql-driver/mysql"
)

//xorm基本操作和高级操作
func main() {

//1. 创建数据库引擎对象  
engine, err := xorm.NewEngine("mysql", "root:yu271400@/testCms?charset=utf8")  
if err != nil {  
    panic(err.Error())  
}

//2.设置映射规则  
engine.SetMapper(core.SnakeMapper{})

//3、同步数据库表格  
engine.Sync2(new(PersonTable))

//4.判断person表格是否存在  
personExist, err := engine.IsTableExist(new(PersonTable))  
if err != nil {  
    panic(err.Error())  
}  
if personExist {  
    fmt.Println("人员表存在")  
} else {  
    fmt.Println("人员表不存在")  
}

//5.判断person表格是否为空  
personEmpty, err := engine.IsTableEmpty(new(PersonTable))  
if err != nil {  
    panic(err.Error())  
}  
if personEmpty {  
    fmt.Println(" 人员表是空的 ")  
} else {  
    fmt.Println(" 人员表不为空 ")  
}

//二、条件查询  
//1.ID查询  
var person PersonTable  
// select \* from person\_table where id = 1  
engine.Id(1).Get(&person) //返回两个值,布尔类型的结果和err(没有错误是nil)  
fmt.Println(person.PersonName)  
fmt.Println()

//2.where多条件查询  
var person1 PersonTable  
// select \* from person\_table where person\_age = 26 and person\_sex = 2  
//Get只会返回一条数据,如下,查询到age为26的就不查了  
engine.Where(" person\_age = ? and person\_sex = ?", 26, 2).Get(&person1) //?占位  
//Find返回所有符合条件的结果  
var person2 \[\]PersonTable  
//可以使用And拆开写26和2,看下面  
engine.Where(" person\_age = ? and person\_sex = ?", 26, 2).Find(&person2) //?占位  
fmt.Println(person1.PersonName)  
fmt.Println()

//3.And条件查询  
var persons \[\]PersonTable  
//select \* from person\_table where person\_age = 26 and person\_sex = 2  
err = engine.Where(" person\_age = ? ", 26).And("person\_sex = ? ", 2).Find(&persons)  
if err != nil {  
    panic(err.Error())  
}  
fmt.Println(persons)  
fmt.Println()

//4、Or条件查询  
var personArr \[\]PersonTable  
//select \* from person\_table where person\_age = 26 or person\_sex = 1  
err = engine.Where(" person\_age = ? ", 26).Or("person\_sex = ? ", 1).Find(&personArr)  
if err != nil {  
    panic(err.Error())  
}  
fmt.Println(personArr)  
fmt.Println()

//5、原生SQL语句查询支持 like语法  
var personsNative \[\]PersonTable  
err = engine.SQL(" select \* from person\_table where person\_name like 't%' ").Find(&personsNative)  
if err != nil {  
    panic(err.Error())  
}  
fmt.Println(personsNative)  
fmt.Println()

//6、排序条件查询  
var personsOrderBy \[\]PersonTable  
//select \* from person\_table orderby person\_age  升序排列  
//engine.OrderBy(" person\_age ").Find(&personsOrderBy)  
engine.OrderBy(" person\_age desc ").Find(&personsOrderBy)  
fmt.Println(personsOrderBy)  
fmt.Println()

//7、查询特定字段  
var personsCols \[\]PersonTable  
engine.Cols("person\_name", "person\_age").Find(&personsCols)  
for \_, col := range personsCols {  
    fmt.Println(col)  
}

//三、增加记录操作  
personInsert := PersonTable{  
    //字段        //值  
    PersonName: "Hello",  
    PersonAge:  18,  
    PersonSex:  1,  
}  
rowNum, err := engine.Insert(&personInsert)  
fmt.Println(rowNum) //rowNum受影响的记录条数,插入了几条数据,就返回几  
fmt.Println()

//四、删除操作  
rowNum2, err := engine.Delete(&personInsert)  
fmt.Println(rowNum2) //rowNum2受影响的记录条数  
fmt.Println()

//五、更新操作  
rowNum3, err = engine.Id(7).Update(&personInsert) //修改成personInsert对象对应的数据  
fmt.Println(rowNum3) //rowNum受影响的记录条数  
fmt.Println()

//六、统计功能count  
count, err := engine.Count(new(PersonTable)) //一个表中有多少条数据,分页中使用  
fmt.Println("PersonTable表总记录条数:", count)

//七、事务操作(用于批量执行,不能只执行了一部分,而一部分没有被执行,这种情况使用回滚)  
personsArray := \[\]PersonTable{ //初始化结构体切片  
    PersonTable{  
        PersonName: "Jack",  
        PersonAge:  28,  
        PersonSex:  1,  
    },  
    PersonTable{  
        PersonName: "Mali",  
        PersonAge:  28,  
        PersonSex:  1,  
    },  
    PersonTable{  
        PersonName: "Ruby",  
        PersonAge:  28,  
        PersonSex:  1,  
    },  
}

//创建事务  
session := engine.NewSession()  
//事务开始  
session.Begin()  
//for循环插入数据  
for i := 0; i < len(personsArray); i++ {  
    \_, err = session.Insert(personsArray\[i\])  
    if err != nil { //处理错误  
        //事务回滚  
        session.Rollback()  
        session.Close()  
    }  
}  
//事务提交  
err = session.Commit()  
session.Close()  
if err != nil {  
    panic(err.Error())  
}  

}

//人员结构表
type PersonTable struct {
Id int64 `xorm:"pk autoincr"` //主键自增
PersonName string `xorm:"varchar(24)"` //可变字符
PersonAge int `xorm:"int default 0"` //默认值
PersonSex int `xorm:"notnull"` //不能为空
City CityTable `xorm:"-"` //不映射该字段
}

type CityTable struct {
CityName string
CityLongitude float32
CityLatitude float32
}

手机扫一扫

移动阅读更方便

阿里云服务器
腾讯云服务器
七牛云服务器