Web フレームワーク gin の使用を学習する Golang

Golang 学習のための Web フレームワーク gin の使用

インターネットの発展に伴い、Web アプリケーションはさまざまなソフトウェア システムの標準構成になりました。 Webアプリケーションのサーバーサイド開発言語はますます多様化しています。中でも、Golang の高いパフォーマンスと簡潔な構文スタイルは、開発者の間でますます好まれています。この記事では、Golang で一般的に使用される Web フレームワークの 1 つである gin を紹介します。

1. gin とは

gin は Go 言語で書かれた Web アプリケーション フレームワークです。 httprouter パッケージと net/http 標準ライブラリに基づいており、高いパフォーマンス、効率性、使いやすさ、そして強力な機能を提供します。 gin を使用すると、Web サーバーを迅速に構築し、RESTful API、ルーティング グループ化、ミドルウェア、パラメーター バインディング、テンプレート レンダリングなどの機能をサポートできます。

2. gin のインストール

gin フレームワークを使用する前に、まず gin をインストールする必要があります。次のコマンド ラインを使用してインストールできます:

go get -u github.com/gin-gonic/gin

3. gin の基本的な使用法

以下では、例を使用して、gin を使用して簡単な Web サービスを作成する方法を示します。

1. gin パッケージのインポート

コード ファイルの先頭に gin パッケージをインポートします:

import "github.com/gin-gonic/gin"

2. gin エンジンを作成します

gin.New() メソッドを使用して、新しい gin エンジンを作成します。

r := gin.New()

3. ルートの定義

r.GET()、r.POST()、r.PUT()、および r.DELETE() メソッドを使用してルートを定義します。このうち、第 1 パラメータはルーティング パス、第 2 パラメータはルーティング処理関数です。

r.GET("/", func(c *gin.Context) {
    c.String(http.StatusOK, "Hello World")
})

4. サービスの開始

r.Run() メソッドを使用してサービスを開始し、サービス アドレスとポート番号を指定します。

r.Run(":8080")

完全なコードは次のとおりです:

package main

import (
    "net/http"

    "github.com/gin-gonic/gin"
)

func main() {
    r := gin.New()

    r.GET("/", func(c *gin.Context) {
        c.String(http.StatusOK, "Hello World")
    })

    r.Run(":8080")
}

4. ジンのルーティング

1. 基本的なルーティング

ジンでは、ルーティングGET、POST、PUT、DELETE、PATCH、HEAD、OPTIONSなどのルーティングメソッド、リクエストパス、処理関数で構成されます。 r.GET()、r.POST()、r.PUT()、r.DELETE() などのメソッドを使用してルートを定義します。

r.GET("/index", func(c *gin.Context) {
    c.String(http.StatusOK, "Hello World")
})

2. パラメータを含むルート

パラメータを含むルートを定義するには、コロン (:) を使用します。

r.GET("/hello/:name", func(c *gin.Context) {
    name := c.Param("name")
    c.String(http.StatusOK, "Hello %s", name)
})

3. 複数のリクエスト タイプのルーティング

r.Handle() メソッドを使用して、複数のリクエスト タイプのルーティングを定義します。

r.Handle("GET", "/hello", func(c *gin.Context) {
    c.String(http.StatusOK, "Hello World")
})

r.Handle("POST", "/hello", func(c *gin.Context) {
    c.String(http.StatusOK, "Hello POST")
})

4. ルーティング グループ化

r.Group() メソッドを使用してルーティング グループ化を実装し、ミドルウェアと共有ルーティング処理関数をルーティング グループに追加できます。

v1 := r.Group("/v1")
{
    v1.GET("/hello", func(c *gin.Context) {
        c.String(http.StatusOK, "Hello v1")
    })
}

5.gin ミドルウェア

1. ミドルウェアの使用

gin ミドルウェアを使用すると、認証やロギング、キャッシュ、パフォーマンス分析など、多くの便利な機能を実現できます。 、など。ミドルウェアを登録するには、r.Use() メソッドを使用します。

r.Use(gin.Logger())
r.Use(gin.Recovery())

2. ミドルウェアの作成

ミドルウェアの作成方法は非常に簡単で、gin.Context 型のパラメータを持つ関数を作成し、関数内で呼び出すだけです。 c.Next()メソッドはミドルウェアの機能を実現できます。

func Auth() gin.HandlerFunc {
    return func(c *gin.Context) {
        if c.GetHeader("Authorization") != "token" {
            c.AbortWithStatus(http.StatusUnauthorized)
        }
        c.Next()
    }
}

r.GET("/hello", Auth(), func(c *gin.Context) {
    c.String(http.StatusOK, "Hello World")
})

6.gin パラメータのバインド

1. クエリ パラメータのバインド

c.Query() メソッドを使用してクエリ パラメータを取得します。

r.GET("/hello", func(c *gin.Context) {
    name := c.Query("name")
    age := c.Query("age")
    c.String(http.StatusOK, "name: %s, age: %s", name, age)
})

2. POST フォームのバインド

c.PostForm() メソッドを使用して、POST フォーム データを取得します。

r.POST("/login", func(c *gin.Context) {
    username := c.PostForm("username")
    password := c.PostForm("password")
    c.JSON(http.StatusOK, gin.H{
        "username": username,
        "password": password,
    })
})

3. JSON データのバインド

c.BindJSON() メソッドを使用して JSON データをバインドします。

type User struct {
    Name     string `json:"name"`
    Password string `json:"password"`
}

r.POST("/login", func(c *gin.Context) {
    var user User
    if err := c.BindJSON(&user); err == nil {
        c.JSON(http.StatusOK, gin.H{
            "name":     user.Name,
            "password": user.Password,
        })
    } else {
        c.JSON(http.StatusBadRequest, gin.H{
            "error": err.Error(),
        })
    }
})

7.gin テンプレートのレンダリング

gin フレームワークを使用すると、テンプレートのレンダリングが容易になり、html、json、xml などの複数のテンプレート エンジンがサポートされます。

1. テンプレート エンジンのインストール

go get コマンドを使用して、テンプレート エンジンをインストールします。

go get -u github.com/gin-gonic/gin
go get -u github.com/gin-gonic/contrib/jwt
go get -u github.com/jinzhu/gorm

2. テンプレートの読み込み

gin.LoadHTMLGlob() メソッドを使用して、テンプレート ファイルを読み込みます。

r.LoadHTMLGlob("html/*")

3. テンプレートのレンダリング

c.HTML() メソッドを使用してテンプレートをレンダリングします。

r.GET("/html", func(c *gin.Context) {
    c.HTML(http.StatusOK, "index.html", gin.H{
        "title": "Welcome Gin Web Framework",
    })
})

8. 結論

この記事では、gin フレームワークを使用して Web サーバーを構築するための基本的な手順とテクニックを紹介します。 Golang の高いパフォーマンスと簡潔な構文スタイルにより、Web サービス開発の開発者の間で Golang の人気が高まっています。この記事が Golang Web サーバー開発者にインスピレーションと助けをもたらすことを願っています。

以上がWeb フレームワーク gin の使用を学習する Golangの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。