GraphQL͕ ֨޷ྑͦ͞͏ͩͬͨͷͰɺ SpringͰೖ໳ͨ͠Β͍᪴ͨ࿩ 

About me • ∁໺ ͸͍Ͷ • SoftBank Payment Service Corp. • ϓϩάϥϚʔ3೥ੜ
 ։ൃϓϩδΣΫτࢧԉ • I — Spring Framework! hainet hainet_g 

No content

“(GraphQL is) A query language for your API” ཉ͍͠΋ͷ͚ͩऔಘ͢Δ WebAPiͷ࢓૊Έ 

ྫɿΫϨδοτΧʔυ৘ใΛऔಘ͢Δ 

Χʔυ൪߸(number)Λऔಘ͢Δ 

༗ޮظݶ(goodThru)΋औಘ͢Δ 

ϒϥϯυ(brand)΋औಘ͢Δ ཁٻ͞ΕΔ·ͰόοΫΤϯυͰ ϒϥϯυΛऔಘ͢ΔΫΤϦ͸ಈ͔ͳ͍ 

3 Slides Cooking! with GraphQL Spring Boot Starter 

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') } 

2. Describe Schemas type CreditCard { id: ID! number: String! goodThru: String! securityCode: String! } type Query { findCreditCards: [CreditCard]! } 

3. Implement Queries @Component public class CreditCardQuery implements GraphQLQueryResolver { public List findCreditCards() { // Find credit cards! return creditCards; } } 

Run! https://github.com/hainet/ graphql-spring-boot-sample 

খ͞ͳϓϩδΣΫτʹಋೖͨ͠ͷͰɺ GraphQLͷ֨޷ྑ͞Λڞ༗͍ͨ͠ʂ ʢͱࢥͬͯLTͷ४උΛ࢝Ί·ͨ͠ɻʣ 

͕ɺࠓ೔͢Δ࿩͸ GraphQLͷ֨޷ྑ͍࿩ …Ͱ͸ͳ͍ɻ ྑ͍ॴ΋୔ࢁ͋ͬͯ঺հ͍ͨ͠… @ComponentΛ͚ͭΔ͚ͩͰେମԿͰ΋ग़དྷΔͱ͔ɺ Schemaͱ࣮૷͕Ұக͍ͯ͠ͳ͍ͱڭ͑ͯ͘ΕΔͱ͔ɺ ෆཁͳResolver͸ಈ͔ͳ͍(ෆཁͳSQL͸ྲྀΕͳ͍)ͱ͔ɺ LTͳͷͰׂѪ (´ʀωʀʆ) 

࢖ͬͯΈͯ෼͔ͬͨ SpringϢʔβʔ͔ͩΒͦ᪴͘͜ ͱͯ΋஍ຯͳ࣮૷ͷ࿩Λ͠·͢ɻ 

࣮૷Ͱ͍᪴ͨ͜ͱ 1. PayloadΛόϦσʔγϣϯ͢Δ
 ͖᪴౓ɿ˒˒˒ˑˑ 2. ΤϥʔϋϯυϦϯά͢Δ
 ͖᪴౓ɿ˒˒˒˒˒˒˒˒˒˒ 3. ObjectMapperΛઃఆ͢Δ(Appendix)
 ͖᪴౓ɿ˒ˑˑˑˑ 

PayloadΛόϦσʔγϣϯ͢Δ
 ͖᪴౓ɿ˒˒˒ˑˑ 

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; } } 

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; } } 

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; } } 

ͷւ͸ɹɹ༏੎ ΫϥΠΞϯτ αΠυͰʂ UI/UX! ଈ࣌ Ϩεϙϯεʂ ͦ ͏ ͡ Ό Ͷ ͐ ʂ ͷຽ͕જΔʹ͸աࠅͳ؀ڥ 

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ͱ͸ ͜͜Ͱ όϦσʔγϣϯ͢Δ 

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 

input CreditCardPayload { number: Number! goodThru: GoodThru! brand: Brand! securityCode: SecurityCode! } Number.java CreditCard.graphqlsఆٛมߋ GoodThru.java SecurityCode.java 

όϦσʔγϣϯͰ͖ͨʂ DDDతͳఆٛ΋៉ྷʂ ͚ͩΕͲ... 

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 

ཉ͔ͬͨ͠ͷ͸ ͜Ε͡Όͳ͍ 

ΤϥʔϋϯυϦϯά͢Δ
 ͖᪴౓ɿ˒˒˒˒˒˒˒˒˒˒ 

Τϥʔ࣌ɺGraphQL Spring Boot Starter͸ ͱΓ͋͑ͣInternal Server ErrorΛฦ͢ HandlerExceptionResolver΋͢Γൈ͚Δ... 

Τϥʔϋϯυϥͷ࣮૷Λ௥ͬͯɺ ॲཧΛࠩ͠ସ͑ͯΈͨ @Override public List processErrors( List errors) { errors.add( new GenericGraphQLError( "Internal Server Error(s) while executing query" ) ); // Omitted return errors; } DefaultGraphQLErrorHandler.java 

Τϥʔϋϯυϥͷ࣮૷Λ௥ͬͯɺ ॲཧΛࠩ͠ସ͑ͯΈͨ @Override public List processErrors( List errors) { errors.add( new GenericGraphQLError( "Internal Server Error(s) while executing query" ) ); // Omitted return errors; } MyGraphQLErrorHandler.java 

No content

ʊਓਓਓਓਓਓਓਓਓʊ ʼɹ Stack Trace ɹʻ ʉY^Y^Y^Y^Y^Y^Yʉ 

Internal Server Error Ͳ͜Ζͷ૽͗Ͱ͸ͳ͍ 

GraphQLErrorΛ෼ྨͯ͠… GraphQLError͸େ͖͘3छྨ 

GraphQLErrorΛద੾ʹϋϯυϦϯά͢Δ GraphQLErrorHandlerΛ࣮૷ @Component @Slf4j public class GraphQLErrorHandlerConfig implements GraphQLErrorHandler { @Override public List processErrors(final List 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; } } 

@Component @Slf4j public class GraphQLErrorHandlerConfig implements GraphQLErrorHandler { @Override public List processErrors(final List 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Λ࣮૷ 

GraphQLErrorHolderΛ࡞੒ public class GraphQLErrorHolder implements GraphQLError { private GraphQLError error; public GraphQLErrorHolder( final GraphQLError error) { this.error = error; } // Override getters } ThrowableΛӅṭ 

׬੒ʂ ೚ҙͷϝοηʔδ ೚ҙͷΤϥʔλΠϓ ೚ҙͷkey/value 

ここまで躓いて 私は考えた 

何か⼤きな勘違いを しているのではないか... Hibernate Validatorは利かない, HandlerExceptionResolverはすり抜ける, ObjectMapperは独⾃のインターフェースを通して登録する. 共通点は？ 情報が少なすぎて調査が難航。 上司からもJavaでGraphQL誰もやっていないとツッコミを受ける。 

/graphqlΤϯυϙΠϯτ͸ Spring MVCͷ֎ͷੈքͷॅਓͩͬͨ ʲग़དྷͳ͍͜ͱʳ ɾHandlerInterceptor ɾetc… GraphQLWebAutoConfiguration.java ʲग़དྷΔ͜ͱʳ ɾSpring AOP ɾFilter ɹˠ Spring Security͸OK! 

Springͷੈք͔͠஌Βͳ͔ͬͨͷͰ େ͖͘ζοίέ·ͨ͠... ɹɹɹɹɹɹɹ㱯ɹ㱯
ɹɹɹɹ
ɹ
ʢŋТŋ
c
cɹɹζίʔ
ɹɹɹɹɹɹɹc
ɹ
ɹ
c
ɹɹɹɹɹ㱬㱬@@@@ϊɹʹj
ʢϓϩάϥϚʔਓੜॳΊͯͷΞϊςʔγϣϯ͸@Controllerʣ 

͜Ε͔ΒGraphQLΛ ৮Δਓͷ͓໾ʹཱͯ͹޾͍Ͱ͢ 

͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠ʂ 

Appendix 

ObjectMapperΛઃఆ͢Δ
 ͖᪴౓ɿ˒ˑˑˑˑ 

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 

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