GoでGraphQLサーバを立てるぞ！ / Building GraphQL server by go

Transcript

1. GoͰGraphQLαʔόΛཱͯΔͧʂ mercari.go #2 Θ͔Ί ·͞ͻΖ #mercarigo bit.ly/2vyiluP

2. Θ͔Ί ·͞ͻΖ @v vakame Masahiro Wakame GAE/Go TypeScript ٕज़ॻయ

3. TL;DR •GraphQLͬͯԿʁ •GitHub v4 APIΛ৮ͬͯΈΔ •github.com/99designs/gqlgen •ઃܭϕετϓϥΫςΟε ΫϥΠΞϯτͷ࿩͸͠ͳ͍

4. GraphQLͬͯԿʁ ࡉ͔͍͜ͱ͸ ࠷ޙͷࢀߟࢿྉूͰʂ

5. GraphQLͬͯԿʁ •Facebook͕2015೥ʹެ։ͨ͠࢓༷ •άϥϑߏ଄ʹର͢ΔQuery Language •༑ୡͷ༑ୡΛ5ਓͣͭऔಘ͢Δͱ͔ •Client→Serverͷσʔλཁٻ࣌ʹ࢖͏

6. GraphQLͬͯԿʁ RESTͳΒ3RPCඞཁ
 GraphQLͳΒ1ճ { circle(id: "Q2lyY2xlRXhoaWJpdEluZm86MTIzNAo") { name spaces penName

   webSiteURL genre genreFreeFormat products(first: 9) { pageInfo { hasNextPage endCursor } nodes { name description type page price relatedURLs firstAppearanceEventName firstAtTechBookFest images { url height width } } } loginUserChecked { checked } } }

7. େࣄͳ͜ͱ •ΘΓͱ੍໿͋Δ (N+1ରࡦͱ͔) •ແݶʹૣ͘ͳ͍ •REST APIͷ্Ґޓ׵Ͱ͸ͳ͍ •ࠩҟΛΑ͘ཧղ͠Α͏

8. ϝϧΧϦͰ࢖ͬͯΔʁ •C Sπʔϧ PHP+webonyx/graphql-php •US ϝϧΧϦWeb ??? •MicroserviceԽ CSπʔϧ Go+gqlgen

   •ϝϧΧϦWeb Node.js+Apollo •ϝϧϖΠ CSπʔϧ(ݕ౼த) Go+gqlgen ٕज़ॻయWeb΋࣮ݧதͰ͢

9. ClientͷྲྀΕ •·ͣSchema(+αʔό)͕͋Δ •ͦ͜ʹOperationΛ౤͛Δ •Query, Mutation, Subscribe ͷ3छ •ཁٻͨ͠௨ΓͷܗࣜͰσʔλདྷΔ

10. Queryͷྫ { viewer { id login name location bio company

    repositoriesContributedTo(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" } ] } } } } ରԠͨ͠ߏ଄͕ฦΔ

11. ClientͷྲྀΕ •ͭ·Γ… •ΫΤϦʹΑͬͯಘΒΕΔσʔλ͕มΘΔ •ΫΤϦݸผʹฦΓ஋ͷσʔλͷܕཉ͍͠ •→ݴޠʹΑͬͯ͸࢖͍ͮΒ͍Մೳੑʁ ·͊JSͱ૬ੑྑͦ͞͏ͳͷ͸Θ͔Δ

12. ͬ͘͟ΓServerݪཧ •Query͕དྷΔ •ฦ͢σʔλ͸Treeߏ଄ʹͳΔ •Treeͷઅ(ͱ͔)ຖʹResolverΛఆٛ͢Δ •Resolver͕ཁٻ͞ΕͨNodeΛੜ੒͠ฦ͢ •Resolverͷू߹ == αʔόͷ࣮૷

13. ͬ͘͟ΓServerݪཧ type ResolverRoot interface { Query() QueryResolver User() UserResolver CircleExhibitInfo()

    CircleExhibitInfoResolver ProductInfo() ProductInfoResolver } type QueryResolver interface { Circle(ctx context.Context, id string) (*CircleExhibitInfo, } type CircleExhibitInfoResolver interface { ID(ctx context.Context, obj *CircleExhibitInfo) (string, err Products(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") { name spaces penName webSiteURL genre genreFreeFormat products(first: 9) { pageInfo { hasNextPage endCursor } nodes { name description type page price relatedURLs firstAppearanceEventName firstAtTechBookFest images { url height width } } } loginUserChecked { checked } }

14. ͬ͘͟ΓServerݪཧ Resolverͷू߹ ʹ αʔόͷ࣮૷

15. ͜͜޷͖ •୯ҰΤϯυϙΠϯτ •Introspection •SchemaΛ஌Δʹ΋GraphQL͕࢖͑Δ •ڧ͍ܕ෇͚ʂ

16. GitHub v4 APIΛ৮Δ

17. ৮Γ·͠ΐ͏ •developer.github.com/v4/explorer/ •GraphiQLʹ৮ΕΔ •GitHubͷߟ͑ͨ࠷ڧͷઃܭʹ৮ΕΔ •͋ΘΑ͘͹࢖ͬͯΈΔ

18. σϞ •ϩάΠϯϢʔβͷ໊લग़͢ •೚ҙͷϦϙδτϦ͕࡞ΒΕͨ೔ग़͢ •GraphQLʹؔ࿈ͷ͋ΔUserΛநग़͢Δ

19. ίʔυ͔Β •ద౰ʹPOST͢Δ͚ͩ •Authorization: bearer ${PersonalAccessToken} •https://api.github.com/graphql •https://github.com/settings/tokens bit.ly/2Oo8DlD

20. github.com/99designs/gqlgen I’m committer!

21. ͳͥGoͳͷ͔ʁ •Go͸΍͍͠ฒߦॲཧ؆୯ͩ͠ •Microservice܈͕GoͳͷͰ…ʂ •GAE/GoͰಈ͘ͷͰ…ʂ •ࣾ಺ʹ͸PHP੎΍Node.js੎΋͍·͢ •Frontend Engineer؅׋

22. GoओཁϥΠϒϥϦൺֱ •github.com/graph-gophers/graphql-go •github.com/graphql-go/graphql •github.com/samsarahq/thunder •github.com/99designs/gqlgen

23. GoओཁϥΠϒϥϦൺֱ •github.com/graph-gophers/graphql-go •github.com/graphql-go/graphql •github.com/samsarahq/thunder •github.com/99designs/gqlgen ػೳ͕ͪΐͬͱශऑ GoͷίʔυͰSchemaॻ͖ͨ͘ͳ͍ ಉ্ ΘΓͱྑͦ͞͏ʁ

24. ͳͥgqlgen͔ʁ •ϘΠϥʔϓϨʔτ͸ݏʂ •׬શίʔυੜ੒΋ݏʂ •ίʔυੜ੒+खॻ͖ΛఔΑ͘… •ΑΖ͍͠ͳΒ͹gqlgenͩʂ

25. gqlgen͸ྑ͍ͷ͔ʁ ྑ͘͠·ͨ͠❤ Ͱcommitterʹͳͬͨ

26. gqlgenͷαϙʔτൣғ •Query •Mutation •Subscription •Directive •import syntax •type extend ͋Δ

    ΄͍͠ ͦͷ͏ͪ΍Γ·͢ committer͔ͩΒͶ

27. σϞ •gqlgen init ͯ͠ΈΔ •มߋΛՃ͑ͯΈΔ •gqlgen gen ͯ͠ΈΔ •࣮ࡍʹୟ͍ͯΈΔ ࣌ؒ…͋Δʁ

    gqlgen.com/ getting-started/

28. ύʔπͷղઆ •Resolver •Directive •Middleware •ErrorPresenter

29. ύʔπͷղઆ •Resolver •Directive •Middleware •ErrorPresenter ੜ੒͞Εͨinterface࣮૷ͯ͠ʂ ੜ੒͞ΕͨDirectiveʹ࣮૷Λ༩͑ͯʂ ద౰ʹϩΪϯάͱ͔ʹ࢖͑·͢ ΤϥʔͷΧελϚΠζͰ͖·͢ gitter.im/gqlgen/Lobby

    gqlgen.com

30. Middleware •ResolverMiddleware •Resolverͷಈ࡞લޙʹॲཧΛڬΉ •RequestMiddleware •Req,RespʹॲཧΛڬΉ(ओʹϩΪϯά) bit.ly/2MmjbEE

31. ઃܭϕετϓϥΫςΟε ຊ౰ʹϕετ͔͸͠ΒΜʂ

32. RelayΛษڧ͢΂͠ •RelayΛ࠾༻͠ͳͯ͘΋ษڧͯ͠ •Server͚ͩߟ͑ΔͱΠϛϑͳ࢓༷͕͋Δ •ओʹFragmentपΓ •UIଆΛඒ͘͠ઃܭ͢ΔͨΊ TSαϙʔτ͖ͨ github.com/facebook/relay/pull/2293

33. RelayΛษڧ͢΂͠ •Relay spec 3ܑఋ •cursor, global object, input object •specຊମ͡Όͳ͍ͷͰཤमಀ͕ͪ͠

    •GitHub΋౿ऻ͍ͯ͠Δ •bit.ly/2npeSdv

34. N+1໰୊ •Πϕϯτ3ͭ×αʔΫϧ100݅×൦෍෺9ݸ •1+3×1+3×100×1 = 304ճͷDBΞΫηε •ؤுͬͯ࠷దԽ͢Δͱ 1+1+1 ??

35. N+1໰୊ •gqlgen͸ResolverΛฒྻॲཧ͢Δ •→ू໿͕೉͍͠ʂ •github.com/vektah/dataloaden •ࢦఆظؒͷϦΫΤετΛҰׅԽ •·ͩະධՁ… ྑ͍ํ๏ࢥ͍ͭ͘ʁ

36. REST APIͱͷରൺ •REST API = RPC •GraphQL = QueryLanguage •Τϥʔʹର͢Δߟ͑ํ͕ࠜຊతʹҧ͏

    •“ਖ਼͍͠Requestͷ౤͛ํ” ͱ͍͏֓೦ •ڻ͖࠷খͷݪଇ & σόοΨϏϦςΟ

37. REST APIͱͷରൺ •Τϥʔʹର͢Δߟ͑ํϚδॏཁ •େࣄͳ͜ͱͳͷͰ2ճݴ͍·ͨ͠ •GraphiQLͰ׬݁͢ΔσόοΨϏϦςΟ •੍ޚ͸ͳΔ΂͘DirectiveϨϕϧͰ ϑϧεΫϥονͰ͖ΔͳΒͦΕ͕Α͍

38. Schemaઃܭ •Schema͔ΒಡΈऔΕΔ৘ใΛ૿΍͢ •DirectiveΛ࢖ͬͨScope੍ޚͱ͔ •DBͷ1table=1typeʹ͢Δͱ͔ •มʹ߹ମͤͨ͞Γ෼ׂͨ͠Γ͠ͳ͍

39. AuthपΓ •ಛʹܾ·ͬͨ࢓༷͕ͳ͍ •ͷͰɺී௨ʹHTTP͢Δ •ηογϣϯ, OAuth2 etc…

40. ·ͩΘ͔ΒΜ

41. ςετͲ͏͢Δʁ •ࠓͷͱ͜Ζgolden testingͯ͠Δ •Resolver, DirectiveΛݸผʹςετʁ

42. Mock? •αʔόଆ࣮૷͕͋ͱʹͳΔ৔߹ •ΫϥΠΞϯτଆʹͲ͏ ָͤ͞Δ΂͖ʁ

43. BFF vs ௚࣮૷ •جຊ௚࣮૷ͷ΄͏ָ͕ͦ͏ •Backend Engineerతʹ͸ •Microserviceͷͱ͖ʁ •݁ہBFFతଘࡏʹͳΔͷͰ͸…ʁ

44. ӡ༻ͷ࿩ •ϝτϦΫεऔΓ͍ͨʁ •ϩάऔΓ͍ͨʁ •stats෼ੳ͍ͨ͠ʁ

45. ΫϥΠΞϯτଆϫʔΫϑϩʔ •ͳʹ΋͔΋Θ͔ΒΜ •ಛʹAndroid, iOSͷ஌ݟ͕ͳ͍ •Web͸ద౰ʹ΍ͬͯ΄͍͠

46. ࢀߟࢿྉ

47. ࢀߟࢿྉू •b.hatena.ne.jp/vvakame/GraphQL •graphql.org •www.howtographql.com •ٕज़ॻయ5Ͱຊग़͢…ʁ(མͪͳ͍Ͱ ͜Ε͖͢

48. ͓͠·͍