From fcf25c48c42d7e4ac1a89082c8337662d325ff3f Mon Sep 17 00:00:00 2001
From: Jinzhu <wosmvp@gmail.com>
Date: Mon, 7 Mar 2016 23:58:31 +0800
Subject: [PATCH] Update README

---
 documents/associations.md | 97 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 95 insertions(+), 2 deletions(-)

diff --git a/documents/associations.md b/documents/associations.md
index 74e684c9..59b872df 100644
--- a/documents/associations.md
+++ b/documents/associations.md
@@ -5,7 +5,7 @@
 ## Belongs To
 
 ```go
-// User belongs to a profile, ProfileID is the foreign key
+// `User` belongs to `Profile`, `ProfileID` is the foreign key
 type User struct {
   gorm.Model
   Profile   Profile
@@ -14,13 +14,44 @@ type User struct {
 
 type Profile struct {
   gorm.Model
-  Name   string
+  Name string
 }
 
 db.Model(&user).Related(&profile)
 //// SELECT * FROM profiles WHERE id = 111; // 111 is user's foreign key ProfileID
 ```
 
+*Specify Foreign Key*
+
+```go
+type Profile struct {
+	gorm.Model
+	Name string
+}
+
+type User struct {
+	gorm.Model
+	Profile      Profile `gorm:"ForeignKey:ProfileRefer"` // use ProfileRefer as foreign key
+	ProfileRefer int
+}
+```
+
+*Specify Foreign Key & Association Key*
+
+```go
+type Profile struct {
+	gorm.Model
+	Refer string
+	Name  string
+}
+
+type User struct {
+	gorm.Model
+	Profile   Profile `gorm:"ForeignKey:ProfileID;AssociationForeignKey:Refer"`
+	ProfileID int
+}
+```
+
 ## Has One
 
 ```go
@@ -44,6 +75,37 @@ db.Model(&user).Related(&card, "CreditCard")
 db.Model(&user).Related(&card)
 ```
 
+*Specify Foreign Key*
+
+```go
+type Profile struct {
+  gorm.Model
+  Name      string
+  UserRefer uint
+}
+
+type User struct {
+  gorm.Model
+  Profile Profile `gorm:"ForeignKey:UserRefer"`
+}
+```
+
+*Specify Foreign Key & Association Key*
+
+```go
+type Profile struct {
+  gorm.Model
+  Name   string
+  UserID uint
+}
+
+type User struct {
+  gorm.Model
+  Refer   string
+  Profile Profile `gorm:"ForeignKey:UserID;AssociationForeignKey:Refer"`
+}
+```
+
 ## Has Many
 
 ```go
@@ -63,6 +125,37 @@ db.Model(&user).Related(&emails)
 //// SELECT * FROM emails WHERE user_id = 111; // 111 is user's primary key
 ```
 
+*Specify Foreign Key*
+
+```go
+type Profile struct {
+  gorm.Model
+  Name      string
+  UserRefer uint
+}
+
+type User struct {
+  gorm.Model
+  Profile []Profiles `gorm:"ForeignKey:UserRefer"`
+}
+```
+
+*Specify Foreign Key & Association Key*
+
+```go
+type Profile struct {
+  gorm.Model
+  Name   string
+  UserID uint
+}
+
+type User struct {
+  gorm.Model
+  Refer   string
+  Profile []Profiles `gorm:"ForeignKey:UserID;AssociationForeignKey:Refer"`
+}
+```
+
 ## Many To Many
 
 ```go