Share
Embed
Transcript
48 slides
-
Masanari Hamada @narirou ͓ࣄ 2015৽ଔೖࣾ GYAO! WEB ͷΞʔΩςΫνϟ৽ GYAO ಈըϓϨʔϠʔ৽
GYAO iOS SwiftԽ/ϦϑΝΫλϦϯά σβΠϯγεςϜ / JAMStack / WEBඪ४ ʹڵຯ͕͋Γ·͢ ࣥච WEB+DB PRESS ͷϑϩϯτΤϯυ࿈ࡌهࣄͱͯ͠Storybookɺ HeadlessCMSͷهࣄΛࣥච -
දࣔͷཁ݅ຊ࣭తʹΫϥΠΞϯτͷը໘༷ʹ ґଘ͢Δ (ͦͯͦ͠Εɺසൟʹมߋ͞ΕΔ) ❖ ը໘ͷσβΠϯมΘΔ.. ❖ ද͍߲ࣔͨ͠มΘΔ.. ❖ ಛघͳ݅ͰABςετ͍ͨ͠.. ❖
σόΠεʹΑͬͯෳͷσʔλ͕ඞཁ.. RESTͰͲ͏ͬͯରԠ͢Δʁ -
query(userId: ID!) { history(userId: $userId) { videos { id title
} } } ྫ͑ө૾ͷࢹௌཤྺͷྫɺGraphQLͰ͋ΕɺҎԼͷΫΤϦͰ తͷσʔλ͕औಘͰ͖Δ -
query Heros { heros(first: 10) { name } } {
"heros": [ { "name": "R2-D2" } ] } export function Users() { const { data } = useQuery(HeroNameQuery); return data.heros.map(hero => <User name={hero.name} />); } -
type Post { id: String! title: String! publishedAt: DateTime! likes:
Int! @default(value: 0) blog: Blog @relation(name: "Posts") } type Blog { id: String! name: String! description: String posts: [Post!]! @relation(name: "Posts") } GraphQL SDL (schema definition language) εΩʔϚઃܭͷهड़ݴޠΛSDLͱͯ͠൚༻తʹࡦఆ ܕͷఆٛͱͯ͠໌ࣔతͰཧղ͍͢͠ -
Interface interface Post { id: ID! title: String! text: String!
} ❖ ඪ४Ͱ࣋ͭܕ(Scalar Type)ʹɺString, Int ͳͲ ❖ ! non-nullable Λද͢ -
Type ❖ implementsͰఆٛͨ͠interfaceܕΛදݱͰ͖Δ type BlogPost implements Post { id: ID!
title: String! text: String! } -
Query ❖ $id ෦͕Ҿɺ࣮ࡍʹΫΤϦ࣌ʹมͱͯ͠ೖྗ͢Δ query BrogPostQuery($id: ID!) { post(id: $id)
{ title } } { "data": { "post": { "title": "Learning GraphQL" } } } -
Fragment ❖ ܁Γฦ͕͠ଟ͘ग़ݱ͢ΔͳͲΫΤϦશମ͕ංେԽ͢Δ ❖ ࠶ར༻ՄೳͳΫΤϦͷҰ෦ΛΓग़ͯ͠දݱͰ͖Δ { leftComparison: hero(episode: EMPIRE) {
...comparisonFields } rightComparison: hero(episode: JEDI) { ...comparisonFields } } fragment comparisonFields on Character { name appearsIn friends { name } } -
Mutations ❖ σʔλͷॻ͖ࠐΈmutationΫΤϦΛൃߦͯ͠ॲཧ͢Δ mutation CreateReviewForEpisode($ep: Episode!, $review: ReviewInput!) { createReview(episode:
$ep, review: $review) { stars commentary } } -
ΠϯτϩεϖΫγϣϯ GraphQLαʔόʔɺࣗͷεΩʔϚఆٛΛެ։͢ΔΈΛඋ͑Δ ࣮ࡍʹΫΤϦΛͨͲͬͯΈΔͱɺ෦Ͱࢀর͍ͯ͠Δܕใ͕Θ͔Δ { __schema { types { name }
} } { "data": { "__schema": { "types": [ { "name": "ID" } ] } } } -
Apollo Client Λར༻͢Δ import ApolloClient from 'apollo-boost'; import gql from
'graphql-tag'; const client = new ApolloClient({ uri: 'https://48p1r2roz4.sse.codesandbox.io', }); client .query({ query: gql` { rates(currency: "USD") { currency } } ` }) .then(result => console.log(result)); -
௨৴ؒͷॲཧͷநԽ (Apollo Link) ❖ apollo-link-http (جຊతͳ௨৴) ❖ apollo-link-batch-http (όονॲཧ) ❖
apollo-link-rest (REST APIΛGraphQLͷΑ͏ʹѻ͏நԽ) ❖ … -
import React from "react"; import { useQuery } from "@apollo/react-hooks";
import gql from "graphql-tag"; import Link from "./Link"; const GET_VISIBILITY_FILTER = gql` { visibilityFilter @client } `; function FilterLink({ filter, children }) { const { data, client } = useQuery(GET_VISIBILITY_FILTER); return ( <Link onClick={() => client.writeData({ data: { visibilityFilter: filter } }) active={data.visibilityFilter === filter} > {children} </Link> ) } -
{ posts { title text labels { name } thumbnail
{ width height url } } } export type BlogPostsQuery = { posts: Maybe< Array< Pick< BlogPost, | "title" | "text" > & { labels: Maybe<Array<Pick< thumbnail: Pick<Image, "u } > >; }; ྫ͑ graphql-codegen ͰࠨͷΑ͏ͳΫΤϦΛม͢Δͱɺ ӈهͷΑ͏ͳtypes͕ੜ͞ΕΔ -
const GreetingQuery = gql` query getGreeting($language: String!) { greeting(language: $language)
{ message } } `; function Hello() { const { loading, error, data } = useQuery(GreetingQuery, { variables: { language: 'english' }, }); if (loading) return <p>Loading ...</p>; return <h1>Hello {data.greeting.message}!</h1>; } -
export function useGreetingQuery( baseOptions?: ReactApolloHooks.QueryHookOptions< GetGreetingQuery, GetGreetingQueryVariables > ) {
return ReactApolloHooks.useQuery< GetGreetingQuery, GetGreetingQueryVariables >(StoreTitlesDocument, baseOptions); } export type GetGreetingQueryHookResult = ReturnType<typeof useGetGreetingQuery ΫΤϦ(CustomHook)ͷࣗಈੜ ͞Βʹɺ@apollo/react-hooks ͱͷ࿈ܞ͢ΔͱɺΫΤϦ͔Β ReactHooks༻ͷΧελϜϑοΫΛࣗಈੜ͠ɺܕ҆શͳঢ়ଶͰΫΤ ϦΛར༻Ͱ͖Δɻ -
query Heros { messages(first: 99999999) { title messages(first: 99999999) {
title messages(first: 99999999) { title } } } } 1. ύϑΥʔϚϯεΫϦςΟΧϧͳΫΤϦ͕ൃߦ͞ΕΔ ެ։͢ΔGraphQLαʔόʔɺηΩϡϦςΟΛҙࣝ͢Δඞཁ͕͋Δ ྫ͑ɺҎԼͷΑ͏ͳΫΤϦڐ༰ͨ͘͠ͳ͍… -
❖ αΠζΛ੍ݶ͢Δ ❖ ωετͷ੍ݶ͢Δ graphql-depth-limit ͰωετΛ੍ݶ͢Δ ❖ ෳࡶΛܭࢉ੍͠ݶ͢Δ ❖ ΫΤϦΛϗϫΠτϦετొ͢Δ
(Persisted Queries) ΫΤϦΛࣄલʹhashԽ͓͖ͯ͠ɺ௨৴࣌hashΛ༻͍ͯߦ͏ ڐՄ͞ΕͨhashͷΫΤϦͷΈڐ༰ͯ͠ϨεϙϯεΛฦ͢ 1. ύϑΥʔϚϯεΫϦςΟΧϧͳΫΤϦ͕ൃߦ͞ΕΔ खॱ͕ෳࡶͳͨΊɺΑΓΑ͍ղܾࡦ͕΄͍͠ͱ͜Ζ.. -
ΑΓਂ͘Δʹ (ࢀߟจݙ) ❖ GraphQL, ApolloͷެࣜυΩϡϝϯτ ❖ ΫΤϦͷجૅΛΔ: [Queries and Mutations](https://graphql.org/learn/queries/)
❖ എܠΛΔ: [Github Blog | The GitHub GraphQL API](https://githubengineering.com/the- github-graphql-api/) ❖ ApolloLinkΛΔ: [Apollo Link Overview](https://www.apollographql.com/docs/link/ overview/) ❖ ϕετϓϥΫςΟεΛΔ: [GraphQL Best Practice](https://graphql.org/learn/best-practices/) ❖ ੍ݶΛ͔͚Δ: [HOW TO SECURE A GRAPHQL API (THE COMPLETE VULNERABILITY CHECKLIST)](https://leapgraph.com/graphql-api-security) ❖ ੍ݶΛ͔͚Δ: [GraphQLͱPsersisted Query by @Quramy](https://qiita.com/Quramy/items/ b3943a0c27f3ade2c57d)