クイックスタート

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

要件

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

インストール

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

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

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

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

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

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

import "net/http"

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

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

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

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

プロジェクトを実行する

$ 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() {
	r := gin.Default()
	r.GET("/ping", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "pong",
		})
	})
	r.Run() // 0.0.0.0:8080 でサーバーを立てます。
}

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

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

最終更新 29.04.2022: update: set github branch in config file (#189) (d146b35)