1
0
mirror of https://github.com/astaxie/beego.git synced 2024-11-25 22:51:29 +00:00
Beego/pkg/client/orm
2020-09-01 21:56:48 +08:00
..
filter Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
hints Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
migration Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
cmd_utils.go movement for global modelCache 2020-09-01 21:56:48 +08:00
cmd.go movement for global modelCache 2020-09-01 21:56:48 +08:00
db_alias_test.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
db_alias.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
db_mysql.go Feature: implement the time precison for time.Time type 2020-08-24 20:23:54 +08:00
db_oracle.go Feature: implement the time precison for time.Time type 2020-08-24 20:23:54 +08:00
db_postgres.go Feature: implement the time precison for time.Time type 2020-08-24 20:23:54 +08:00
db_sqlite.go Fix UT 2020-08-26 04:16:09 +00:00
db_tables.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
db_tidb.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
db_utils.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
db.go Fix UT 2020-08-26 04:16:09 +00:00
do_nothing_orm_test.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
do_nothing_orm.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
filter_orm_decorator_test.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
filter_orm_decorator.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
filter_test.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
filter.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
invocation.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
model_utils_test.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
models_boot.go movement for global modelCache 2020-09-01 21:56:48 +08:00
models_fields.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
models_info_f.go Feature: implement the time precison for time.Time type 2020-08-24 20:23:54 +08:00
models_info_m.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
models_test.go Support etcd 2020-08-29 00:07:33 +08:00
models_utils.go Feature: implement the time precison for time.Time type 2020-08-24 20:23:54 +08:00
models.go movement for global modelCache 2020-09-01 21:56:48 +08:00
orm_conds.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
orm_log.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
orm_object.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
orm_querym2m.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
orm_queryset.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
orm_raw.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
orm_test.go supplement datetime precision UT 2020-08-26 11:51:05 +08:00
orm.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
qb_mysql.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
qb_tidb.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
qb.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
README.md Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
types.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
utils_test.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00
utils.go Merge pull request #4173 from AllenX2018/fix-bug-queryRow 2020-08-23 21:04:34 +08:00

beego orm

Build Status

A powerful orm framework for go.

It is heavily influenced by Django ORM, SQLAlchemy.

Support Database:

Passed all test, but need more feedback.

Features:

  • full go type support
  • easy for usage, simple CRUD operation
  • auto join with relation table
  • cross DataBase compatible query
  • Raw SQL query / mapper without orm model
  • full test keep stable and strong

more features please read the docs

Install:

go get github.com/astaxie/beego/orm

Changelog

  • 2013-08-19: support table auto create
  • 2013-08-13: update test for database types
  • 2013-08-13: go type support, such as int8, uint8, byte, rune
  • 2013-08-13: date / datetime timezone support very well

Quick Start

Simple Usage

package main

import (
	"fmt"
	"github.com/astaxie/beego/orm"
	_ "github.com/go-sql-driver/mysql" // import your used driver
)

// Model Struct
type User struct {
	Id   int    `orm:"auto"`
	Name string `orm:"size(100)"`
}

func init() {
	// register model
	orm.RegisterModel(new(User))

	// set default database
	orm.RegisterDataBase("default", "mysql", "root:root@/my_db?charset=utf8", 30)
	
	// create table
	orm.RunSyncdb("default", false, true)	
}

func main() {
	o := orm.NewOrm()

	user := User{Name: "slene"}

	// insert
	id, err := o.Insert(&user)

	// update
	user.Name = "astaxie"
	num, err := o.Update(&user)

	// read one
	u := User{Id: user.Id}
	err = o.Read(&u)

	// delete
	num, err = o.Delete(&u)	
}

Next with relation

type Post struct {
	Id    int    `orm:"auto"`
	Title string `orm:"size(100)"`
	User  *User  `orm:"rel(fk)"`
}

var posts []*Post
qs := o.QueryTable("post")
num, err := qs.Filter("User__Name", "slene").All(&posts)

Use Raw sql

If you don't like ORMuse Raw SQL to query / mapping without ORM setting

var maps []Params
num, err := o.Raw("SELECT id FROM user WHERE name = ?", "slene").Values(&maps)
if num > 0 {
	fmt.Println(maps[0]["id"])
}

Transaction

o.Begin()
...
user := User{Name: "slene"}
id, err := o.Insert(&user)
if err == nil {
	o.Commit()
} else {
	o.Rollback()
}

Debug Log Queries

In development env, you can simple use

func main() {
	orm.Debug = true
...

enable log queries.

output include all queries, such as exec / prepare / transaction.

like this:

[ORM] - 2013-08-09 13:18:16 - [Queries/default] - [    db.Exec /     0.4ms] - [INSERT INTO `user` (`name`) VALUES (?)] - `slene`
...

note: not recommend use this in product env.

Docs

more details and examples in docs and test

documents