本章の概要

この章では、GoのWebフレームワークであるGinの基本について概要を解説し、ハンズオン形式で実際に動作させながら学習します。これにより、ルーティング・パスパラメータ・リクエストボディ・ミドルウェアなど、GinでWebサーバを作る基本が身につきます。

1. 本章の目的

前章までで、net/http を使ったWebサーバの作り方(net/http入門)と、GORMによるDB操作(GORM入門)を扱ってきました。標準ライブラリだけでもWebサーバは十分に作れますが、ハンドラごとのJSONレスポンス書き出しやリクエストボディの解析、ミドルウェアの用意など、繰り返し書く定型部分が増えてくると記述量が膨らみます。Gin はこの定型部分を薄くラップし、ハンドラ・レスポンス・バリデーションを短く書けるようにしたGoのWebフレームワークです。次章の GoでREST APIを作ろう でGin+GORMの組み合わせを扱う前段として、Gin単体の書き味を押さえます。

2. ハンズオンの流れ

Ginで最小のWebサーバを立ち上げるところから始めて、パスパラメータ・クエリパラメータ・JSONリクエストボディ・自動バリデーション・ミドルウェア・ルータグループまで段階的に実装します。要所で net/http の書き方にも触れながら、Ginの書き味を確認します。

3. 事前準備

3.1 前提となる講座

この章では、以下の知識を前提としています。自信がない場合は先に関連講座を実施してみましょう。

講座名 必要な知識
Webアプリケーションの基本 HTTPリクエスト・レスポンスやWebアプリケーションの基本構造

3.2 必要なツール

この章では、以下のツールを使用します。まだインストールしていない場合は、リンク先の手順に沿って準備をお願いします。

ツール名 関連箇所 理由
Visual Studio Code Visual Studio Codeのインストール Ginを使ったコードを記述するエディタとして使用する
Go Goのインストール Ginを利用するコードのランタイムとして使用する