graphql---go http請求使用詳解
1. Graphql是什么?
GraphQL是Facebook 在2012年開發(fā)的,2015年開源,2016年下半年Facebook宣布可以在生產(chǎn)環(huán)境使用,而其內(nèi)部早就已經(jīng)廣泛應(yīng)用了,用于替代 REST API。facebook的解決方案和簡單:用一個“聰明”的節(jié)點來進(jìn)行復(fù)雜的查詢,將數(shù)據(jù)按照客戶端的要求傳回去,后端根據(jù)GraphQL機制提供一個具有強大功能的接口,用以滿足前端數(shù)據(jù)的個性化需求,既保證了多樣性,又控制了接口數(shù)量。
GraphQL并不是一門程序語言或者框架,它是描述你的請求數(shù)據(jù)的一種規(guī)范,是協(xié)議而非存儲,GraphQL本身并不直接提供后端存儲的能力,它不綁定任何的數(shù)據(jù)庫或者存儲引擎,它可以利用已有的代碼和技術(shù)來進(jìn)行數(shù)據(jù)源管理。
一個GraphQL查詢是一個被發(fā)往服務(wù)端的字符串,該查詢在服務(wù)端被解釋和執(zhí)行后返回JSON數(shù)據(jù)給客戶端。
2. Graphql和Rest Api的對比
RESTful:服務(wù)端決定有哪些數(shù)據(jù)獲取方式,客戶端只能挑選使用,如果數(shù)據(jù)過于冗余也只能默默接收再對數(shù)據(jù)進(jìn)行處理;而數(shù)據(jù)不能滿足需求則需要請求更多的接口。
GraphQL:給客戶端自主選擇數(shù)據(jù)內(nèi)容的能力,客戶端完全自主決定獲取信息的內(nèi)容,服務(wù)端負(fù)責(zé)精確的返回目標(biāo)數(shù)據(jù)。提供一種更嚴(yán)格、可擴展、可維護(hù)的數(shù)據(jù)查詢方式。
3. Graphql在go語言中使用
1.定義 graphql 用戶類型userType; Fields為user參數(shù)
/* 定義 graphql 用戶類型userType; Fields為user參數(shù) */ var userType = graphql.NewObject( graphql.ObjectConfig{ Name: "User", Fields: graphql.Fields{ "id": &graphql.Field{ Type: graphql.String, }, "name": &graphql.Field{ Type: graphql.String, }, }, }, )
2.定義graphql 查詢類型 Resolve 通過Id 獲取用戶信息
/* 定義graphql 查詢類型 Resolve 通過Id 獲取用戶信息 */ var queryType = graphql.NewObject( graphql.ObjectConfig{ Name: "Query", Fields: graphql.Fields{ "user": &graphql.Field{ Type: userType, Args: graphql.FieldConfigArgument{ "id": &graphql.ArgumentConfig{ Type: graphql.String, }, }, Resolve: func(p graphql.ResolveParams) (interface{}, error) { idQuery, isOK := p.Args["id"].(string) if isOK { return data[idQuery], nil } return nil, nil }, }, }, })
3.定義 graphql schemad對象
var schema, _ = graphql.NewSchema( graphql.SchemaConfig{ Query: queryType, }, )
4.執(zhí)行查詢方法
func executeQuery(query string, schema graphql.Schema) *graphql.Result { result := graphql.Do(graphql.Params{ Schema: schema, RequestString: query, }) if len(result.Errors) > 0 { fmt.Printf("wrong result, unexpected errors: %v", result.Errors) } return result }
5.main 函數(shù)執(zhí)行:
import ( "encoding/json" "fmt" "io/ioutil" "net/http" "github.com/graphql-go/graphql" ) type user struct { ID string `json:"id"` Name string `json:"name"`}var data map[string]user func main() { data = make(map[string]user) data["1"] = user{ ID: "1", Name: "wt", } data["2"] = user{ ID: "2", Name: "go", } http.HandleFunc("/graphql", func(w http.ResponseWriter, r *http.Request) { result := executeQuery(r.URL.Query().Get("query"), schema) json.NewEncoder(w).Encode(result) }) http.ListenAndServe(":8080", nil) }
4. 結(jié)果輸出,總結(jié)
游覽器輸入:
http://127.0.0.1:8080/graphql?query={user(id:"1"){id,name}}
輸出結(jié)果:
{"data":{"user":{"id":"1","name":"wt"}}}
使用 graphql 再也不需要對接口的文檔進(jìn)行維護(hù)了。
go語言庫地址:https://github.com/graphql-go/graphql
補充:golang使用http發(fā)送graphql請求
請求內(nèi)容:
query格式:
query UnitList($Ids: String!, $offset: Int! ){UnitList(searchParams: {Ids: $Ids, offset: $offset}, searchType: BASE) {list { score score_addbusinesstravel UnitTags commentScore } isOver count}}
data數(shù)據(jù):
{"Ids":"123","offset":0}
get/post發(fā)送http請求:
package main import ( "fmt" "strings" "net/http" "io/ioutil" ) func main() { url := "http://**************/graphql/" method := "POST" / "GET" payload := strings.NewReader("{\"query\":\"query UnitList($Ids: String!, $offset: Int!,){UnitList(searchParams: {Ids: $Ids, offset: $offset}, searchType: BASE) {list { score score_addbusinesstravel UnitTags commentScore } isOver count}}\",\"variables\":{\"luIds\":\"123\",\"offset\":0}}") client := &http.Client { } req, err := http.NewRequest(method, url, payload) if err != nil { fmt.Println(err) } req.Header.Add("Content-Type", "application/json") res, err := client.Do(req) defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) fmt.Println(string(body)) }
以上為個人經(jīng)驗,希望能給大家一個參考,也希望大家多多支持腳本之家。如有錯誤或未考慮完全的地方,望不吝賜教。
相關(guān)文章
Golang Gin框架實現(xiàn)多種數(shù)據(jù)格式返回結(jié)果詳解
這篇文章主要介紹了Golang Gin框架實現(xiàn)多種數(shù)據(jù)格式返回結(jié)果,我們都知道,一個完整的請求包含請求和處理請求以及結(jié)果返回三個步驟,在服務(wù)器端對請求處理完成以后,會將結(jié)果返回給客戶端,在gin框架中,支持返回多種請求數(shù)據(jù)格式,下面我們一起來看看2023-05-05Golang中由零值和gob庫特性引起B(yǎng)UG解析
這篇文章主要為大家介紹了Golang中由零值和gob庫特性引起B(yǎng)UG解析,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-04-04golang DNS服務(wù)器的簡單實現(xiàn)操作
這篇文章主要介紹了golang DNS服務(wù)器的簡單實現(xiàn)操作,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2021-04-04