2018.4.18 - GraphQLが格好良さそうだったので、Springで入門したら躓いた話

▼開催日▼
2018年4月18日

▼イベント▼
JSUG勉強会 2018年 その3
https://jsug.doorkeeper.jp/events/73144

1. GraphQL͕ ֨޷ྑͦ͞͏ͩͬͨͷͰɺ SpringͰೖ໳ͨ͠Β͍᪴ͨ࿩
2. About me • ∁໺ ͸͍Ͷ • SoftBank Payment Service Corp. • ϓϩάϥϚʔ3೥ੜ
 ։ൃϓϩδΣΫτࢧԉ • I — Spring Framework! hainet hainet_g
4. “(GraphQL is) A query language for your API” ཉ͍͠΋ͷ͚ͩऔಘ͢Δ WebAPiͷ࢓૊Έ
5. ྫɿΫϨδοτΧʔυ৘ใΛऔಘ͢Δ
6. Χʔυ൪߸(number)Λऔಘ͢Δ
7. ༗ޮظݶ(goodThru)΋औಘ͢Δ
8. ϒϥϯυ(brand)΋औಘ͢Δ ཁٻ͞ΕΔ·ͰόοΫΤϯυͰ ϒϥϯυΛऔಘ͢ΔΫΤϦ͸ಈ͔ͳ͍
9. 3 Slides Cooking! with GraphQL Spring Boot Starter
10. 1. Add Dependencies dependencies { compile('com.graphql-java:graphql-spring-boot-starter:4.0.0') compile(‘com.graphql-java:graphql-java-tools:4.3.0') }
11. 2. Describe Schemas type CreditCard { id: ID! number: String! goodThru: String! securityCode: String! } type Query { findCreditCards: [CreditCard]! }
12. 3. Implement Queries @Component public class CreditCardQuery implements GraphQLQueryResolver { public List<CreditCard> findCreditCards() { // Find credit cards! return creditCards; } }
13. Run! https://github.com/hainet/ graphql-spring-boot-sample
14. খ͞ͳϓϩδΣΫτʹಋೖͨ͠ͷͰɺ GraphQLͷ֨޷ྑ͞Λڞ༗͍ͨ͠ʂ ʢͱࢥͬͯLTͷ४උΛ࢝Ί·ͨ͠ɻʣ
15. ͕ɺࠓ೔͢Δ࿩͸ GraphQLͷ֨޷ྑ͍࿩ …Ͱ͸ͳ͍ɻ ྑ͍ॴ΋୔ࢁ͋ͬͯ঺հ͍ͨ͠… @ComponentΛ͚ͭΔ͚ͩͰେମԿͰ΋ग़དྷΔͱ͔ɺ Schemaͱ࣮૷͕Ұக͍ͯ͠ͳ͍ͱڭ͑ͯ͘ΕΔͱ͔ɺ ෆཁͳResolver͸ಈ͔ͳ͍(ෆཁͳSQL͸ྲྀΕͳ͍)ͱ͔ɺ LTͳͷͰׂѪ (´ʀωʀʆ)
16. ࢖ͬͯΈͯ෼͔ͬͨ SpringϢʔβʔ͔ͩΒͦ᪴͘͜ ͱͯ΋஍ຯͳ࣮૷ͷ࿩Λ͠·͢ɻ
17. ࣮૷Ͱ͍᪴ͨ͜ͱ 1. PayloadΛόϦσʔγϣϯ͢Δ
 ͖᪴౓ɿ˒˒˒ˑˑ 2. ΤϥʔϋϯυϦϯά͢Δ
 ͖᪴౓ɿ˒˒˒˒˒˒˒˒˒˒ 3. ObjectMapperΛઃఆ͢Δ(Appendix)
 ͖᪴౓ɿ˒ˑˑˑˑ
18. PayloadΛόϦσʔγϣϯ͢Δ
 ͖᪴౓ɿ˒˒˒ˑˑ
19. Hibernate ValidatorΛ࢖͍͍ͨ public class CreditCardPayload { @NotNull @Size(min = 14, max = 16) @Pattern(regexp = "[0-9]*") private String number; // Fields, Getters, Setters } @Component public class CreditCardMutation implements GraphQLMutationResolver { public CreditCard createCreditCard( @Validated final CreditCardPayload payload) { // Create credit card! return creditCard; } }
20. Hibernate ValidatorΛ࢖͍͍ͨ public class CreditCardPayload { @NotNull @Size(min = 14, max = 16) @Pattern(regexp = "[0-9]*") private String number; // Fields, Getters, Setters } @Component public class CreditCardMutation implements GraphQLMutationResolver { public CreditCard createCreditCard( @Validated final CreditCardPayload payload) { // Create credit card! return creditCard; } }
21. Hibernate ValidatorΛ࢖͍͍ͨ public class CreditCardPayload { @NotNull @Size(min = 14, max = 16) @Pattern(regexp = "[0-9]*") private String number; // Fields, Getters, Setters } @Component public class CreditCardMutation implements GraphQLMutationResolver { public CreditCard createCreditCard( @Validated final CreditCardPayload payload) { // Create credit card! return creditCard; } }
22. ͷւ͸ɹɹ༏੎ ΫϥΠΞϯτ αΠυͰʂ UI/UX! ଈ࣌ Ϩεϙϯεʂ ͦ ͏ ͡ Ό Ͷ ͐ ʂ ͷຽ͕જΔʹ͸աࠅͳ؀ڥ
23. GraphQL Javaެࣜʹ͋ͬͨʂ URL: http://graphql-java.readthedocs.io/en/latest/scalars.html#validation-of-input-and-output java.lang.String จࣈྻ Scalar GraphQLString Deserialize Serialize Scalarͱ͸ ͜͜Ͱ όϦσʔγϣϯ͢Δ
24. Number.javaΛ࡞੒ @Component public class Number extends GraphQLScalarType { public Number() { super("Number", "CreditCardPayload.Number", new Coercing() { @Override public String serialize(final Object dataFetcherResult) { return this.serializeNumber(dataFetcherResult); } @Override public String parseValue(final Object input) { return this.parseNumberFromVariable(input); } @Override public String parseLiteral(final Object input) { return this.parseNumberFromAstLiteral(input); } }); } } Serialize Deserialize (AST) Deserialize
25. input CreditCardPayload { number: Number! goodThru: GoodThru! brand: Brand! securityCode: SecurityCode! } Number.java CreditCard.graphqlsఆٛมߋ GoodThru.java SecurityCode.java
26. όϦσʔγϣϯͰ͖ͨʂ DDDతͳఆٛ΋៉ྷʂ ͚ͩΕͲ...
27. type Something { foo: Foo! bar: Bar! baz: Baz! hoge: Hoge! fuga: Fuga! piyo: Piyo! fizz: Fizz! bazz: Bazz! } Foo.java Bar.java Baz.java Hoge.java Fuga.java Piyo.java Fizz.java Bazz.java
28. ཉ͔ͬͨ͠ͷ͸ ͜Ε͡Όͳ͍
29. ΤϥʔϋϯυϦϯά͢Δ
 ͖᪴౓ɿ˒˒˒˒˒˒˒˒˒˒
30. Τϥʔ࣌ɺGraphQL Spring Boot Starter͸ ͱΓ͋͑ͣInternal Server ErrorΛฦ͢ HandlerExceptionResolver΋͢Γൈ͚Δ...
31. Τϥʔϋϯυϥͷ࣮૷Λ௥ͬͯɺ ॲཧΛࠩ͠ସ͑ͯΈͨ @Override public List<GraphQLError> processErrors( List<GraphQLError> errors) { errors.add( new GenericGraphQLError( "Internal Server Error(s) while executing query" ) ); // Omitted return errors; } DefaultGraphQLErrorHandler.java
32. Τϥʔϋϯυϥͷ࣮૷Λ௥ͬͯɺ ॲཧΛࠩ͠ସ͑ͯΈͨ @Override public List<GraphQLError> processErrors( List<GraphQLError> errors) { errors.add( new GenericGraphQLError( "Internal Server Error(s) while executing query" ) ); // Omitted return errors; } MyGraphQLErrorHandler.java
34. ʊਓਓਓਓਓਓਓਓਓʊ ʼɹ Stack Trace ɹʻ ʉY^Y^Y^Y^Y^Y^Yʉ
35. Internal Server Error Ͳ͜Ζͷ૽͗Ͱ͸ͳ͍
36. GraphQLErrorΛ෼ྨͯ͠… GraphQLError͸େ͖͘3छྨ
37. GraphQLErrorΛద੾ʹϋϯυϦϯά͢Δ GraphQLErrorHandlerΛ࣮૷ @Component @Slf4j public class GraphQLErrorHandlerConfig implements GraphQLErrorHandler { @Override public List<GraphQLError> processErrors(final List<GraphQLError> errors) { errors.stream() .filter(this::isServerError) .forEach(error -> { if (error instanceof Throwable) { log.error("Error executing query!", (Throwable) error); } else { log.error( "Error executing query ({}): {}", error.getClass().getSimpleName(), error.getMessage() ); } }); return errors.stream() .map(GraphQLErrorHolder::new) .collect(Collectors.toList()); } private boolean isServerError(final GraphQLError error) { return error instanceof ExceptionWhileDataFetching || error instanceof Throwable; } }
38. @Component @Slf4j public class GraphQLErrorHandlerConfig implements GraphQLErrorHandler { @Override public List<GraphQLError> processErrors(final List<GraphQLError> errors) { errors.stream() .filter(this::isServerError) .forEach(error -> { if (error instanceof Throwable) { log.error("Error executing query!", (Throwable) error); } else { log.error( "Error executing query ({}): {}", error.getClass().getSimpleName(), error.getMessage() ); } }); return errors.stream() .map(GraphQLErrorHolder::new) .collect(Collectors.toList()); } private boolean isServerError(final GraphQLError error) { return error instanceof ExceptionWhileDataFetching || error instanceof Throwable; } } Stack Trace͸ ࣗྗͰग़ྗ GraphQLErrorΛద੾ʹϋϯυϦϯά͢Δ GraphQLErrorHandlerΛ࣮૷
39. GraphQLErrorHolderΛ࡞੒ public class GraphQLErrorHolder implements GraphQLError { private GraphQLError error; public GraphQLErrorHolder( final GraphQLError error) { this.error = error; } // Override getters } ThrowableΛӅṭ
40. ׬੒ʂ ೚ҙͷϝοηʔδ ೚ҙͷΤϥʔλΠϓ ೚ҙͷkey/value
41. ここまで躓いて 私は考えた
42. 何か⼤きな勘違いを しているのではないか... Hibernate Validatorは利かない, HandlerExceptionResolverはすり抜ける, ObjectMapperは独⾃のインターフェースを通して登録する. 共通点は？ 情報が少なすぎて調査が難航。 上司からもJavaでGraphQL誰もやっていないとツッコミを受ける。
43. /graphqlΤϯυϙΠϯτ͸ Spring MVCͷ֎ͷੈքͷॅਓͩͬͨ ʲग़དྷͳ͍͜ͱʳ ɾHandlerInterceptor ɾetc… GraphQLWebAutoConfiguration.java ʲग़དྷΔ͜ͱʳ ɾSpring AOP ɾFilter ɹˠ Spring Security͸OK!
44. Springͷੈք͔͠஌Βͳ͔ͬͨͷͰ େ͖͘ζοίέ·ͨ͠... ɹɹɹɹɹɹɹ㱯ɹ㱯
    ɹɹɹɹ
    ɹ
    ʢŋТŋ
    c
    cɹɹζίʔ
    ɹɹɹɹɹɹɹc
    ɹ
    ɹ
    c
    ɹɹɹɹɹ㱬㱬@@@@ϊɹʹj
    ʢϓϩάϥϚʔਓੜॳΊͯͷΞϊςʔγϣϯ͸@Controllerʣ
45. ͜Ε͔ΒGraphQLΛ ৮Δਓͷ͓໾ʹཱͯ͹޾͍Ͱ͢
46. ͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠ʂ
47. Appendix
48. ObjectMapperΛઃఆ͢Δ
 ͖᪴౓ɿ˒ˑˑˑˑ
49. GraphQL Spring Boot Starter͸σϑΥϧτͰ Date and Time APIΛϚοϐϯάग़དྷͳ͍ Spring Boot 2.0ʹ͸ରԠࡁ jackson-datatype-jsr310͸ೖ͍ͬͯΔ͸ͣ... URL: https://github.com/graphql-java/graphql-spring-boot/pull/63/commits/7eed5c83312c87b1c3fa73416399408570ac079c
50. ObjectMapperConfigurer͕͋ͬͨ @Component public class GraphQLObjectMapperConfig implements ObjectMapperConfigurer { @Override public void configure(final ObjectMapper mapper) { mapper.registerModule(new JavaTimeModule()); } } URL: https://github.com/graphql-java/graphql-java-servlet/issues/42