Gin 설치와 기본 example 확인해 보기

※ 참고

Gin example 포스트를 작성하면서 govendor를 사용했었습니다.

하지만 govendor 작성자도 더 이상 사용하지 말라고 합니다. go mod가 더 좋다고 합니다.

Gin Tutorial은 아래 url을 참고해 주세요.

https://blog.logrocket.com/how-to-build-a-rest-api-with-golang-using-gin-and-gorm/

Golang으로 Web Server 만드는 걸 배우다 혼란에 빠졌습니다.

Java의 Spring이나 Python의 Django, Flask, 그리고 Swift에도 Vaper, Kitura, Perfect같은 Framework이 있는데 Go에서 쌩으로 다 하려니 배울것도 많고 힘이듭니다. 그래서 전에 Swift를 배울때 처럼 첫 시작을 Framework 하나를 잡아 공부하는 방향으로 결정했습니다.

그런데 아직 Go에서는 주력 Framework이 보이지 않는것 같습니다.

아래 링크는 Go Framework의 github star와 Fork 된 수로 랭킹을 만든 페이지입니다.

https://github.com/mingrammer/go-web-framework-stars

저는 우선 초짜이니 가장 위에 링크된 것부터 배워보기로 했습니다.

아마 gin과 beego에 집중하지 않을까 싶습니다.

먼저 Gin을 보겠습니다.

https://github.com/gin-gonic/gin

튜토리얼이나 설명이 잘 돼있는 것 같습니다.

바로 설치 들어갑니다.

먼저 GOPATH 경로로 이동합니다. 그리고 github에서 gin을 받습니다.

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

그리고 go package를 관리해 주는 vendor tool도 설치합니다. gin에서는 Govendor로 설명하고 있네요.

https://github.com/govend/govend

$ go get github.com/kardianos/govendor

이제 프로젝트 폴더를 생성하고 안으로 이동합니다.

저는 $GOPATH/src/github.com/dejavuwing/ginbasic에 만들었습니다.

$ mkdir -p $GOPATH/src/github.com/dejavuwing/ginbasic && cd "$_"

프로젝트 폴더 안에서 govendor를 초기화하고 gin 1.3 버전을 받습니다.

$ govendor init
$ govendor fetch github.com/gin-gonic/gin@v1.3

github에서 gin의 기본 exsample을 받습니다.

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

curl로 main.go를 다운받았다면 소스도 한번 봐볼까요?

package main

import (
	"net/http"

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

var db = make(map[string]string)

func setupRouter() *gin.Engine {
	// Disable Console Color
	// gin.DisableConsoleColor()
	r := gin.Default()

	// Ping test
	r.GET("/ping", func(c *gin.Context) {
		c.String(http.StatusOK, "pong")
	})

	// Get user value
	r.GET("/user/:name", func(c *gin.Context) {
		user := c.Params.ByName("name")
		value, ok := db[user]
		if ok {
			c.JSON(http.StatusOK, gin.H{"user": user, "value": value})
		} else {
			c.JSON(http.StatusOK, gin.H{"user": user, "status": "no value"})
		}
	})

	// Authorized group (uses gin.BasicAuth() middleware)
	// Same than:
	// authorized := r.Group("/")
	// authorized.Use(gin.BasicAuth(gin.Credentials{
	//	  "foo":  "bar",
	//	  "manu": "123",
	//}))
	authorized := r.Group("/", gin.BasicAuth(gin.Accounts{
		"foo":  "bar", // user:foo password:bar
		"manu": "123", // user:manu password:123
	}))

	authorized.POST("admin", func(c *gin.Context) {
		user := c.MustGet(gin.AuthUserKey).(string)

		// Parse JSON
		var json struct {
			Value string `json:"value" binding:"required"`
		}

		if c.Bind(&json) == nil {
			db[user] = json.Value
			c.JSON(http.StatusOK, gin.H{"status": "ok"})
		}
	})

	return r
}

func main() {
	r := setupRouter()
	// Listen and Server in 0.0.0.0:8080
	r.Run(":8080")
}

go run으로 바로 실행해 봅니다.

$ go run main.go 
[GIN-debug] [WARNING] Now Gin requires Go 1.6 or later and Go 1.7 will be required soon.

[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.

[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.
 - using env:	export GIN_MODE=release
 - using code:	gin.SetMode(gin.ReleaseMode)

[GIN-debug] GET    /ping                     --> main.setupRouter.func1 (3 handlers)
[GIN-debug] GET    /user/:name               --> main.setupRouter.func2 (3 handlers)
[GIN-debug] POST   /admin                    --> main.setupRouter.func3 (4 handlers)
[GIN-debug] Listening and serving HTTP on :8080

우선 하나만 해보겠습니다. ping 갑니다.

다른 경로들은 인증과 관련된 것입니다. 

이건 다른 sample에서 다루도록 하겠습니다.

여기까지 gin 설치와 기본 example 확인이었습니다.