始める前に、Node v6がインストールされている必要があります。ただし、例はほとんどの場合、以前のバージョンのNodeでも動作するはずです。このガイドでは、トランスパイルが必要な言語機能は使用しませんが、Promise、クラス、アロー関数などのいくつかのES6機能を使用します。もし、これらに慣れていない場合は、最初に調べておくと良いでしょう。
新しいプロジェクトを作成し、現在のディレクトリにGraphQL.jsをインストールするには、
npm initnpm install graphql --save
GraphQLクエリを処理するには、Query
型を定義するスキーマと、各APIエンドポイントに「リゾルバー」と呼ばれる関数を持つAPIルートが必要です。「Hello world!」を返すだけのAPIの場合、このコードをserver.js
というファイルに記述できます。
var { graphql, buildSchema } = require("graphql")
// Construct a schema, using GraphQL schema languagevar schema = buildSchema(` type Query { hello: String }`)
// The rootValue provides a resolver function for each API endpointvar rootValue = { hello: () => { return "Hello world!" },}
// Run the GraphQL query '{ hello }' and print out the responsegraphql({ schema, source: "{ hello }", rootValue,}).then(response => { console.log(response)})
これを次のように実行すると
node server.js
GraphQLレスポンスが出力されるはずです。
{ data: { hello: "Hello world!" }}
おめでとうございます - これでGraphQLクエリを実行しました。!
実用的なアプリケーションでは、おそらくコマンドラインツールでGraphQLを実行するのではなく、APIサーバーからGraphQLクエリを実行したいでしょう。HTTP経由でAPIサーバーにGraphQLを使用するには、Express GraphQLサーバーの実行を確認してください。