まとめ

この章では、Ginの基本を学びつつ、実際にコードでルーティング・リクエスト処理・ミドルウェアの実装を体験しました。

  • Ginは、net/http を薄くラップしたGoのWebフレームワークで、Goで最も広く使われている
  • gin.Default() でロガー・リカバリ入りの gin.Engine を作成し、r.Run(":ポート") でサーバを起動できる
  • r.GET / r.POST などでHTTPメソッドとパスを1行で登録でき、ハンドラは *gin.Context の1引数で書ける
  • c.JSON(status, gin.H{...}) により、Content-Type設定・ステータスコード書き込み・JSONエンコードを1行で行える
  • パスパラメータは :name + c.Param("name")、クエリパラメータは c.Query / c.DefaultQuery で取り出せる
  • リクエストボディは c.ShouldBindJSON(&input) でデコードとバリデーション(binding:"required" など)を同時に扱える
  • ミドルウェアは gin.HandlerFunc を返す関数として書き、r.Use で全ルートに適用できる
  • r.Group("/api/v1") によるルータグループで、共通プレフィックスや共通ミドルウェアを持つエンドポイントをまとめて扱える

次の章では、GoでREST APIを作る流れをハンズオン形式で体験します。