# 在init中注册和连接数据库
注册数据库类型
```
orm.RegisterDriver("mysql", orm.DRMySQL)
```
连接Msql数据库
`orm.RegisterDataBase("default", "mysql", "username:password@tcp(127.0.0.1:3306)/db_name?charset=utf8", 30)`
# 在Model中Struct数据表
~~~
type User struct {
Id int
Name string `orm:"size(100)"`
}
func init() {
// register model
orm.RegisterModel(new(User))
// create table
orm.RunSyncdb("default", false, true)
}
~~~
# 在controller中运用
~~~
o := orm.NewOrm() //初始化orm
o.Using("default") // 默认使用 default，你可以指定为其他数据库,也可以不用写
Model.User{"id":1,"name":"golang"}
id,err := o.insert(&user)
~~~
# 附： stuct设置参数
~~~
orm:"null;rel(fk)"
~~~
多个设置间使用`;`分隔，设置的值如果是多个，使用`,`分隔。
#### 忽略字段
设置`-`即可忽略 struct 中的字段
~~~
type User struct {
...
AnyField string `orm:"-"`
...
}
~~~
#### auto
当 Field 类型为 int, int32, int64, uint, uint32, uint64 时，可以设置字段为自增健
* 当模型定义里没有主键时，符合上述类型且名称为`Id`的 Field 将被视为自增健。
鉴于 go 目前的设计，即使使用了 uint64，但你也不能存储到他的最大值。依然会作为 int64 处理。
参见 issue[6113](http://code.google.com/p/go/issues/detail?id=6113)
#### pk
设置为主键，适用于自定义其他类型为主键
#### null
数据库表默认为`NOT NULL`，设置 null 代表`ALLOW NULL`
~~~
Name string `orm:"null"`
~~~
#### index
为单个字段增加索引
#### unique
为单个字段增加 unique 键
~~~
Name string `orm:"unique"`
~~~
#### column
为字段设置 db 字段的名称
~~~
Name string `orm:"column(user_name)"`
~~~
#### size
string 类型字段默认为 varchar(255)
设置 size 以后，db type 将使用 varchar(size)
~~~
Title string `orm:"size(60)"`
~~~
#### digits / decimals
设置 float32, float64 类型的浮点精度
~~~
Money float64 `orm:"digits(12);decimals(4)"`
~~~
总长度 12 小数点后 4 位 eg:`99999999.9999`
#### auto\_now / auto\_now\_add
~~~
Created time.Time `orm:"auto_now_add;type(datetime)"`
Updated time.Time `orm:"auto_now;type(datetime)"`
~~~
* auto\_now 每次 model 保存时都会对时间自动更新
* auto\_now\_add 第一次保存时才设置时间
对于批量的 update 此设置是不生效的
#### type
设置为 date 时，time.Time 字段的对应 db 类型使用 date
~~~
Created time.Time `orm:"auto_now_add;type(date)"`
~~~
设置为 datetime 时，time.Time 字段的对应 db 类型使用 datetime
~~~
Created time.Time `orm:"auto_now_add;type(datetime)"`
~~~
#### default
为字段设置默认值，类型必须符合（目前仅用于级联删除时的默认值）
~~~
type User struct {
...
Status int `orm:"default(1)"`
...
}
~~~
#### Comment
为字段添加注释
~~~
type User struct {
...
Status int `orm:"default(1)" description:"这是状态字段"`
...
}
~~~
注意: 注释中禁止包含引号
## 表关系设置
#### rel / reverse
**RelOneToOne**:
~~~
type User struct {
...
Profile *Profile `orm:"null;rel(one);on_delete(set_null)"`
...
}
~~~
对应的反向关系**RelReverseOne**:
~~~
type Profile struct {
...
User *User `orm:"reverse(one)"`
...
}
~~~
**RelForeignKey**:
~~~
type Post struct {
...
User *User `orm:"rel(fk)"` // RelForeignKey relation
...
}
~~~
对应的反向关系**RelReverseMany**:
~~~
type User struct {
...
Posts []*Post `orm:"reverse(many)"` // fk 的反向关系
...
}
~~~
**RelManyToMany**:
~~~
type Post struct {
...
Tags []*Tag `orm:"rel(m2m)"` // ManyToMany relation
...
}
~~~
对应的反向关系**RelReverseMany**:
~~~
type Tag struct {
...
Posts []*Post `orm:"reverse(many)"`
...
}
~~~
#### rel\_table / rel\_through
此设置针对`orm:"rel(m2m)"`的关系字段
~~~
rel_table 设置自动生成的 m2m 关系表的名称
rel_through 如果要在 m2m 关系中使用自定义的 m2m 关系表
通过这个设置其名称，格式为 pkg.path.ModelName
eg: app.models.PostTagRel
PostTagRel 表需要有到 Post 和 Tag 的关系
~~~
当设置 rel\_table 时会忽略 rel\_through
设置方法：
`orm:"rel(m2m);rel_table(the_table_name)"`
`orm:"rel(m2m);rel_through(pkg.path.ModelName)"`
#### on\_delete
设置对应的 rel 关系删除时，如何处理关系字段。
~~~
cascade 级联删除(默认值)
set_null 设置为 NULL，需要设置 null = true
set_default 设置为默认值，需要设置 default 值
do_nothing 什么也不做，忽略
~~~
~~~
type User struct {
...
Profile *Profile `orm:"null;rel(one);on_delete(set_null)"`
...
}
type Profile struct {
...
User *User `orm:"reverse(one)"`
...
}
// 删除 Profile 时将设置 User.Profile 的数据库字段为 NULL
~~~
#### 关于 on\_delete 的相关例子
~~~
type User struct {
Id int
Name string
}
type Post struct {
Id int
Title string
User *User `orm:"rel(fk)"`
}
~~~
假设 Post -> User 是 ManyToOne 的关系，也就是外键。
~~~
o.Filter("Id", 1).Delete()
~~~
这个时候即会删除 Id 为 1 的 User 也会删除其发布的 Post
不想删除的话，需要设置 set\_null
~~~
type Post struct {
Id int
Title string
User *User `orm:"rel(fk);null;on_delete(set_null)"`
}
~~~
那这个时候，删除 User 只会把对应的 Post.user\_id 设置为 NULL
当然有时候为了高性能的需要，多存点数据无所谓啊，造成批量删除才是问题。
~~~
type Post struct {
Id int
Title string
User *User `orm:"rel(fk);null;on_delete(do_nothing)"`
}
~~~
那么只要删除的时候，不操作 Post 就可以了。
## 模型字段与数据库类型的对应
在此列出 ORM 推荐的对应数据库类型，自动建表功能也会以此为标准。
默认所有的字段都是**NOT NULL**
#### MySQL
| go |mysql
| :/cssjs/widgets.js | :/cssjs/widgets.js
| int, int32 - 设置 auto 或者名称为`Id`时 | integer AUTO\_INCREMENT
| int64 - 设置 auto 或者名称为`Id`时 | bigint AUTO\_INCREMENT
| uint, uint32 - 设置 auto 或者名称为`Id`时 | integer unsigned AUTO\_INCREMENT
| uint64 - 设置 auto 或者名称为`Id`时 | bigint unsigned AUTO\_INCREMENT
| bool | bool
| string - 默认为 size 255 | varchar(size)
| string - 设置 type(char) 时 | char(size)
| string - 设置 type(text) 时 | longtext
| time.Time - 设置 type 为 date 时 | date
| time.Time | datetime
| byte | tinyint unsigned
| rune | integer
| int | integer
| int8 | tinyint
| int16 | smallint
| int32 | integer
| int64 | bigint
| uint | integer unsigned
| uint8 | tinyint unsigned
| uint16 | smallint unsigned
| uint32 | integer unsigned
| uint64 | bigint unsigned
| float32 | double precision
| float64 | double precision
| float64 - 设置 digits, decimals 时 | numeric(digits, decimals)
#### Sqlite3
| go | sqlite3
| :/cssjs/widgets.js | :/cssjs/widgets.js
| int, int32, int64, uint, uint32, uint64 - 设置 auto 或者名称为`Id`时 | integer AUTOINCREMENT
| bool | bool
| string - 默认为 size 255 | varchar(size)
| string - 设置 type(char) 时 | character(size)
| string - 设置 type(text) 时 | text
| time.Time - 设置 type 为 date 时 | date
| time.Time | datetime
| byte | tinyint unsigned
| rune | integer
| int | integer
| int8 | tinyint
| int16 | smallint
| int32 | integer
| int64 | bigint
| uint | integer unsigned
| uint8 | tinyint unsigned
| uint16 | smallint unsigned
| uint32 | integer unsigned
| uint64 | bigint unsigned
| float32 | real
| float64 | real
| float64 - 设置 digits, decimals 时 | decimal
#### PostgreSQL
| go | postgres
| :/cssjs/widgets.js | :/cssjs/widgets.js
| int, int32, int64, uint, uint32, uint64 - 设置 auto 或者名称为`Id`时 | serial
| bool | bool
| string - 若没有指定 size 默认为 text | varchar(size)
| string - 设置 type(char) 时 | char(size)
| string - 设置 type(text) 时 | text
| string - 设置 type(json) 时 | json
| string - 设置 type(jsonb) 时 | jsonb
| time.Time - 设置 type 为 date 时 | date
| time.Time | timestamp with time zone
| byte | smallint CHECK("column" >= 0 AND "column" <= 255)
| rune | integer
| int | integer
| int8 | smallint CHECK("column" >= -127 AND "column" <= 128)
| int16 | smallint
| int32 | integer
| int64 | bigint
| uint | bigint CHECK("column" >= 0)
| uint8 | smallint CHECK("column" >= 0 AND "column" <= 255)
| uint16 | integer CHECK("column" >= 0)
| uint32 | bigint CHECK("column" >= 0)
| uint64 | bigint CHECK("column" >= 0)
| float32 | double precision
| float64 | double precision
| float64 - 设置 digits, decimals 时 | numeric(digits, decimals)
## 关系型字段
其字段类型取决于对应的主键。
* RelForeignKey
* RelOneToOne
* RelManyToMany
* RelReverseOne
* RelReverseMany
- go环境搭建
- 解决go get网络慢的问题
- beego的安装
- bee的安装
- 编辑器
- go module
- 配置文件详解
- 配置文件其他说明
- 路由方法
- 路由
- 数据校验
- 校验函数
- 页面跳转
- 获取前端数据
- json文件的获取
- xsrf的用法
- xsrf的防护
- srfs和json的搭配
- flash的用法
- 过滤器
- url反转
- 各类数据的处理
- 模板函数
- 内置模板函数
- 自定义模板函数
- 模板
- 模板处理
- 模板渲染
- 视图文件的处理
- 静态文件
- 请求方式判断
- 验证码
- 另一种方法
- 分页类
- session
- 登录判断
- orm模块
- 使用方法
- mysql的安装
- 安装orm及驱动
- 建立模型
- 自定义模型
- 增删改查
- 高级查询
- 常见问题汇总
- 代码收藏
- 打包部署
- go build打包
- utils收藏
- 新goer容易犯的错
- 字符串操作