From 692b08a7be760d9ddd1c770fc7e589feabbac2e1 Mon Sep 17 00:00:00 2001 From: Jinzhu Date: Mon, 28 Oct 2013 08:08:45 +0800 Subject: [PATCH] Update README --- README.md | 50 +++++++++++++++++++++++++++++--------------------- 1 file changed, 29 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 946885b7..19c5c2f3 100644 --- a/README.md +++ b/README.md @@ -34,49 +34,49 @@ db.Where("name = ?", "jinzhu").First(&user) db.Where("name = ?", "jinzhu").Find(&users) // Advanced Where Usage -// select * from users name <> 'jinzhu'; +//// select * from users name <> 'jinzhu'; db.Where("name <> ?", "jinzhu").Find(&users) -// select * from users name = 'jinzhu' and age >= 22; +//// select * from users name = 'jinzhu' and age >= 22; db.Where("name = ? and age >= ?", "jinzhu", "22").Find(&users) -// select * from users name in ('jinzhu', 'jinzhu 2'); +//// select * from users name in ('jinzhu', 'jinzhu 2'); db.Where("name in (?)", []string["jinzhu", "jinzhu 2"]).Find(&users) db.Where("birthday < ?", time.Now()).Find(&users) // Inline search condition -// select * from users where id = 23 limit 1; +//// select * from users where id = 23 limit 1; db.First(&user, 23) -// select * from users where name = "jinzhu" limit 1; +//// select * from users where name = "jinzhu" limit 1; db.First(&user, "name = ?", "jinzhu") -// select * from users where name = "jinzhu"; +//// select * from users where name = "jinzhu"; db.Find(&users, "name = ?", "jinzhu") -// select * from users where name <> "jinzhu" and age > 20; +//// select * from users where name <> "jinzhu" and age > 20; db.Find(&users, "name <> ? and age > ?", "jinzhu", 20) // Select -// select name from users; +//// select name from users; db.Select("name").Find(&users) // Order -// select * from users order by age desc, name; +//// select * from users order by age desc, name; db.Order("age desc, name").Find(&users) db.Order("age desc").Order("name").Find(&users) // Limit -// select * from users limit 3; +//// select * from users limit 3; db.Limit(3).Find(&users) db.Limit(10).Find(&ten_users).Limit(20).Find(&twenty_users).Limit(-1).Find(&all_users) // Offset -// select * from users offset 3; +//// select * from users offset 3; db.Offset(3).Find(&users) db.Offset(10).Find(&users).Offset(20).Find(&users).Offset(-1).Find(&users) // Or -// select * from users where role = 'admin' or role = 'super_admin'; +//// select * from users where role = 'admin' or role = 'super_admin'; db.Where("role = ?", "admin").Or("role = ?", "super_admin").Find(&users) // Count -// select count(*) from users where name = 'jinzhu' or name = 'jinzhu 2''; +//// select count(*) from users where name = 'jinzhu' or name = 'jinzhu 2''; db.Where("name = ?", "jinzhu").Or("name = ?", "jinzhu 2").Find(&users).Count(&count) db.Model(&User{}).Where("name = ?", "jinzhu").Count(&count) @@ -105,7 +105,8 @@ Callbacks is a function defined to a model, if the function return error, will p // Pluck (get users's age as map) var ages []int64 -db.Find(&users).Pluck("age", &ages) +//// select age from users; +db.Find(&users).Pluck("age", &ages) // ages => []int64{18, 10, 99...} var names []string db.Model(&User{}).Pluck("name", &names) @@ -119,25 +120,30 @@ db.CreateTable(&User{}) db.Exec("drop table users;") ``` -## Cool Examples +## Advanced Usage With Query Chain ```go // Already excited about the basic usage? Let's see some magic! db.First(&first_article).Count(&total_count).Limit(10).Find(&first_page_articles).Offset(10).Find(&second_page_articles) -// first_article return the latest article -// total_count return the total numbers of articles -// first_page_articles return the latest 10 articles -// second_page_articles return the latest 10 to 20 articles +// first_article -> select * from articles limit 1 +// total_count -> select count(*) from articles +// first_page_articles -> select * from articles limit 10 +// second_page_articles -> select * from articles limit 10 offset 10 db.Where("created_at > ?", "2013/10/10").Find(&cancelled_orders, "state = ?", "cancelled").Find(&shipped_orders, "state = ?", "shipped") -// cancelled_orders return all cancelled orders since 2013/10/10 -// shipped_orders return all shipped orders since 2013/10/10 +// cancelled_orders -> select * from orders where created_at > '2013/10/10' and state = 'cancelled' +// shipped_orders -> select * from orders where created_at > '2013/10/10' and state = 'shipped' db.Model(&Order{}).Where("amount > ?", 10000).Pluck("user_id", &paid_user_ids) +// paid_user_ids -> select user_id from orders where amount > 10000 db.Where("user_id = ?", paid_user_ids).Find(&:paid_users) +// paid_users -> select * from users where user_id in (10, 20, 99) db.Where("product_name = ?", "fancy_product").Find(&orders).Find(&shopping_cart) +// orders -> select * from orders where product_name = 'fancy_product' +// shopping_cart -> select * from carts where product_name = 'fancy_product' +// Do you noticed the search table is different for above query, yay // Open your mind, add more cool examples ``` @@ -150,6 +156,8 @@ db.Where("product_name = ?", "fancy_product").Find(&orders).Find(&shopping_cart) * SQL Log * Auto Migration * Index, Unique, Valiations +* SQL Query with goroutines +* Only tested with postgres, confirm works with other database adaptors # Author