GraphQL APIの構(gòu)築方法を?qū)Wぶことは非常に挑戦的です。ただし、10分でGraphQL APIを使用する方法を?qū)Wぶことができます！そして、私はそのための完璧なAPIを持っています：JavaScript GraphQL APIの新しい、新鮮なコード狀態(tài)。

JavaScript調(diào)査の狀態(tài)は、JavaScriptランドスケープの年次調(diào)査です。私たちは4年間それを行っており、最新のエディションは20,000人以上の開発者に到達(dá)しました。

私たちは常にショーケースサイトを構(gòu)築するためにギャツビーに依存してきましたが、今年まで、「Elasticsearch」として単なる人間に知られている何らかの恐ろしい魔法を通じて生成された靜的なYAMLファイルの形でギャツビーにデータを提供していました。

しかし、GatsbyはとにかくGraphQLとして食べるすべてのデータソースをうんざりするので、私たちは仲介者をスキップしてGraphQLを直接供給することもできますが！はい、私は知っています、この比phorは2番目にグロッサーになっており、私はすでにそれを後悔しています。私のポイントは、データ用の內(nèi)部GraphQL APIを構(gòu)築したことです。今では、あなたもデータセットを簡(jiǎn)単に利用できるように、すべての人が利用できるようにしています。

「でも待って」とあなたは言います。 「私は一生、グラフクルを?qū)Wぶ時(shí)間がなくなった刃を勉強(qiáng)してきました！」心配しないでください：それはこの記事が登場(chǎng)するところです。

graphqlとは何ですか？

そのコアでは、GraphQLはAPIから受け取るデータを指定できる構(gòu)文です。データベースではなく、 APIと言ったことに注意してください。 SQLとは異なり、GraphQLクエリはデータベースに直接移動(dòng)するのではなく、GraphQL APIエンドポイントに移動(dòng)します。これにより、データベースまたはその他のデータソースに接続できます。

休憩のような古いパラダイムよりもGraphQLの大きな利點(diǎn)は、あなたが望むものを?qū)い亭毪长趣扦毪长趣扦?。例えば?/p>

クエリ{
  ユーザー（ID： "foo123"）{
  名前
 }
}

単一の名前フィールドを持つユーザーオブジェクトを取得します。また、メールが必要ですか？ただしてください：

クエリ{
 ユーザー（ID： "foo123"）{
  名前
  メール
 }
}

ご覧のとおり、この例のユーザーフィールドはID引數(shù)をサポートしています。そして今、私たちはGraphQLの最もクールな機(jī)能に到達(dá)します。

クエリ{
 ユーザー（ID： "foo123"）{
  名前
  メール
    投稿{ 
      タイトル
      體
    }
  }
}

ここでは、ユーザーの投稿を見つけて、タイトルとボディをロードしたいと言っています。 GraphQLの良いところは、APIレイヤーが実際のデータベース內(nèi)にネストされた形式に保存されていない場(chǎng)合でも、データベースと直接話しかけていないため、その特定の情報(bào)をその特定の形式で取得する方法を見つけ出すことができることです。

Sebastian Schollは、GraphQLをカクテルミキサーで初めて會(huì)ったかのように、GraphQLを説明する素晴らしい仕事をしています。

graphiqlの紹介

GraphiQL（そこにある「I」に注意）は、最も一般的なGraphQl IDEであり、JavaScript APIの狀態(tài)を探索するために使用するツールです。 Graphiql.stateofjs.comで今すぐ起動(dòng)でき、エンドポイント（api.stateofjs.com/graphql）に自動(dòng)的に接続できます。 UIは、エクスプローラーパネル、クエリビルダー、および結(jié)果パネルの3つの主要な要素で構(gòu)成されています。後でドキュメントパネルを追加しますが、今のところシンプルにしましょう。

Explorer Tabは、OneGraphによって開発および維持されているGraphiQLのターボブーストバージョンの一部です。私たちがそれを統(tǒng)合するのを手伝ってくれた彼らに感謝します。獨(dú)自のGraphIQLインスタンスを展開する場(chǎng)合は、必ずサンプルリポジトリをご覧ください。

心配しないでください、私はあなたにまだコードを書くようにするつもりはありません。代わりに、過去4年間にわたるReactの開発者エクスペリエンスに対応するものなど、既存のGraphQLクエリから始めましょう。

私たちのサイトを構(gòu)築するためにGraphQLを內(nèi)部的に使用していると言ったことを覚えていますか？ APIを公開するだけでなく、クエリ自體も公開しています。小さな「エクスポート」ボタンをクリックし、[GraphQL]タブのクエリをコピーし、GraphIQLのクエリビルダーウィンドウ內(nèi)に貼り付け、[再生]ボタンをクリックします。

すべてが計(jì)畫に従って進(jìn)んだ場(chǎng)合、結(jié)果パネルにデータが表示されるのを確認(rèn)する必要があります。クエリを分析してみましょう。

クエリReact_experienceQuery {
  調(diào)査（調(diào)査：JS）{
    ツール（ID：React）{
      id
      実在物 {
        ホームページ
        名前
        github {
          URL
        }
      }
      経験 {
        alleears {
          年
          合計(jì)
          完了 {
            カウント
            パーセンテージ
          }
          AwarenessEnterestSatisfaction {
            意識(shí)
            興味
            満足
          }
          バケツ{
            id
            カウント
            パーセンテージ
          }
        }
      }
    }
  }
}

最初に、クエリの名前であるReact_ExperienceQueryとともに、GraphQLクエリの開始を定義するクエリキーワードが登場(chǎng)します。クエリ名はGraphQLではオプションですが、デバッグの目的に役立ちます。

次に、調(diào)査上の議論をする最初の分野である調(diào)査を行います。 （CSS調(diào)査も持っているため、問題の調(diào)査を指定する必要がありました。）その後、ID引數(shù)を取得するツールフィールドがあります。そして、その後のすべては、その特定のツールのAPI結(jié)果に関連しています。エンティティは、選択された特定のツールに関する情報(bào)を提供します（例：反応）。経験には実際の統(tǒng)計(jì)データが含まれています。

ここでこれらのすべてのフィールドを通過し続けるのではなく、小さなトリックを教えます：グラフィクル內(nèi)のそれらのフィールドをクリック（またはクリックする）コマンドを教えてください。ドキュメントパネルを表示します。おめでとうございます、あなたはちょうどGraphQLの気の利いたトリックの1つ、自己文書を目撃しました！ドキュメントをAPI定義に直接書くことができ、GraphiQLはエンドユーザーが利用できるようになります。

変數(shù)の変更

物事を少し調(diào)整しましょう。クエリビルダーで、「反応」を「vuejs」に置き換えると、別のクールなgraphqlのことであるauto completionに気付くはずです。これは、間違いを犯さないようにしたり、時(shí)間を節(jié)約するのに非常に役立ちます！再び「再生」を押すと、同じデータが取得されますが、今回はVueの場(chǎng)合です。

エクスプローラーを使用します

これで、もう1つのGraphQL Power Tool：The Explorerのロックを解除します。エクスプローラーは基本的に、API全體のツリーであり、その構(gòu)造を視覚化するだけでなく、単一のコードを書くことなくクエリを構(gòu)築できます。それでは、今回はExplorerを使用してReactクエリを再現(xiàn)してみましょう。

まず、新しいブラウザタブを開いて、Graphiql.stateofjs.comをロードして新たに開始しましょう。 Explorerの調(diào)査ノードをクリックし、その下でツールノードをクリックして、[再生]をクリックします。ツールのIDフィールドは結(jié)果に自動(dòng)的に追加される必要があります。これは、デフォルトの引數(shù)値（「TypeScript」）を「React」に変更するのに適した機(jī)會(huì)です。

次に、掘削し続けましょう。サブフィールドのないエンティティを追加する場(chǎng)合、その下に少し波狀の赤い線が表示され、少なくとも1つ以上のサブフィールドも指定する必要があることがわかります。それでは、少なくともID、名前、ホームページを追加しましょう。もう1つの有用なトリック：GraphIQLに自動(dòng)的に指示して、Explorerでオプションコントロールクリックしてフィールドのすべてのサブフィールドを追加するようにできます。

次は経験です。 JavaScriptサイトの狀態(tài)から最初にコピーされたクエリに近づくものを取得するまで、フィールドとサブフィールドを追加し続けます。選択したアイテムは、クエリビルダーパネル內(nèi)に即座に反映されます。そこに行くと、最初のGraphQLクエリを書きました！

データのフィルタリング

紫色のフィルターのアイテムが経験していることに気付いたかもしれません。これは、実際に私たちのサイトを閲覧するのではなく、GraphQL APIを使用したい理由です。APIによって提供される集約は、回答者の性別、會(huì)社の規(guī)模、給與、國(guó)など、多くの要因によってフィルタリングできます。

フィルターを展開し、コンパニーズを選択し、次にeqとrange_more_than_1000を選択します。大企業(yè)の間でReactの人気を計(jì)算したばかりです！代わりにrange_1を選択すると、フリーランサーと獨(dú)立した開発者の間で同じデータポイントと比較できます。

GraphQLは、フィールドや引數(shù)などの非常に低レベルのプリミティブのみを定義するため、これらのEQ、in、ninなどはGraphQL自體の一部ではなく、APIを設(shè)定するときに自分自身を定義した単なる引數(shù)の一部であることに注意することが重要です。これは最初は多くの作業(yè)になる可能性がありますが、クライアントがAPIを照會(huì)する方法を完全に制御できます。

結(jié)論

GraphQL APIをクエリすることは、特にGraphIQLのような素晴らしいツールでそれを支援することで、それほど大きな取引ではないことを願(yuàn)っています。確かに、実際にGraphQLデータを?qū)g際のアプリに統(tǒng)合することは別の問題ですが、これは主にクライアントとサーバー間のデータ転送の複雑さによるものです。 GraphQLパーツ自體は実際には非常に簡(jiǎn)単です！

GraphQLを始めたい場(chǎng)合でも、データを照會(huì)して驚くべき新しい洞察を思い付くのに十分なことを?qū)Wびたい場(chǎng)合でも、このガイドが有用であることが証明されることを願(yuàn)っています。

また、次の調(diào)査（CSS 2020の狀態(tài)になるはずです）に參加することに興味がある場(chǎng)合は、メーリングリストにサインアップして、起動(dòng)時(shí)に通知できるようにしてください。

JavaScript APIリファレンスの狀態(tài)

API.stateofjs.comのAPI（実際のエンドポイントとGitHub Repoへのリンクを含む）の詳細(xì)については、詳細(xì)を確認(rèn)できます。

JS APIの州內(nèi)で使用される用語の簡(jiǎn)単な用語集です。

トップレベルのフィールド

• 人口統(tǒng)計(jì)：性別、會(huì)社の規(guī)模、給與など、すべての人口統(tǒng)計(jì)情報(bào)を再編成します。
• エンティティ：特定の「エンティティ」（ライブラリ、フレームワーク、プログラミング言語など）に関する詳細(xì)情報(bào)へのアクセスを提供します。
• 機(jī)能：特定のJavaScriptまたはCSS機(jī)能の使用データ。
• 機(jī)能：同じですが、さまざまな機(jī)能全體にわたって。
• マトリックス：相互參照的なヒートマップの設(shè)定に使用されるデータにアクセスできます。
• 意見：特定の質(zhì)問の意見データ（「JavaScriptが正しい方向に動(dòng)いていると思いますか？」）。
• その他ツール： 「その他のツール」セクションのデータ（テキストエディター、ブラウザー、バンドラーなど）。
• リソース： 「リソース」セクション（サイト、ブログ、ポッドキャストなど）のデータ。
• ツール：特定のツール（ライブラリ、フレームワークなど）のデータを體験します。
• ツール：同じですが、さまざまなツールにわたって。
• ツールスランク：さまざまなツールにわたるランキング（認(rèn)識(shí)、関心、満足）。

一般的なフィールド

• 完了：調(diào)査回答者のどの割合が特定の質(zhì)問に答えました。
• バケット：実際のデータを含む配列。
• 年/alleyears：特定の調(diào)査年のデータを取得するかどうか。またはすべての年を含む配列。

以上がgraphQlの練習(xí)JavaScript APIでクエリをクエリしますの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語 Web サイトの他の関連記事を參照してください。