Adding upstream version 1.11.0.
Signed-off-by: Daniel Baumann <daniel@debian.org>
This commit is contained in:
parent
40df376a7f
commit
02cacc5b45
GPG key ID:
FBB4F0E80A80222F
37 changed files with 7317 additions and 0 deletions
281
example_test.go
Normal file
281
example_test.go
Normal file
|
|
@ -0,0 +1,281 @@
|
|||
package dbx_test
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
|
||||
"github.com/pocketbase/dbx"
|
||||
)
|
||||
|
||||
// This example shows how to populate DB data in different ways.
|
||||
func Example_dbQueries() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
|
||||
// create a new query
|
||||
q := db.NewQuery("SELECT id, name FROM users LIMIT 10")
|
||||
|
||||
// fetch all rows into a struct array
|
||||
var users []struct {
|
||||
ID, Name string
|
||||
}
|
||||
q.All(&users)
|
||||
|
||||
// fetch a single row into a struct
|
||||
var user struct {
|
||||
ID, Name string
|
||||
}
|
||||
q.One(&user)
|
||||
|
||||
// fetch a single row into a string map
|
||||
data := dbx.NullStringMap{}
|
||||
q.One(data)
|
||||
|
||||
// fetch row by row
|
||||
rows2, _ := q.Rows()
|
||||
for rows2.Next() {
|
||||
rows2.ScanStruct(&user)
|
||||
// rows.ScanMap(data)
|
||||
// rows.Scan(&id, &name)
|
||||
}
|
||||
}
|
||||
|
||||
// This example shows how to use query builder to build DB queries.
|
||||
func Example_queryBuilder() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
|
||||
// build a SELECT query
|
||||
// SELECT `id`, `name` FROM `users` WHERE `name` LIKE '%Charles%' ORDER BY `id`
|
||||
q := db.Select("id", "name").
|
||||
From("users").
|
||||
Where(dbx.Like("name", "Charles")).
|
||||
OrderBy("id")
|
||||
|
||||
// fetch all rows into a struct array
|
||||
var users []struct {
|
||||
ID, Name string
|
||||
}
|
||||
q.All(&users)
|
||||
|
||||
// build an INSERT query
|
||||
// INSERT INTO `users` (name) VALUES ('James')
|
||||
db.Insert("users", dbx.Params{
|
||||
"name": "James",
|
||||
}).Execute()
|
||||
}
|
||||
|
||||
// This example shows how to use query builder in transactions.
|
||||
func Example_transactions() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
|
||||
db.Transactional(func(tx *dbx.Tx) error {
|
||||
_, err := tx.Insert("user", dbx.Params{
|
||||
"name": "user1",
|
||||
}).Execute()
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
_, err = tx.Insert("user", dbx.Params{
|
||||
"name": "user2",
|
||||
}).Execute()
|
||||
return err
|
||||
})
|
||||
}
|
||||
|
||||
type Customer struct {
|
||||
ID string
|
||||
Name string
|
||||
}
|
||||
|
||||
// This example shows how to do CRUD operations.
|
||||
func Example_crudOperations() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
|
||||
var customer Customer
|
||||
|
||||
// read a customer: SELECT * FROM customer WHERE id=100
|
||||
db.Select().Model(100, &customer)
|
||||
|
||||
// create a customer: INSERT INTO customer (name) VALUES ('test')
|
||||
db.Model(&customer).Insert()
|
||||
|
||||
// update a customer: UPDATE customer SET name='test' WHERE id=100
|
||||
db.Model(&customer).Update()
|
||||
|
||||
// delete a customer: DELETE FROM customer WHERE id=100
|
||||
db.Model(&customer).Delete()
|
||||
}
|
||||
|
||||
func ExampleSchemaBuilder() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
|
||||
db.Insert("users", dbx.Params{
|
||||
"name": "James",
|
||||
"age": 30,
|
||||
}).Execute()
|
||||
}
|
||||
|
||||
func ExampleRows_ScanMap() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
|
||||
user := dbx.NullStringMap{}
|
||||
|
||||
sql := "SELECT id, name FROM users LIMIT 10"
|
||||
rows, _ := db.NewQuery(sql).Rows()
|
||||
for rows.Next() {
|
||||
rows.ScanMap(user)
|
||||
// ...
|
||||
}
|
||||
}
|
||||
|
||||
func ExampleRows_ScanStruct() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
|
||||
var user struct {
|
||||
ID, Name string
|
||||
}
|
||||
|
||||
sql := "SELECT id, name FROM users LIMIT 10"
|
||||
rows, _ := db.NewQuery(sql).Rows()
|
||||
for rows.Next() {
|
||||
rows.ScanStruct(&user)
|
||||
// ...
|
||||
}
|
||||
}
|
||||
|
||||
func ExampleQuery_All() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
sql := "SELECT id, name FROM users LIMIT 10"
|
||||
|
||||
// fetches data into a slice of struct
|
||||
var users []struct {
|
||||
ID, Name string
|
||||
}
|
||||
db.NewQuery(sql).All(&users)
|
||||
|
||||
// fetches data into a slice of NullStringMap
|
||||
var users2 []dbx.NullStringMap
|
||||
db.NewQuery(sql).All(&users2)
|
||||
for _, user := range users2 {
|
||||
fmt.Println(user["id"].String, user["name"].String)
|
||||
}
|
||||
}
|
||||
|
||||
func ExampleQuery_One() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
sql := "SELECT id, name FROM users LIMIT 10"
|
||||
|
||||
// fetches data into a struct
|
||||
var user struct {
|
||||
ID, Name string
|
||||
}
|
||||
db.NewQuery(sql).One(&user)
|
||||
|
||||
// fetches data into a NullStringMap
|
||||
var user2 dbx.NullStringMap
|
||||
db.NewQuery(sql).All(user2)
|
||||
fmt.Println(user2["id"].String, user2["name"].String)
|
||||
}
|
||||
|
||||
func ExampleQuery_Row() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
sql := "SELECT id, name FROM users LIMIT 10"
|
||||
|
||||
// fetches data into a struct
|
||||
var (
|
||||
id int
|
||||
name string
|
||||
)
|
||||
db.NewQuery(sql).Row(&id, &name)
|
||||
}
|
||||
|
||||
func ExampleQuery_Rows() {
|
||||
var user struct {
|
||||
ID, Name string
|
||||
}
|
||||
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
sql := "SELECT id, name FROM users LIMIT 10"
|
||||
|
||||
rows, _ := db.NewQuery(sql).Rows()
|
||||
for rows.Next() {
|
||||
rows.ScanStruct(&user)
|
||||
// ...
|
||||
}
|
||||
}
|
||||
|
||||
func ExampleQuery_Bind() {
|
||||
var user struct {
|
||||
ID, Name string
|
||||
}
|
||||
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
sql := "SELECT id, name FROM users WHERE age>{:age} AND status={:status}"
|
||||
|
||||
q := db.NewQuery(sql)
|
||||
q.Bind(dbx.Params{"age": 30, "status": 1}).One(&user)
|
||||
}
|
||||
|
||||
func ExampleQuery_Prepare() {
|
||||
var users1, users2, users3 []struct {
|
||||
ID, Name string
|
||||
}
|
||||
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
sql := "SELECT id, name FROM users WHERE age>{:age} AND status={:status}"
|
||||
|
||||
q := db.NewQuery(sql).Prepare()
|
||||
defer q.Close()
|
||||
|
||||
q.Bind(dbx.Params{"age": 30, "status": 1}).All(&users1)
|
||||
q.Bind(dbx.Params{"age": 20, "status": 1}).All(&users2)
|
||||
q.Bind(dbx.Params{"age": 10, "status": 1}).All(&users3)
|
||||
}
|
||||
|
||||
func ExampleDB() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
|
||||
// queries data through a plain SQL
|
||||
var users []struct {
|
||||
ID, Name string
|
||||
}
|
||||
db.NewQuery("SELECT id, name FROM users WHERE age=30").All(&users)
|
||||
|
||||
// queries data using query builder
|
||||
db.Select("id", "name").From("users").Where(dbx.HashExp{"age": 30}).All(&users)
|
||||
|
||||
// executes a plain SQL
|
||||
db.NewQuery("INSERT INTO users (name) SET ({:name})").Bind(dbx.Params{"name": "James"}).Execute()
|
||||
|
||||
// executes a SQL using query builder
|
||||
db.Insert("users", dbx.Params{"name": "James"}).Execute()
|
||||
}
|
||||
|
||||
func ExampleDB_Open() {
|
||||
db, err := dbx.Open("mysql", "user:pass@/example")
|
||||
if err != nil {
|
||||
panic(err)
|
||||
}
|
||||
|
||||
var users []dbx.NullStringMap
|
||||
if err := db.NewQuery("SELECT * FROM users LIMIT 10").All(&users); err != nil {
|
||||
panic(err)
|
||||
}
|
||||
}
|
||||
|
||||
func ExampleDB_Begin() {
|
||||
db, _ := dbx.Open("mysql", "user:pass@/example")
|
||||
|
||||
tx, _ := db.Begin()
|
||||
|
||||
_, err1 := tx.Insert("user", dbx.Params{
|
||||
"name": "user1",
|
||||
}).Execute()
|
||||
_, err2 := tx.Insert("user", dbx.Params{
|
||||
"name": "user2",
|
||||
}).Execute()
|
||||
|
||||
if err1 == nil && err2 == nil {
|
||||
tx.Commit()
|
||||
} else {
|
||||
tx.Rollback()
|
||||
}
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue