GraphQLについての調査

tanihiro commented 4 years ago

tanihiro commented 4 years ago

ServerのFrameworkとしてはApolloServerが良さそう
- ReactやVueでは互換性のあるApolloClientが使える
- ExpressやFastifyと組み合わせて利用できる
- GraphQLの解析なども行える
TypeORMと連携させるTypeGraphQLというのもある（https://typegraphql.com/）
- デコレータ地獄になりそうな気配
- Entityをschemaとして扱えるのか？
Schema定義をどうやるかが大きなポイントになりそう

tanihiro commented 4 years ago

ApolloServerとTypeGraphQLでモックを作ってみる

tanihiro commented 4 years ago

GraphQLはスキーマファーストで開発するかコードファーストで開発するかを選択する必要がある
TypeGraphQLはコードファースト
- デコーレータでSchemaを定義していくので、デコレータ地獄になりそう
graphql-nexus (https://github.com/graphql-nexus/schema) というのもあり、これもコードファースト
- これはデコレータではなく、TypeScriptでガシガシSchemaを記述していくっぽい
- こっちのほうがよさそう
スキーマファーストの場合は、スキーマを定義したあと、https://github.com/dangcuuson/graphql-schema-typescript や、ApolloCLIなどでTypeScriptのファイルを生成して利用する
- このときスキーマファイルをどう管理するか（分割したりなど）というのは少し工夫が必要そう。Swaggerのように別ファイルを読み込んだりする仕組みはそこまで整ってなさそう
どちらかといえば、スキーマファーストのほうが、生成したファイルをクライアントでも使い回せると思うのでよさそうだけど、どうなんだろうか
スキーマ定義からドキュメントを作成するツールもある https://github.com/2fd/graphdoc

tanihiro commented 4 years ago

@dameleon GraphQLについてもざっくりとモックを作ってみました。こちらもお手すきでおレビュー頂けますと！

atman-inc / esprit