クイックスタート

このクイックスタートでは、コードの集まりからの洞察を収集し、どのようにするかを学びます。

要件

• Gin を利用するには Go 1.16 以上が必要です。

インストール

Gin をインストールするには、まず Go のインストールおよび Go のワークスペースを作ることが必要です。

1. ダウンロードしてインストールする

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

2. コード内でインポートする

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

3. (オプション) net/http をインポートする。http.StatusOK のような定数を使用する場合に必要です

import "net/http"

1. プロジェクトフォルダを作り、 cd で中に入ります。

$ mkdir -p $GOPATH/src/github.com/myusername/project && cd "$_"

2. 開始用テンプレートをプロジェクトディレクトリにコピーする

$ curl https://raw.githubusercontent.com/gin-gonic/examples/master/basic/main.go > main.go

3. プロジェクトを実行する

$ go run main.go

Getting Started

Go のコードを書いて実行する方法がわからない？ ここをクリックしてください.

まず、example.go を作成します。

# 後述のコードが、example.go のファイルにあるとします。
$ touch example.go

次に、下記のコードを example.go に書きます。

package main

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

func main() {
  router := gin.Default()
  router.GET("/ping", func(c *gin.Context) {
    c.JSON(200, gin.H{
      "message": "pong",
    })
  })
  router.Run() // 0.0.0.0:8080 でサーバーを立てます。
}

そして go run example.go でコードを実行します。

# example.go を実行し、ブラウザで 0.0.0.0:8080/ping にアクセスする
$ go run example.go