小白可以看懂的「GraphQL」，GraphQL到底是啥样

GraphQL是一种用于API的查询语言，可以在服务端定义GraphQL Schema，客户端可以向服务端发送GraphQL请求，服务端执行GraphQL查询，并将结果作为JSON返回给客户端。

下面是一个使用golang实现GraphQL的示例，首先需要安装golang的GraphQL库github.com/graphql-go/graphql。

第一步定义GraphQL Schema

package mainimport "github.com/graphql-go/graphql"// 定义User结构体
type User struct {ID   intName stringAge  int
}// 定义GraphQL Schema
var Schema, _ = graphql.NewSchema(graphql.SchemaConfig{Query: graphql.NewObject(graphql.ObjectConfig{Name: "Query",Fields: graphql.Fields{// 定义getUser查询，查询一个用户的信息"getUser": &graphql.Field{Type: UserObject,Args: graphql.FieldConfigArgument{"id": &graphql.ArgumentConfig{Type: graphql.Int,},},Resolve: func(p graphql.ResolveParams) (interface{}, error) {// 处理getUser查询的逻辑userID, ok := p.Args["id"].(int)if !ok {return nil, nil}var user = User{ID:   userID,Name: "Tom",Age:  18,}return user, nil},},},}),
})// 定义User类型
var UserObject = graphql.NewObject(graphql.ObjectConfig{Name: "User",Fields: graphql.Fields{"id": &graphql.Field{Type: graphql.Int,},"name": &graphql.Field{Type: graphql.String,},"age": &graphql.Field{Type: graphql.Int,},},
})

以上代码中，定义了一个叫做User的类型，以及一个叫做getUser的查询，getUser查询需要一个名为id的参数，返回一个User类型的对象。

② 执行GraphQL查询

package mainimport ("encoding/json""fmt""net/http""github.com/graphql-go/graphql""github.com/graphql-go/handler"
)func main() {// 定义http请求处理函数http.Handle("/graphql", handler.New(&handler.Config{Schema: &Schema,Pretty: true,}))// 启动http服务fmt.Println("Server running on port 8080")http.ListenAndServe(":8080", nil)
}

以上代码中，使用github.com/graphql-go/handler库创建一个http处理器，并监听8080端口。

接下来，可以使用HTTP Client来测试GraphQL查询：

package mainimport ("bytes""encoding/json""fmt""net/http"
)func main() {// 定义GraphQL查询query := `query getUser($id:Int!) {user:getUser(id:$id) {idnameage}}`// 定义查询参数params := struct {Query     string      `json:"query"`Variables interface{} `json:"variables"`}{Query: query,Variables: map[string]interface{}{"id": 1,},}// 将查询参数编码为JSON格式requestBody, _ := json.Marshal(params)// 发送GraphQL查询请求resp, _ := http.Post("http://localhost:8080/graphql", "application/json", bytes.NewBuffer(requestBody))// 读取查询结果var result struct {Data   interface{} `json:"data"`Errors []struct {Message string `json:"message"`} `json:"errors"`}json.NewDecoder(resp.Body).Decode(&result)// 处理查询结果if len(result.Errors) > 0 {fmt.Println(result.Errors[0].Message)} else {fmt.Printf("%+v\n", result.Data)}
}

以上代码中，定义了一个叫做getUser的查询，并且将查询变量id的值设置为1。将查询参数编码为JSON格式，并通过HTTP Post发送GraphQL查询请求。最后，处理查询结果并打印到控制台。