Mockingbird での GraphQL サーバーの作成

導入

ようこそ！このガイドでは、Mockingbird を使用して GraphQL サーバーを作成する手順を説明します。開発者であってもテスターであっても、このガイドは、模擬 GraphQL サーバーをセットアップし、クエリとミューテーションを作成し、すべてをテストするのに役立ちます。最終的には、開発プロセスをよりスムーズかつ高速にする堅牢なモック サーバーが完成します。

これまでのガイドでは、「Mockingbird を使用したモック サーバーのセットアップ」、「Mockingbird のプリセット: API 開発ワークフローの最適化」、「Mockingbird を使用した複数のプロジェクトとサーバーの作成と管理」などのトピックについて説明しました。これらのガイドは、さまざまなシナリオで Mockingbird を使用するための強固な基盤を提供しました。このガイドはその知識に基づいて、特に Mockingbird を活用して GraphQL サーバーをモックすることに焦点を当てています。以前のガイドが役立つと感じた場合は、Mockingbird を使用した GraphQL の処理の詳細について詳しく説明しているこのガイドも同様に価値があることがわかります。

Mockingbird が GraphQL サーバーのセットアップとテストをどのように簡素化できるかを詳しく見てみましょう。

ステップ 1: Mockingbird をダウンロードしてインストールする

1. Mockingbird GitHub リリース ページに移動します。
2. 最新バージョンをダウンロードします。
3. ダウンロードが完了したら、Mockingbird を開きます。

ステップ 2: 新しいプロジェクトを作成するか、既存のプロジェクトのクローンを作成する

1. Mockingbird を開くと、3 つのオプションを含む「プロジェクトの作成」画面が表示されます。
   • 新しいプロジェクトの作成: プロジェクト名を入力して、新しいプロジェクトを最初から開始します。
   • 既存プロジェクトのクローン: リポジトリ URL と必要な認証の詳細を入力して、プロジェクトのクローンを作成します。
   • 既存のプロジェクトを開く: コンピューターに既に保存されているプロジェクトを開きます。

ステップ 3: サーバーを作成する

1. プロジェクトを設定した後、サーバーを作成する必要があります。
2. サーバーに名前を付けます。
3. 実行するポート番号を指定します。

ステップ 4: 親を作成する

1. 次に、サーバーの親を作成する必要があります。
2. GraphQL 親を作成するオプションを選択します。
3. GraphQL 親の名前を入力します。
4. GraphQL エンドポイントの REST パスを設定します (通常は /graphql)。
5. ドロップダウン メニューを使用して、親をクエリの親にするか突然変異の親にするかを決定します。
6. 必要に応じて、ドット表記を使用してネストされたクエリのスキーマ パスを指定します (例: user.address)。
7. すべてを入力したら、親を保存します。

ステップ 5: クエリまたはミューテーションを作成する

1. [親の詳細] ページで、親のタイプに基づいて [クエリの追加] または [ミューテーションの追加] をクリックします。
2. クエリまたはミューテーションの名前を入力します。この名前はスキーマの署名となり、必要に応じてパラメータを含める必要があります。たとえば、ID を取得する users というクエリは users(id: String) になります。
3. カスタム オブジェクトのような複雑なパラメーターの場合は、タイプとして [Any] を使用します。例: users(param: Any).
4. オプションで、説明を追加します。
5. クエリまたはミューテーションを保存します。

ステップ 6: クエリまたはミューテーションに複数の応答を追加する

1. クエリまたはミューテーションの詳細ページに移動します。
2. 「応答を追加」をクリックします。
3. 開いたウィンドウに応答を入力します。次の 3 つのオプションがあります。
   • JSON: JSON 応答の場合、タイプを自動的に生成できます。 [生成] をクリックして、エディターで応答タイプを作成します。
   • 関数: 関数応答の場合、応答タイプを手動で挿入する必要があります。あるいは、JSON 応答から開始して型を生成し、次に関数に切り替えます。
   • プロキシ: プロキシ応答の場合、手動で応答タイプを挿入するか、JSON 応答を使用して最初にタイプを生成してから、プロキシに切り替えます。
4. また、「応答タイプ名」フィールドに応答のメインのタイプ名を入力します。
5. 応答を保存します。

ステップ 7: プロキシ モードを有効にする (オプション)

1. Mockingbird は、GraphQL のプロキシ サーバーとして機能します。クエリまたは変更がローカルで見つからない場合、リクエストはターゲット サーバーに転送されます。
2. ターゲット サーバーから応答を取得したら、クエリとその応答の両方をコンソールから Mockingbird に追加できます。

ステップ 8: サーバーを起動してテストする

1. サーバーを起動して構成を適用します。
2. サーバーが実行されると、GraphQL プレイグラウンドへのリンクが表示されます。
3. このリンクを使用してプレイグラウンドを開きます。
4. セットアップ用のサンプル クエリをコピーするボタンもあります。
5. サンプル クエリをプレイグラウンドに貼り付けて、GraphQL サーバーから目的の応答が得られることを確認します。

エピローグ

Mockingbird を使用すると、GraphQL サーバーをモックする複雑なタスクがはるかに簡単になります。このツールは開発者やテスターに​​最適で、実際のサーバーが構築されるのを待たずにさまざまなシナリオをシミュレートできます。複数の応答の作成、型の生成、セットアップ間の簡単な切り替えなどの機能を備えた Mockingbird は、開発およびテストのプロセスを合理化します。

プロキシモード

Mockingbird の傑出した機能の 1 つは、GraphQL に対してもプロキシ サーバーとして機能する機能です。この機能は、Mockingbird でローカルに定義されていないクエリやミューテーションがある場合に非常に役立ちます。仕組みは次のとおりです:

• リクエストの転送: ローカルの Mockingbird 設定でクエリまたはミューテーションが見つからない場合、Mockingbird はリクエストをターゲット サーバーに転送します。これにより、ローカルでまだモックされていない場合でも、常に応答を受け取ることができます。

• 応答のキャプチャ: Mockingbird がターゲット サーバーから応答を受信すると、クエリとその応答の両方をローカルの Mockingbird セットアップに追加できます。これは、事前にすべての応答を手動で定義しなくても、実際のデータを使用して模擬サーバーを迅速に構築できることを意味します。

• セットアップの簡素化: このプロキシ機能により、実際のデータを使用して模擬サーバーを迅速かつ手間なくセットアップできます。考えられるすべてのクエリと応答を手動で入力する代わりに、受信したクエリと応答を Mockingbird にキャプチャして保存させることができます。

この機能は、特に動的な開発およびテストのシナリオにおいて、現実的なモック環境を迅速にセットアップするのに最適です。これにより、時間と労力が節約され、最小限の手動介入でモック サーバーが可能な限り正確かつ包括的になることが保証されます。

新機能の開発、自動テストの実行、複雑な統合のセットアップのいずれの場合でも、Mockingbird のプロキシ機能により時間を節約し、エラーを削減できます。その柔軟性と使いやすさにより、最新のソフトウェア開発およびテスト環境にとって重要なツールとなっています。

Mockingbird を使用すると、模擬環境が信頼性があり効率的であることがわかり、アプリケーションの構築と改良に集中できます。

コミュニティに参加する

このガイドが役に立ったなら、試してみてはいかがでしょうか? Mockingbird をダウンロードして、今すぐ独自のモック サーバーの構築を開始できます。見たものが気に入ったら、GitHub でスターを付けることは大きな意味を持つでしょう。それは、プロジェクトへのサポートを示す小さな方法です。貢献にご興味がございましたら、ぜひご参加ください。皆様のフィードバックと貢献が、アップデートごとに Mockingbird をより良くする原動力となります。

以上がMockingbird での GraphQL サーバーの作成の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。