Golang 開発: GraphQL ベースの API インターフェイスの実装-Golang-php.cn

Golang 開発: GraphQL ベースの API インターフェイスの実装

王林

リリース： 2023-09-20 08:15:11

オリジナル

1422 人が閲覧しました

Golang 開発: GraphQL ベースの API インターフェイスの実装

はじめに:
今日のソフトウェア開発では、柔軟で効率的かつスケーラブルな API インターフェイスを構築することが非常に重要です。。重要。 GraphQL は、新しいクエリ言語およびランタイムとして、API インターフェイスを定義およびクエリするための、より柔軟で直感的かつ効率的な方法を提供します。この記事では、Golang を使用して GraphQL ベースの API インターフェイスを開発する方法を紹介し、対応するコード例を提供します。

1.GraphQL とは何ですか?
GraphQL は、Facebook によって開発されたクエリ言語およびランタイムです。従来の RESTful API とは異なり、GraphQL を使用すると、クライアントは必要なデータ構造とフィールドを正確に定義し、クライアントが必要とするデータのみを返すことができるため、従来の API インターフェイスでの過剰な取得や非効率なクエリの問題が回避されます。 GraphQL は複数のクエリと複数のデータソースの組み合わせもサポートしているため、フロントエンド開発者はバックエンドに複数のリクエストを必要とせずにデータをクエリする際の柔軟性が高まります。

2. Golang と GraphQL
Golang は、効率的でスケーラブルで強力なバックエンドアプリケーションを開発するための言語です。 Golang を使用して GraphQL ベースの API インターフェイスを開発することで、Golang の同時実行パフォーマンスとスケーラビリティを最大限に活用し、効率的なデータクエリと処理を実現できます。

3. 開発環境をセットアップする
開発を開始する前に、GraphQL の開発をサポートするために必要なライブラリをいくつかインストールする必要があります。

Golang のインストール
まず、Golang をインストールする必要があります。 Golang の最新バージョンは、公式 Web サイト (https://golang.org/) からダウンロードしてインストールできます。
GraphQL ライブラリをインストールする
Golang は、GraphQL の開発をサポートする多くのライブラリを提供します。その中で最も人気のあるライブラリは、github.com/graphql-go/graphql、github.com/graph-gophers/graphql-go などです。ニーズに応じて、これらのライブラリの 1 つを選択することも、他のライブラリを選択することもできます。

この記事では、github.com/graphql-go/graphql ライブラリを使用して GraphQL ベースの API インターフェイスを実装することを選択します。

まず、ターミナルを開き、次のコマンドを使用してライブラリをインストールします:
go get github.com/graphql-go/graphql

4. GraphQL API インターフェイスを実装します
以下では、簡単な例を使用して、Golang を使用して GraphQL ベースの API インターフェイスを実装する方法を示します。

ブログサイトを構築しており、ブログのタイトル、作成者、テキストをクエリする API インターフェイスを実装する必要があると仮定します。

GraphQL スキーマの作成
まず、GraphQL スキーマを作成してデータ構造とクエリタイプを定義する必要があります。この例では、ブログオブジェクトとクエリタイプを定義します。

type Blog struct {
    ID     graphql.ID
    Title  string
    Author string
    Body   string
}

var (
    blogs   []*Blog
    root    *graphql.Object
    schema  *graphql.Schema
)

func init() {
    root = graphql.NewObject(graphql.ObjectConfig{
        Name: "Query",
        Fields: graphql.Fields{
            "blog": &graphql.Field{
                Type: graphql.NewList(blogType),
                Resolve: func(p graphql.ResolveParams) (interface{}, error) {
                    return blogs, nil
                },
            },
        },
    })

    schema, _ = graphql.NewSchema(graphql.SchemaConfig{
        Query: root,
    })
}

ログイン後にコピー

API インターフェイスの作成
次に、GraphQL クエリリクエストを受信して処理し、対応する結果を返す API インターフェイスを作成する必要があります。

GraphQL リクエストを処理する HTTP ハンドラーを作成し、graphql-go ライブラリの Execute 関数を使用して GraphQL クエリを実行します。

func GraphqlHandler(w http.ResponseWriter, r *http.Request) {
    result := graphql.Do(graphql.Params{
        Schema:        *schema,
        RequestString: r.URL.Query().Get("query"),
    })

    if len(result.Errors) > 0 {
        log.Printf("execution failed: %v", result.Errors)
        http.Error(w, result.Errors[0].Message, http.StatusInternalServerError)
        return
    }

    json.NewEncoder(w).Encode(result)
}

ログイン後にコピー

API インターフェイスの登録
最後に、API インターフェイスを登録し、GraphQL クエリリクエストに応答するために HTTP サーバーを起動する必要があります。

func main() {
    http.HandleFunc("/graphql", GraphqlHandler)
    log.Fatal(http.ListenAndServe(":8080", nil))
}

ログイン後にコピー

5. GraphQL の API インターフェイスをテストする
HTTP サーバーを起動した後、ツール (Postman など) を使用して GraphQL の API インターフェイスをテストできます。

POST リクエストを http://localhost:8080/graphql に送信し、リクエストヘッダーの Content-Type を application/json に設定します。リクエストの本文は次のサンプルクエリです:

{
    "query": "{ blog { title author body } }"
}

ログイン後にコピー

サーバーは、リクエストに必要なフィールドのみを返す、対応するクエリ結果を返します。

6. 概要
この記事では、Golang を使用して GraphQL に基づいた API インターフェイスを開発する方法を紹介し、対応するコード例を示します。 Golang と GraphQL を使用することで、効率的な API インターフェイスを迅速かつ柔軟に構築し、クライアントのニーズをより適切に満たすことができます。この記事が、GraphQL 開発の理解と応用に役立つことを願っています。

以上がGolang 開発: GraphQL ベースの API インターフェイスの実装の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。