graphql---go http请求使用详解

(编辑:jimmy 日期: 2024/12/24 浏览:2)

1. Graphql是什么?

GraphQL是Facebook 在2012年开发的,2015年开源,2016年下半年Facebook宣布可以在生产环境使用,而其内部早就已经广泛应用了,用于替代 REST API。facebook的解决方案和简单:用一个“聪明”的节点来进行复杂的查询,将数据按照客户端的要求传回去,后端根据GraphQL机制提供一个具有强大功能的接口,用以满足前端数据的个性化需求,既保证了多样性,又控制了接口数量。

GraphQL并不是一门程序语言或者框架,它是描述你的请求数据的一种规范,是协议而非存储,GraphQL本身并不直接提供后端存储的能力,它不绑定任何的数据库或者存储引擎,它可以利用已有的代码和技术来进行数据源管理。

一个GraphQL查询是一个被发往服务端的字符串,该查询在服务端被解释和执行后返回JSON数据给客户端。

2. Graphql和Rest Api的对比

RESTful:服务端决定有哪些数据获取方式,客户端只能挑选使用,如果数据过于冗余也只能默默接收再对数据进行处理;而数据不能满足需求则需要请求更多的接口。

GraphQL:给客户端自主选择数据内容的能力,客户端完全自主决定获取信息的内容,服务端负责精确的返回目标数据。提供一种更严格、可扩展、可维护的数据查询方式。

3. Graphql在go语言中使用

1.定义 graphql 用户类型userType; Fields为user参数

/*
定义 graphql 用户类型userType; Fields为user参数
 */
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.执行查询方法

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 函数执行:

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. 结果输出,总结

游览器输入:

http://127.0.0.1:8080/graphql"1"){id,name}}

输出结果:

{"data":{"user":{"id":"1","name":"wt"}}}

使用 graphql 再也不需要对接口的文档进行维护了。

go语言库地址:https://github.com/graphql-go/graphql

补充:golang使用http发送graphql请求

请求内容:

query格式:

query UnitList($Ids: String!, $offset: Int! ){UnitList(searchParams: {Ids: $Ids, offset: $offset}, searchType: BASE) {list { score score_addbusinesstravel UnitTags commentScore } isOver count}}

data数据:

{"Ids":"123","offset":0}

get/post发送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))
}

以上为个人经验,希望能给大家一个参考,也希望大家多多支持。如有错误或未考虑完全的地方,望不吝赐教。

一句话新闻

一文看懂荣耀MagicBook Pro 16
荣耀猎人回归!七大亮点看懂不只是轻薄本,更是游戏本的MagicBook Pro 16.
人们对于笔记本电脑有一个固有印象:要么轻薄但性能一般,要么性能强劲但笨重臃肿。然而,今年荣耀新推出的MagicBook Pro 16刷新了人们的认知——发布会上,荣耀宣布猎人游戏本正式回归,称其继承了荣耀 HUNTER 基因,并自信地为其打出“轻薄本,更是游戏本”的口号。
众所周知,寻求轻薄本的用户普遍更看重便携性、外观造型、静谧性和打字办公等用机体验,而寻求游戏本的用户则普遍更看重硬件配置、性能释放等硬核指标。把两个看似难以相干的产品融合到一起,我们不禁对它产生了强烈的好奇:作为代表荣耀猎人游戏本的跨界新物种,它究竟做了哪些平衡以兼顾不同人群的各类需求呢?