1. Graphql是什么？
GraphQL是Facebook 在2012年開發(fā)的，2015年開源，2016年下半年Facebook宣布可以在生產(chǎn)環(huán)境使用，而其內(nèi)部早就已經(jīng)廣泛應(yīng)用了，用于替代 REST API。facebook的解決方案和簡(jiǎn)單：用一個(gè)“聰明”的節(jié)點(diǎn)來(lái)進(jìn)行復(fù)雜的查詢，將數(shù)據(jù)按照客戶端的要求傳回去，后端根據(jù)GraphQL機(jī)制提供一個(gè)具有強(qiáng)大功能的接口，用以滿足前端數(shù)據(jù)的個(gè)性化需求，既保證了多樣性，又控制了接口數(shù)量。
GraphQL并不是一門程序語(yǔ)言或者框架，它是描述你的請(qǐng)求數(shù)據(jù)的一種規(guī)范，是協(xié)議而非存儲(chǔ)，GraphQL本身并不直接提供后端存儲(chǔ)的能力，它不綁定任何的數(shù)據(jù)庫(kù)或者存儲(chǔ)引擎，它可以利用已有的代碼和技術(shù)來(lái)進(jìn)行數(shù)據(jù)源管理。
一個(gè)GraphQL查詢是一個(gè)被發(fā)往服務(wù)端的字符串，該查詢?cè)诜?wù)端被解釋和執(zhí)行后返回JSON數(shù)據(jù)給客戶端。
2. Graphql和Rest Api的對(duì)比
RESTful：服務(wù)端決定有哪些數(shù)據(jù)獲取方式，客戶端只能挑選使用，如果數(shù)據(jù)過(guò)于冗余也只能默默接收再對(duì)數(shù)據(jù)進(jìn)行處理；而數(shù)據(jù)不能滿足需求則需要請(qǐng)求更多的接口。
GraphQL：給客戶端自主選擇數(shù)據(jù)內(nèi)容的能力，客戶端完全自主決定獲取信息的內(nèi)容，服務(wù)端負(fù)責(zé)精確的返回目標(biāo)數(shù)據(jù)。提供一種更嚴(yán)格、可擴(kuò)展、可維護(hù)的數(shù)據(jù)查詢方式。
3. Graphql在go語(yǔ)言中使用
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 通過(guò)Id 獲取用戶信息
/*
定義graphql 查詢類型 Resolve 通過(guò)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對(duì)象
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 再也不需要對(duì)接口的文檔進(jìn)行維護(hù)了。
go語(yǔ)言庫(kù)地址：https://github.com/graphql-go/graphql
補(bǔ)充：golang使用http發(fā)送graphql請(qǐng)求
請(qǐng)求內(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請(qǐng)求：
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))
}
以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教。
您可能感興趣的文章:- Golang 實(shí)現(xiàn)分片讀取http超大文件流和并發(fā)控制
- go Http Post 發(fā)送文件流案例
- 在Golang中使用http.FileServer返回靜態(tài)文件的操作
- 解決golang http.FileServer 遇到的坑
- golang HTTP 服務(wù)器 處理 日志/Stream流的操作
- 在go文件服務(wù)器加入http.StripPrefix的用途介紹
