차세대 API를 위한 3가지 Go 기반 GraphQL 패키지
Go와 이러한 편리한 패키지를 사용하여 GraphQL 언어를 마스터하세요.
GraphQL은 RESTful API를 구축하는 동안 직면하게 되는 대부분의 문제를 해결하는 HTTP 기반 사양입니다. 하나의 엔드포인트를 사용하여 여러 스키마의 데이터에 액세스할 수 있으므로 복잡한 API를 구축하는 데 적합합니다.
GraphQL은 REST에서 초과 가져오기 및 부족 가져오기와 같은 문제를 완화합니다. 추가 API 호출 없이 특정 필드를 요청하는 클라이언트를 구축할 수 있습니다.
서버에서 API에 이르기까지 GraphQL 기반 애플리케이션을 구축하는 데 활용할 수 있는 여러 Go 패키지가 있습니다.
1. gqlgen 패키지
gqlgen(GraphQL Generator)은 GraphQL 서버 및 API를 생성하고 구축하기 위한 기능이 풍부하고 유형이 안전한 패키지입니다.
gqlgen 패키지는 GraphQL SDL을 사용하여 스키마를 정의하는 스키마 우선 접근 방식을 취합니다. 그런 다음 GraphQL 서버 및 API를 설정하기 위해 조정할 수 있는 상용구 코드를 생성합니다.
gqlgen은 Go 생태계에서 더욱 완벽한 GraphQL 패키지 중 하나입니다. 패키지를 사용하여 문서와 예제를 생성하고 쿼리, 변형 및 구독을 생성할 수 있습니다.
gqlgen은 유형 바인딩, 임베딩, 인터페이스, 생성된 입력 및 열거형을 보장합니다. 이 패키지는 또한 오픈 추적, 오류 로깅을 위한 후크, 데이터 로드, 동시성 및 증가된 쿼리 복잡성을 위한 기능을 제공합니다.
스키마 우선 라이브러리와 마찬가지로 GraphQL 스키마를 정의한 후 gqlgen 명령줄 앱을 사용하여 프로젝트의 스키마에서 상용구 코드를 생성합니다.
작업 디렉터리에 tools.go 파일을 만들고 gqlgen 패키지를 포함하도록 다음 코드 줄을 추가합니다.
// +build tools
package tools
import _ "github.com/99designs/gqlgen"tools.go 파일은 gqlgen 패키지용 빌드 도구를 지정합니다.
작업 디렉터리에서 다음 명령을 실행하여 gqlgen 패키지와 해당 종속성을 설치합니다.
go install github.com/99designs/gqlgen@latest
go mod tidyinit 명령을 인수로 사용하여 GraphQL 패키지를 실행할 때 새 GraphQL 프로젝트를 초기화할 수 있습니다.
go run github.com/99designs/gqlgen init
프로젝트를 초기화하려면 작업 디렉터리에 있는 schema.graphql 파일에 스키마가 있어야 합니다.
GraphQL 앱에 기능을 추가한 후 server.go 파일을 실행하여 GraphQL 서버를 시작하세요.
go run server.go2. graphql-go 패키지
graphql-go 패키지는 Go에서 GraphQL 서비스를 구축하기 위한 완전한 GraphQL 초안 사양을 제공하는 것을 목표로 하는 인기 있는 GraphQL 라이브러리입니다.
graphql-go 패키지는 런타임 유형 접근 방식을 취합니다. Go 코드에서 스키마를 선언할 수 있는 옵션이 있으며 패키지는 런타임에 확인합니다.
쿼리, 변형 및 구독을 구현하고 패키지로 예제를 생성할 수 있지만 생성된 열거형, 입력 또는 오픈 추적에 대한 기능은 없습니다.
graphql-go는 내장 패키지와 널리 사용되는 타사 패키지를 모두 지원하는 최소한의 API를 제공합니다. OpenTelemetry 및 OpenTracing 표준, 확인자에 대한 스키마 유형 검사, 확인자의 병렬 실행 및 기타 여러 기능을 지원합니다.
http 패키지를 사용하여 Go에서 RESTful 서비스를 구축하는 데 익숙하다면 graphql-go 패키지를 사용하기 쉽다는 것을 알게 될 것입니다.
작업 디렉터리에서 다음 명령을 실행하여 graphql-go 패키지와 해당 종속성을 프로젝트에 추가합니다.
go get github.com/graph-gophers/graphql-go
다음은 간단한 GraphQL 서버를 시작하는 예입니다.
package main
import (
"log"
"net/http"
graphql "github.com/graph-gophers/graphql-go"
"github.com/graph-gophers/graphql-go/relay"
)
type query struct{}
func (_ *query) Hello() string { return "Hello, world!" }
func main() {
schemaExample := `
type Query {
hello: String!
}
`
schema := graphql.MustParseSchema(schemaExample, &query{})
http.Handle("/query", &relay.Handler{Schema: schema})
log.Fatal(http.ListenAndServe(":8080", nil))
}
query 구조체의 Hello 메서드는 hello world를 반환하는 GraphQL 엔드포인트에 대한 해석기입니다. schemaExample 변수는 스키마 정의이며 서버는 http 패키지의 ListenAndServe 메소드를 사용하여 포트 8080에서 실행됩니다.
3. 썬더 패키지
Thunder 프레임워크는 구조체 우선 접근 방식을 취합니다. GraphQL 스키마를 모델링하는 구조체를 선언합니다. Go 데이터에서 GraphQL 스키마를 생성하여 쿼리 일괄 처리, 라이브 쿼리, 변형, 구독 및 예제 생성을 처리합니다.
Thunder는 리플렉션 기반 스키마 구축, 내장형 병렬 실행 및 일괄 처리, 내장형 GraphiQL 편집기, 대규모 GraphQL 서버를 위한 분할 스키마를 포함한 유형 바인딩 및 기타 기능을 통해 유형 안전성을 제공합니다.
Thunder 패키지에는 임베딩, 인터페이스, 생성된 열거형 또는 입력, 페더레이션, 공개 추적 또는 사용자 정의 오류에 대한 기능이 없습니다. 그러나 다른 인기 패키지에 비해 사용하기 가장 쉬운 패키지 중 하나이며 GraphQL 경험이 없는 경우 시작하기에 탁월한 패키지입니다.
Thunder 패키지와 해당 종속성을 설치하려면 작업 디렉터리의 터미널에서 이 명령을 실행해야 합니다.
go get github.com/samsarahq/thunder/graphql
Thunder 패키지로 간단한 GraphQL 서버를 시작하려면 스키마에 대한 구조체 모델을 선언하고, 해석기를 작성하고, 서버를 인스턴스화해야 합니다.
import (
"context"
"net/http"
"time"
"github.com/samsarahq/thunder/graphql"
"github.com/samsarahq/thunder/graphql/graphiql"
"github.com/samsarahq/thunder/graphql/introspection"
"github.com/samsarahq/thunder/graphql/schemabuilder"
"github.com/samsarahq/thunder/reactive"
)
type post struct {
Title string
Body string
CreatedAt time.Time
}
// server is our graphql server.
type server struct {
posts []post
}
// registerQuery registers the root query type.
func (s *server) registerQuery(schema *schemabuilder.Schema) {
obj := schema.Query()
obj.FieldFunc("posts", func() []post {
return s.posts
})
}
// registerMutation registers the root mutation type.
func (s *server) registerMutation(schema *schemabuilder.Schema) {
obj := schema.Mutation()
obj.FieldFunc("echo", func(args struct{ Message string }) string {
return args.Message
})
}
// registerPost registers the post type.
func (s *server) registerPost(schema *schemabuilder.Schema) {
obj := schema.Object("Post", post{})
obj.FieldFunc("age", func(ctx context.Context, p *post) string {
reactive.InvalidateAfter(ctx, 5*time.Second)
return time.Since(p.CreatedAt).String()
})
}
// schema builds the graphql schema.
func (s *server) schema() *graphql.Schema {
builder := schemabuilder.NewSchema()
s.registerQuery(builder)
s.registerMutation(builder)
s.registerPost(builder)
return builder.MustBuild()
}
func main() {
// Instantiate a server, build a server, and serve the schema on port 3030.
server := &server{
posts: []post{
{Title: "first post!", Body: "I was here first!", CreatedAt: time.Now()},
{Title: "graphql", Body: "did you hear about Thunder?", CreatedAt: time.Now()},
},
}
schema := server.schema()
introspection.AddIntrospectionToSchema(schema)
// Expose schema and graphiql.
http.Handle("/graphql", graphql.Handler(schema))
http.Handle("/graphiql/", http.StripPrefix("/graphiql/", graphiql.Handler()))
http.ListenAndServe(":3030", nil)
}
post 구조체는 GraphQL 스키마의 모델이고 server 구조체는 서버 인스턴스입니다. registerQuery, registerMutation 및 registerPost 메소드는 쿼리, 변형 및 데이터 저장을 위한 확인 함수입니다.
main 기능은 3030 포트의 GraphQL 서버와 GraphQL 편집기로 시작됩니다.
내장 패키지를 사용하여 Go에서 GraphQL API를 쿼리할 수 있습니다.
GraphQL은 HTTP 기반이며 내장된 http 패키지 및 RESTful API와 유사한 기타 패키지와 함께 GraphQL API를 사용할 수 있습니다. Go 생태계에는 GraphQL API를 빠르게 사용할 수 있는 패키지도 있습니다.



