GraphQL - オペレーションと変数の使用

はじめに

GraphQLのドキュメントを読んでまとめていきます。

ところどころ気になった部分を調べて補足したり解釈を入れています。

GraphQLクエリにはオペレーション名を付けることができるためコードの明確性が向上します。

query PlantDetails {
  plant {
    type
    environment {
      climate
    }
  }
}

オペレーションの種類は、query、mutation、またはsubscriptionのいずれかであり、行おうとしている操作の種類を示します。

ほとんどのアプリケーションでは、フィールドへの引数は動的です。GraphQLには、クエリから動的な値を取り出し、別の辞書として渡すための方法があります。

query PlantDetailsByClimate($climate: ClimateType) {
  plant(climate: $climate) {
    type
    environment {
      climate
    }
  }
}

{
  "climate": "TROPICAL"
}

変数の定義は、クエリ内の($climate: ClimateType)のような部分で、型付き言語の関数の引数の定義のように動作します。

変数にはデフォルト値も割り当てることができます。

query PlantDetailsByClimate($climate: ClimateType = DESERT) {
  plant(climate: $climate) {
    type
    environment {
      climate
    }
  }
}

本記事の内容は以上になります！