Querystring parameters

Golang/Gin

Querystring parameters

Tongchun 2019. 2. 14. 19:06

url의 ? 뒤에 따라오는 Query String 처리 입니다.

이번 예제는 ? 뒤에 firstname 과 lastname이 map 형태의 parameter로 전달되게 됩니다.

https://github.com/gin-gonic/gin#querystring-parameters

package main

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

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

	r.GET("/welcome", welcomeQueryString)

	return r
}

// Query string parameters are parsed using the existing underlying request object.
// The request responds to a url matching:  /welcome?firstname=Jane&lastname=Doe
func welcomeQueryString(c *gin.Context) {
	firstname := c.DefaultQuery("firstname", "Guest")
	lastname := c.Query("lastname") // shortcut for c.Request.URL.Query().Get("lastname")

	c.JSON(200, gin.H{"firstname": firstname, "lastname": lastname})
}

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

서버의 router에 GET method로 /welcome 이라는 경로를 지정했습니다.

handler 함수로는 welcomeQueryString을 지정했습니다.

func welcomeQueryString(c *gin.Context) {
firstname := c.DefaultQuery("firstname", "Guest")
lastname := c.Query("lastname")
c.JSON(200, gin.H{"firstname": firstname, "lastname": lastname})
}

QueryString을 DefaultQuery() 또는 Query() 함수로 받아올수 있습니다. 이름에서도 보이듯이 DefaultQuery() 함수는 parameter의 값이 없을 경우 "Guest"를 기본값으로 가져옵니다.

이제 실행하고 확인해 보겠습니다.

$ go run server.go 
[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    /welcome                  --> main.welcomeQueryString (3 handlers)
[GIN-debug] Listening and serving HTTP on :8080

먼저 정상적으로 아래처럼 firstname과 lastname 모두 보내보겠습니다.

http://localhost:8080/welcome?firstname=tongchun&lastname=kim