文档章节

xorm速记卡 Quick Reference

go-skyblue
 go-skyblue
发布于 2014/03/10 12:50
字数 542
阅读 2635
收藏 0

xorm is a very famous golang lib, for operating relation database.

Install

go get -v github.com/go-xorm/xorm

Documentation

Get started

Import packages

package main

import (
	"log"

	"github.com/go-xorm/xorm"
	_ "github.com/mattn/go-sqlite3"
)

Define models

type User struct {
	Id    int64
	Name  string `xorm:"unique"`
	Email string
}

Create database engine

var xe *xorm.Engine

func init() {
	var err error
	xe, err = xorm.NewEngine("sqlite3", "./test.db")
	if err != nil {
		log.Fatal(err)
	}
	if err = xe.Sync(&User{}); err != nil {
		log.Fatal(err)
	}
}

Insert and Query

func main() {
	xe.Insert(&User{Name: "UU", Email: "uu@example.com"})

	var user = &User{Name: "UU"}
	exists, err := xe.Get(user)
	if err != nil {
		log.Fatal(err)
	}
	log.Printf("Exists: %v, User: %#v", exists, user)
}

Driver and source

Example

x, err := xorm.NewEngine("mysql", "root:123@/test?charset=utf8")
defer x.Close()

other driver

mysql github.com/go-sql-driver/mysql

[username[:password]@][protocol[(address)]]/dbname[?param1=value1&...&paramN=valueN]

mymysql github.com/ziutek/mymysql/godrv

usage todo.

postgresql github.com/lib/pq

1. postgres://username:password@address/dbname?sslmode=verify-full
2. user=pqgotest dbname=pqgotest sslmode=verify-full

sqlite3 github.com/mattn/go-sqlite3

1. ./dbfile

Define models

// default matches
// - string => varchar(255)
type Model struct {
	Id         int64
	SmallInt   int64     `xorm:"smallint"`
	Int        int64     `xorm:"int"`
	Text       string    `xorm:"text"`
	DefaultVal int64     `xorm:"default 3"`
	Bool       bool      `xorm:"bool"`
	Unique     string    `xorm:"unique"`    // unique([Unique])
	UniqA1     string    `xorm:"unique(a)"` // unique([UniqA1, UniqA2])
	UniqA2     string    `xorm:"unique(a)"`
	Version    int64     `xorm:"version"` // will be filled 1 on insert and autoincr on update
	CreatedAt  time.Time `xorm:"created"` // will be filled in current time on insert
	UpdatedAt  time.Time `xorm:"updated"` // will be filled in current time on insert or update
}

column types

ref: https://github.com/lunny/xorm/blob/master/docs/COLUMNTYPE.md

  • pk # primary key
  • autoincr
  • [not ]null
  • unique or unique(uniquename)
  • index or index(indexname)
  • extends
  • `- # ignore this field
  • created # This field will be filled in current time on insert
  • version # This field will be filled 1 on insert and autoincrement on update
  • default 0 # default value, need quoted if it is a string

CRUD funcs

Create, Retrive, Update, Delete

INSERT (Create) more

  • Insert one record

    user := &User{
        Name: "test",
    }
    affected, err := engine.Insert(user)
    
  • Insert multi records

    users := make([]User, 0)
    users = append(users, User{Name: "test"})
    affected, err := engine.Insert(&users)
    

Query (Retrieve) more

  • Get one record

    var user = User{Id: 1}
    has, err := engine.Get(&user)
    
  • Fetch multi records in to slice or map

    var everyone []User
    err := engine.Find(&everyone)
    
    users := make(map[int64]User)
    err := engine.Find(&users)
    
  • Use where and limit

    var users []User
    err := engine.Where("id > ?", 3).Limit(10, 5).Find(&users) // limit 10 offset 5
    
  • Query use struct

    var users []User
    err := engine.Find(&users, &User{School: "hangzhou"})
    
  • Use in function

    var users []User
    err := engine.In("id", 1, 3, 5).Find(&users)
    
  • Default will query all cols, use Cols to restrict that

    var users []User
    err := engine.Cols("id", "name").Find(&users)
    
  • Count

    total, err := engine.Where("id > ?", 1).Count(&User{})
    

    If user is not empty, it will become the select rule.

    total, err := engine.Count(&User{School: "hangzhou"})
    
  • Complex example

    var users []User
    err = x.Cols("age", "name")
        .Where("`age` > ?", 10)
        .And("`age` < 30")
        .Limit(10, 5) // limit 10 offset 5
        .Desc("age")
        .In("school", "hangzhou", "beijing"})
        .Find(&users)
    

Update (Update) more

© 著作权归作者所有

go-skyblue

go-skyblue

粉丝 89
博文 50
码字总数 31921
作品 5
杭州
程序员
私信 提问
使用xorm工具,根据数据库自动生成 go 代码

使用xorm工具,根据数据库自动生成 go 代码 引入 使用 golang 操作数据库的同学都会遇到一个问题 —— 根据数据表结构创建对应的 struct 模型。因为 golang 的使用首字母控制可见范围,我们经...

万建宁
2018/12/04
440
0
xorm操作PostgreSQL数据库(增删改查实例)

一、xorm介绍 xorm是一个简单而强大的Go语言ORM库.通过它可以使数据库操作非常简便。xorm的目标并不是让你完全不去学习SQL,我们认为SQL并不会为ORM所替代,但是ORM将可以解决绝大部分的简单...

mickelfeng
2018/11/27
241
0
xorm v0.1.7 发布,Go语言ORM框架

xorm是一个简单而强大的Go语言ORM库. 通过它可以使数据库操作非常简便。 本次版本发布有如下更新: 1.新增IConnectPool接口以及NoneConnectPool, SysConnectPool, SimpleConnectPool三种实现...

lunny
2013/07/03
1K
23
go-xorm支持外键吗

@lunny 你好,想跟你请教个问题:百度也没有找到答案,请问一下go-xorm支持外键吗?比如在结构体中引用结构体,查询外层结构体之后,内部包含的结构体也被赋值,go-xorm目前支持这个吗?谢谢...

pchenghao
2015/07/27
796
1
使用xorm和beego快速生成REST-API应用(只写了一半的文章)

框架选择 选择beego是因为它文档比较全, 选择xorm是因为我用了很久,而且它真的很好用. beego的API设计 web应用中,用的最多的还是 json的请求和返回. 参考jas的风格, API的返回值,规定如下, 如...

go-skyblue
2014/03/14
5.3K
0

没有更多内容

加载失败,请刷新页面

加载更多

debian10使用putty配置交换机console口

前言:Linux的推广普及,需要配合解决实际应用方能有成效! 最近强迫自己用linux进行实际工作,过程很痛苦,还好通过网络一一解决,感谢各位无私网友博客的帮助! 系统:debian10 桌面:xfc...

W_Lu
30分钟前
9
0
aelf Enterprise 0.8.0 beta有奖公测,“Bug奖金计划”重磅开启

2019年9月30日,aelf Enterprise 0.8.0 beta版正式发布。aelf Enterprise 0.8.0 beta是一个完备的区块链系统, 包含完备的区块链系统、开发套件、开发文档、以及配套的基础应用和基础服务。 ...

AELF开发者社区
32分钟前
7
0
oracle 初始化数据库脚本

create user lpf identified by 123456; create tablespace lpf_ts_cms datafile '/opt/app/oracle/product/11.2.0/lpf.dbf' size 200M; alter user lpf default tablespace lpf_ts_cms; sel......

internetafei
36分钟前
5
0
《区块链DAPP开发入门、代码实现、场景应用》笔记1——天外飞仙DAPP

Solidity编程语言解决了编写智能合约的不友好的问题,但是当合约编译并部署之后,对与这些接口的访问,对于一般的使用者来说,门槛有点高, 对普通用户来说也是非常不友好,为了使广大用户理...

柯南和由美
41分钟前
4
0
流程图制作软件推荐_流程图制作软件哪个好

流程图(Flow Chart)是一种表示算法思路的图示,通过特定图形、图表可以直观的说明某一过程。这种过程既可以是生产线上的工艺流程图,也可以标明某项任务必需的管理过程。为了便于识别,绘制...

工具分享
43分钟前
6
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部