บทเรียนการสร้าง API ด้วยภาษา Go สำหรับผู้เริ่มต้นในการพัฒนา Web API เพื่อทำส่วนต่อประสานโปรแกรมเบื้องต้นโดยใช้ package ของ net-http
บทเรียนก่อนหน้า : รวมบทเรียนภาษา go
เริ่มต้นสร้าง Package ของเราขึ้นมา ชื่อ golang แล้วสร้าง directory สำหรับทำ api ขึ้นมาชื่อว่า “api” โดยรันคำสั่งต่อไปนี้:
|
1 2 |
$ mkdir api $ cd api |
เปิด Folder API ขึ้นมาสร้างไฟล์ index.go แล้วเขียนคำสั่งต่อไปนี้:
|
1 2 3 4 5 6 7 |
package main import ( "fmt" ) func main() { fmt.Println("Test API") } |
ลองรันคำสั่งทดสอบก่อนโดยเปิด Terminal ขึ้นมาพิมพ์ว่า:
|
1 |
$ go run index.go |
ถ้ามี Console รันคำสั่ง PrintIn ก็โอเคครับ
ต่อมาทำการ Import Package สำหรับจัดการเว็บ net-http และ json กันหน่อยโดยเพิ่ม
|
1 2 |
"encoding/json" "net/http" |
โดยการประกาศเพิ่มดังนี้:
|
1 2 3 4 5 |
import ( "encoding/json" "fmt" "net/http" ) |
ทำการสร้าง โครงสร้างข้อมูล Struct ขึ้นมาเพื่อนำมาแสดงผลผ่าน JSON ในรูปแบบ Key-Value ชื่อว่า userData
|
1 2 3 4 5 6 |
type userData struct { Userid int Firstname string Lastname string Email string } |
ข้อสังเกต Key ของ Struct ในภาษา Go จำเป็นต้องขึ้นต้นด้วย Capital หรืออักษรตัวใหญ่, ดังนั้นเราต้องเอา Struct ของ userData มาทำเป็นข้อมูล value ผ่านฟังก์ชันใหม่คือ getUsers ดังนี้:
|
1 2 3 4 5 6 7 8 9 |
func getUsers(w http.ResponseWriter, r *http.Request) { //(2) userResponse := userData{ Userid: 28566777, Firstname: "Banyapon", Lastname: "Poolsawas", Email: "banyaponil@daydev.com", } json.NewEncoder(w).Encode(userResponse) } |
ใช้ Package “encoding/json” เข้ามาช่วยแปลง Struct เป็น JSON โดยอัดข้อมูลเข้าไปโดยตรงซึ่งเป็นข้อมูลปลอม ยัดเข้าไปใน userResponse โดยตรงเพื่อทำการ json Encoder
สร้างฟังก์ชันใหม่ชื่อว่า handleRequest()
|
1 2 3 4 5 |
func handleRequest() { http.HandleFunc("/", users) http.HandleFunc("/users", getUsers) http.ListenAndServe(":8080", nil) } |
กลับไปที่ func Main( ) ให้เปลี่ยนการเรียกคำสั่งเป็น:
|
1 2 3 4 |
func main() { //fmt.Println("Test API") handleRequest() } |
ภาพรวม code ของ index.go จะเป็นดังนี้:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 |
package main import ( "encoding/json" "fmt" "net/http" ) type userData struct { Userid int Firstname string Lastname string Email string } func getUsers(w http.ResponseWriter, r *http.Request) { userResponse := userData{ Userid: 28566777, Firstname: "Banyapon", Lastname: "Poolsawas", Email: "banyaponil@daydev.com", } json.NewEncoder(w).Encode(userResponse) } func users(w http.ResponseWriter, r *http.Request) { fmt.Fprint(w, "success") } func handleRequest() { http.HandleFunc("/", users) http.HandleFunc("/users", getUsers) http.ListenAndServe(":8080", nil) } func main() { //fmt.Println("Test API") handleRequest() } |
ทำการรันคำสั่งใน Terminal แล้วทดสอบที่ http://localhost:8080/users
ผลลัพธ์:
