mercari.go #2 登壇資料です https://mercari.connpass.com/event/95665/
GoͰGraphQLαʔόΛཱͯΔͧʂmercari.go #2Θ͔Ί ·͞ͻΖ#mercarigobit.ly/2vyiluP
View Slide
Θ͔Ί ·͞ͻΖ @v vakameMasahiro WakameGAE/GoTypeScriptٕज़ॻయ
TL;DR•GraphQLͬͯԿʁ•GitHub v4 APIΛ৮ͬͯΈΔ•github.com/99designs/gqlgen•ઃܭϕετϓϥΫςΟεΫϥΠΞϯτͷ͠ͳ͍
GraphQLͬͯԿʁࡉ͔͍͜ͱ࠷ޙͷࢀߟࢿྉूͰʂ
GraphQLͬͯԿʁ•Facebook͕2015ʹެ։༷ͨ͠•άϥϑߏʹର͢ΔQuery Language•༑ୡͷ༑ୡΛ5ਓͣͭऔಘ͢Δͱ͔•Client→Serverͷσʔλཁٻ࣌ʹ͏
GraphQLͬͯԿʁRESTͳΒ3RPCඞཁ GraphQLͳΒ1ճ{circle(id: "Q2lyY2xlRXhoaWJpdEluZm86MTIzNAo") {namespacespenNamewebSiteURLgenregenreFreeFormatproducts(first: 9) {pageInfo { hasNextPage endCursor }nodes {namedescriptiontypepagepricerelatedURLsfirstAppearanceEventNamefirstAtTechBookFestimages {urlheightwidth}}}loginUserChecked {checked}}}
େࣄͳ͜ͱ•ΘΓͱ੍͋Δ (N+1ରࡦͱ͔)•ແݶʹૣ͘ͳ͍•REST APIͷ্ҐޓͰͳ͍•ࠩҟΛΑ͘ཧղ͠Α͏
ϝϧΧϦͰͬͯΔʁ•C Sπʔϧ PHP+webonyx/graphql-php•US ϝϧΧϦWeb ???•MicroserviceԽ CSπʔϧ Go+gqlgen•ϝϧΧϦWeb Node.js+Apollo•ϝϧϖΠ CSπʔϧ(ݕ౼த) Go+gqlgenٕज़ॻయWeb࣮ݧதͰ͢
ClientͷྲྀΕ•·ͣSchema(+αʔό)͕͋Δ•ͦ͜ʹOperationΛ͛Δ•Query, Mutation, Subscribe ͷ3छ•ཁٻͨ͠௨ΓͷܗࣜͰσʔλདྷΔ
Queryͷྫ{viewer {idloginnamelocationbiocompanyrepositoriesContributedTo(first: 2) {nodes {owner {login}name}}}}{"data": {"viewer": {"id": "MDQ6VXNlcjEyNTMzMg==","login": "vvakame","name": "Masahiro Wakame","location": "Tokyo, Japan","bio": "TypeScript and GAE/Go","company": "Merpay, Inc.","repositoriesContributedTo": {"nodes": [{"owner": {"login": "mruby"},"name": "mruby"},{"owner": {"login": "DefinitelyTyped"},"name": "DefinitelyTyped"}]}}}}ରԠͨ͠ߏ͕ฦΔ
ClientͷྲྀΕ•ͭ·Γ…•ΫΤϦʹΑͬͯಘΒΕΔσʔλ͕มΘΔ•ΫΤϦݸผʹฦΓͷσʔλͷܕཉ͍͠•→ݴޠʹΑ͍ͬͯͮΒ͍Մೳੑʁ·͊JSͱ૬ੑྑͦ͞͏ͳͷΘ͔Δ
ͬ͘͟ΓServerݪཧ•Query͕དྷΔ•ฦ͢σʔλTreeߏʹͳΔ•Treeͷઅ(ͱ͔)ຖʹResolverΛఆٛ͢Δ•Resolver͕ཁٻ͞ΕͨNodeΛੜ͠ฦ͢•Resolverͷू߹ == αʔόͷ࣮
ͬ͘͟ΓServerݪཧtype ResolverRoot interface {Query() QueryResolverUser() UserResolverCircleExhibitInfo() CircleExhibitInfoResolverProductInfo() ProductInfoResolver}type QueryResolver interface {Circle(ctx context.Context, id string) (*CircleExhibitInfo,}type CircleExhibitInfoResolver interface {ID(ctx context.Context, obj *CircleExhibitInfo) (string, errProducts(ctx context.Context, obj *CircleExhibitInfo, first}type ProductInfoResolver interface {ID(ctx context.Context, obj *ProductInfo) (string, error)Images(ctx context.Context, obj *ProductInfo) ([]Image, erro}query {circle(id: "Q2lyY2xlRXhoaWJpdEluZm86MTIzNAo") {namespacespenNamewebSiteURLgenregenreFreeFormatproducts(first: 9) {pageInfo { hasNextPage endCursor }nodes {namedescriptiontypepagepricerelatedURLsfirstAppearanceEventNamefirstAtTechBookFestimages {urlheightwidth}}}loginUserChecked {checked}}
ͬ͘͟ΓServerݪཧResolverͷू߹ʹαʔόͷ࣮
͖͜͜•୯ҰΤϯυϙΠϯτ•Introspection•SchemaΛΔʹGraphQL͕͑Δ•ڧ͍ܕ͚ʂ
GitHub v4 APIΛ৮Δ
৮Γ·͠ΐ͏•developer.github.com/v4/explorer/•GraphiQLʹ৮ΕΔ•GitHubͷߟ͑ͨ࠷ڧͷઃܭʹ৮ΕΔ•͋ΘΑͬͯ͘ΈΔ
σϞ•ϩάΠϯϢʔβͷ໊લग़͢•ҙͷϦϙδτϦ͕࡞ΒΕͨग़͢•GraphQLʹؔ࿈ͷ͋ΔUserΛநग़͢Δ
ίʔυ͔Β•దʹPOST͢Δ͚ͩ•Authorization: bearer ${PersonalAccessToken}•https://api.github.com/graphql•https://github.com/settings/tokensbit.ly/2Oo8DlD
github.com/99designs/gqlgenI’m committer!
ͳͥGoͳͷ͔ʁ•Go͍͠ฒߦॲཧ؆୯ͩ͠•Microservice܈͕GoͳͷͰ…ʂ•GAE/GoͰಈ͘ͷͰ…ʂ•ࣾʹPHPNode.js͍·͢•Frontend Engineer
GoओཁϥΠϒϥϦൺֱ•github.com/graph-gophers/graphql-go•github.com/graphql-go/graphql•github.com/samsarahq/thunder•github.com/99designs/gqlgen
GoओཁϥΠϒϥϦൺֱ•github.com/graph-gophers/graphql-go•github.com/graphql-go/graphql•github.com/samsarahq/thunder•github.com/99designs/gqlgenػೳ͕ͪΐͬͱශऑGoͷίʔυͰSchemaॻ͖ͨ͘ͳ͍ಉ্ΘΓͱྑͦ͞͏ʁ
ͳͥgqlgen͔ʁ•ϘΠϥʔϓϨʔτݏʂ•શίʔυੜݏʂ•ίʔυੜ+खॻ͖ΛఔΑ͘…•ΑΖ͍͠ͳΒgqlgenͩʂ
gqlgenྑ͍ͷ͔ʁྑ͘͠·ͨ͠❤Ͱcommitterʹͳͬͨ
gqlgenͷαϙʔτൣғ•Query•Mutation•Subscription•Directive•import syntax•type extend͋Δ ΄͍ͦ͠ͷ͏ͪΓ·͢committer͔ͩΒͶ
σϞ•gqlgen init ͯ͠ΈΔ•มߋΛՃ͑ͯΈΔ•gqlgen gen ͯ͠ΈΔ•࣮ࡍʹୟ͍ͯΈΔ࣌ؒ…͋Δʁgqlgen.com/getting-started/
ύʔπͷղઆ•Resolver•Directive•Middleware•ErrorPresenter
ύʔπͷղઆ•Resolver•Directive•Middleware•ErrorPresenterੜ͞Εͨinterface࣮ͯ͠ʂੜ͞ΕͨDirectiveʹ࣮Λ༩͑ͯʂదʹϩΪϯάͱ͔ʹ͑·͢ΤϥʔͷΧελϚΠζͰ͖·͢gitter.im/gqlgen/Lobbygqlgen.com
Middleware•ResolverMiddleware•Resolverͷಈ࡞લޙʹॲཧΛڬΉ•RequestMiddleware•Req,RespʹॲཧΛڬΉ(ओʹϩΪϯά)bit.ly/2MmjbEE
ઃܭϕετϓϥΫςΟεຊʹϕετ͔͠ΒΜʂ
RelayΛษڧ͢͠•RelayΛ࠾༻͠ͳͯ͘ษڧͯ͠•Server͚ͩߟ͑ΔͱΠϛϑͳ༷͕͋Δ•ओʹFragmentपΓ•UIଆΛඒ͘͠ઃܭ͢ΔͨΊTSαϙʔτ͖ͨgithub.com/facebook/relay/pull/2293
RelayΛษڧ͢͠•Relay spec 3ܑఋ•cursor, global object, input object•specຊମ͡Όͳ͍ͷͰཤमಀ͕ͪ͠•GitHub౿ऻ͍ͯ͠Δ•bit.ly/2npeSdv
N+1•Πϕϯτ3ͭ×αʔΫϧ100݅×൦9ݸ•1+3×1+3×100×1 = 304ճͷDBΞΫηε•ؤுͬͯ࠷దԽ͢Δͱ 1+1+1 ??
N+1•gqlgenResolverΛฒྻॲཧ͢Δ•→ू͕͍͠ʂ•github.com/vektah/dataloaden•ࢦఆظؒͷϦΫΤετΛҰׅԽ•·ͩະධՁ… ྑ͍ํ๏ࢥ͍ͭ͘ʁ
REST APIͱͷରൺ•REST API = RPC•GraphQL = QueryLanguage•Τϥʔʹର͢Δߟ͑ํ͕ࠜຊతʹҧ͏•“ਖ਼͍͠Requestͷ͛ํ” ͱ͍͏֓೦•ڻ͖࠷খͷݪଇ & σόοΨϏϦςΟ
REST APIͱͷରൺ•Τϥʔʹର͢Δߟ͑ํϚδॏཁ•େࣄͳ͜ͱͳͷͰ2ճݴ͍·ͨ͠•GraphiQLͰ݁͢ΔσόοΨϏϦςΟ•੍ޚͳΔ͘DirectiveϨϕϧͰϑϧεΫϥονͰ͖ΔͳΒͦΕ͕Α͍
Schemaઃܭ•Schema͔ΒಡΈऔΕΔใΛ૿͢•DirectiveΛͬͨScope੍ޚͱ͔•DBͷ1table=1typeʹ͢Δͱ͔•มʹ߹ମͤͨ͞Γׂͨ͠Γ͠ͳ͍
AuthपΓ•ಛʹܾ·༷͕ͬͨͳ͍•ͷͰɺී௨ʹHTTP͢Δ•ηογϣϯ, OAuth2 etc…
·ͩΘ͔ΒΜ
ςετͲ͏͢Δʁ•ࠓͷͱ͜Ζgolden testingͯ͠Δ•Resolver, DirectiveΛݸผʹςετʁ
Mock?•αʔόଆ࣮͕͋ͱʹͳΔ߹•ΫϥΠΞϯτଆʹͲ͏ ָͤ͞Δ͖ʁ
BFF vs ࣮•جຊ࣮ͷ΄͏ָ͕ͦ͏•Backend Engineerతʹ•Microserviceͷͱ͖ʁ•݁ہBFFతଘࡏʹͳΔͷͰ…ʁ
ӡ༻ͷ•ϝτϦΫεऔΓ͍ͨʁ•ϩάऔΓ͍ͨʁ•statsੳ͍ͨ͠ʁ
ΫϥΠΞϯτଆϫʔΫϑϩʔ•ͳʹ͔Θ͔ΒΜ•ಛʹAndroid, iOSͷݟ͕ͳ͍•Webదʹͬͯ΄͍͠
ࢀߟࢿྉ
ࢀߟࢿྉू•b.hatena.ne.jp/vvakame/GraphQL•graphql.org•www.howtographql.com•ٕज़ॻయ5Ͱຊग़͢…ʁ(མͪͳ͍Ͱ͜Ε͖͢
͓͠·͍
vvakame
ganota
koic
drumath2237
yutaro527
____rina____
line_developers_tw
oogfranz
regonn
hirokik56
korodroid
nomu
jordihofc
keavy
swwweet
mongodb
sachag
eileencodes
robhawkes
frogandcode
chriscoyier
brianwarren
shpigford
ufuk
shlominoach