Go语言学习教程：xorm表基本操做及高级操做

在上节内容中，咱们介绍了xorm框架表结构的映射规则和表结构的操做。本节课，继续来深刻学习表结构基本操做和高级查询的相关功能。

表结构基本操做

对表结构的操做最多见的操做是查询和统计相关的方法，咱们首先来看相关实现：

• 条件查询

  • 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
  }复制代码