CRUD処理の実装

ここからは、5つのCRUD処理を1つずつ実装していきます。各節では、handler.go にハンドラ関数を追加し、main.go に対応するルートを1行追加してから、curl で動作を確認する流れで進めます。実装順序は Create → Index → Show → Update → Delete です。

1. ノートの作成(Create)

最初のエンドポイントとして、ノートを新規作成する POST /notes を追加します。

1.1 実装

notes-gin フォルダに handler.go を作成します。

notes-gin/
├── go.mod
├── go.sum
├── handler.go  ← このファイルを作成
├── main.go
└── model.go

ノート作成のハンドラを定義するため、作成した handler.go に以下の内容を記述して保存します。

package main

import (
    "net/http"

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

func createNote(c *gin.Context) {
    var input Note
    if err := c.ShouldBindJSON(&input); err != nil {
        c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
        return
    }
    if err := db.Create(&input).Error; err != nil {
        c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
        return
    }
    c.JSON(http.StatusCreated, input)
}

続いて、POST /notes を createNote に紐づけるため、main.go の r := gin.Default() の下、r.Run(":8080") の上に、以下の1行を追加してルートを登録します。

    r.POST("/notes", createNote)

1.2 動作確認

既存のサーバが動いている場合は Ctrl+C で停止し、以下のコマンドで再起動します。

go run .

別のターミナルで、ノートを3つ作成します。この後の Index(一覧取得)と Show(単一取得)の違いを比較しやすくするため、複数件を先に登録しておきます。まず1件目です。

curl -X POST http://localhost:8080/notes -H "Content-Type: application/json" -d '{"title":"買い物","body":"卵とパン"}'

以下のような実行結果が表示されます(id と created_at は環境により変わります)。

{"id":1,"title":"買い物","body":"卵とパン","created_at":"2026-07-15T12:00:00+09:00"}

続いて2件目です。

curl -X POST http://localhost:8080/notes -H "Content-Type: application/json" -d '{"title":"会議メモ","body":"9時から進捗共有"}'

以下のような実行結果が表示されます。

{"id":2,"title":"会議メモ","body":"9時から進捗共有","created_at":"2026-07-15T12:00:01+09:00"}

最後に3件目です。

curl -X POST http://localhost:8080/notes -H "Content-Type: application/json" -d '{"title":"読書メモ","body":"Go言語入門書"}'

以下のような実行結果が表示されます。

{"id":3,"title":"読書メモ","body":"Go言語入門書","created_at":"2026-07-15T12:00:02+09:00"}

POST /notes にJSONを送信するたびに、DBに保存されて、自動採番された id と作成日時 created_at を含むレスポンスが返りました。この後の Index / Show の節では、この3件を使って一覧取得と単一取得の違いを確認していきます。

⚠️ 「404 page not found」が返る場合
main.go に r.POST("/notes", createNote) の1行が追加されていないか、func main() { ... } の外側に書かれている可能性があります。r := gin.Default() の下、r.Run(":8080") の上に書かれていることを確認し、保存後に Ctrl+C で既存サーバを止めて go run . で再起動してください。以降の CRUD 節でも同じチェックが有効です。

1.3 コードの解説

var input Note
if err := c.ShouldBindJSON(&input); err != nil {
    c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
    return
}

c.ShouldBindJSON(&input) で、リクエストボディのJSONを Note 構造体にデコードすると同時に、binding:"required" タグに基づくバリデーションを実行します。失敗した場合は 400 Bad Request を返して早期リターンします。

if err := db.Create(&input).Error; err != nil {
    c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
    return
}
c.JSON(http.StatusCreated, input)

db.Create(&input) でDBに新規レコードを挿入します。GORMは自動採番された ID と CreatedAt を input に書き戻すため、c.JSON(http.StatusCreated, input) で id と created_at を含むJSONをそのまま返せます。ステータスコードは、リソース作成時の慣例的な 201 Created を返します。

2. ノート一覧の取得(Index)

続いて、ノートの一覧を取得する GET /notes を追加します。

ノート一覧を取得するハンドラを追加するため、handler.go の末尾に、以下の関数を追記します。

func listNotes(c *gin.Context) {
    var notes []Note
    if err := db.Order("id DESC").Find(&notes).Error; err != nil {
        c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
        return
    }
    c.JSON(http.StatusOK, notes)
}

続いて、GET /notes を listNotes に紐づけるため、main.go の r.POST("/notes", createNote) の下に、以下の1行を追加します。

    r.GET("/notes", listNotes)

既存のサーバが動いている場合は Ctrl+C で停止し、以下のコマンドで再起動します。

go run .

別のターミナルで、一覧を取得します。

curl http://localhost:8080/notes

以下のような実行結果が表示されます。3件のノートが id の降順(新しい順)で並んで返ります。

[{"id":3,"title":"読書メモ","body":"Go言語入門書","created_at":"2026-07-15T12:00:02+09:00"},{"id":2,"title":"会議メモ","body":"9時から進捗共有","created_at":"2026-07-15T12:00:01+09:00"},{"id":1,"title":"買い物","body":"卵とパン","created_at":"2026-07-15T12:00:00+09:00"}]

GET /notes で、先ほど作成した3件のノートが JSON 配列として返ってきました。ハンドラで Order("id DESC") を指定しているため、新しく作成された id = 3 が先頭に来ています。

コードを解説します。

var notes []Note
if err := db.Order("id DESC").Find(&notes).Error; err != nil {
    ...
}
c.JSON(http.StatusOK, notes)

db.Find(&notes) で notes テーブル全件を []Note に読み込みます。Order("id DESC") を挟むことで、新しく作成されたものから順に並びます。取得したスライスをそのまま c.JSON に渡すと、GORMが読み込んだ全レコードがJSON配列として返ります。

3. ノートの単一取得(Show)

続いて、指定IDのノートを1件だけ取得する GET /notes/:id を追加します。存在しないIDが指定された場合は 404 Not Found を返します。

3.1 実装

handler.go の import に "errors" と "gorm.io/gorm" を追加します。以降の節で gorm.ErrRecordNotFound を扱うためです。

import (
    "errors"
    "net/http"

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

続いて、指定IDのノートを取得するハンドラを追加するため、handler.go の末尾に、以下の関数を追記します。

func getNote(c *gin.Context) {
    var n Note
    if err := db.First(&n, c.Param("id")).Error; err != nil {
        if errors.Is(err, gorm.ErrRecordNotFound) {
            c.JSON(http.StatusNotFound, gin.H{"error": "ノートが見つかりません"})
            return
        }
        c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
        return
    }
    c.JSON(http.StatusOK, n)
}

続いて、GET /notes/:id を getNote に紐づけるため、main.go の r.GET("/notes", listNotes) の下に、以下の1行を追加します。

    r.GET("/notes/:id", getNote)

3.2 動作確認

既存のサーバが動いている場合は Ctrl+C で停止し、以下のコマンドで再起動します。

go run .

別のターミナルで、id = 1 のノートを取得します。

curl http://localhost:8080/notes/1

以下のような実行結果が表示されます。

{"id":1,"title":"買い物","body":"卵とパン","created_at":"2026-07-15T12:00:00+09:00"}

GET /notes/1 により、パスパラメータで指定した id = 1 のノートが単一のJSONオブジェクトとして返りました。Index では3件が配列 [...] として返っていたのに対して、Show では指定した1件だけがオブジェクト {...} として返る点が違いです。

続いて、存在しない id を指定した場合の挙動も確認します。ハンドラで gorm.ErrRecordNotFound を判定して 404 Not Found を返す処理が入っているためです。

curl -i http://localhost:8080/notes/999

以下のような実行結果が表示されます。

HTTP/1.1 404 Not Found
Content-Type: application/json; charset=utf-8
Date: XXX, XX XXX XXXX XX:XX:XX GMT
Content-Length: 45

{"error":"ノートが見つかりません"}

存在しない id = 999 を指定したところ、ステータス 404 Not Found と、ハンドラで返している {"error":"ノートが見つかりません"} の JSON が返りました。-i オプションを付けることで、ボディだけでなくステータス行やヘッダも合わせて確認できます。

3.3 コードの解説

var n Note
if err := db.First(&n, c.Param("id")).Error; err != nil {
    if errors.Is(err, gorm.ErrRecordNotFound) {
        c.JSON(http.StatusNotFound, gin.H{"error": "ノートが見つかりません"})
        return
    }
    ...
}

db.First(&n, c.Param("id")) は主キーの値でレコードを1件取得します。見つからない場合は gorm.ErrRecordNotFound が返るので、errors.Is でそのエラーかどうかを判定し、404 Not Found を返します。それ以外のエラー(DB接続失敗など)は 500 Internal Server Error で返します。

4. ノートの更新(Update)

続いて、指定IDのノートを更新する PUT /notes/:id を追加します。

4.1 実装

ノートを更新するハンドラを追加するため、handler.go の末尾に、以下の関数を追記します。

func updateNote(c *gin.Context) {
    var n Note
    if err := db.First(&n, c.Param("id")).Error; err != nil {
        if errors.Is(err, gorm.ErrRecordNotFound) {
            c.JSON(http.StatusNotFound, gin.H{"error": "ノートが見つかりません"})
            return
        }
        c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
        return
    }

    var input Note
    if err := c.ShouldBindJSON(&input); err != nil {
        c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
        return
    }
    n.Title = input.Title
    n.Body = input.Body

    if err := db.Save(&n).Error; err != nil {
        c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
        return
    }
    c.JSON(http.StatusOK, n)
}

続いて、PUT /notes/:id を updateNote に紐づけるため、main.go の r.GET("/notes/:id", getNote) の下に、以下の1行を追加します。

    r.PUT("/notes/:id", updateNote)

4.2 動作確認

既存のサーバが動いている場合は Ctrl+C で停止し、以下のコマンドで再起動します。

go run .

別のターミナルで、id = 1 のノートを更新します。

curl -X PUT http://localhost:8080/notes/1 -H "Content-Type: application/json" -d '{"title":"買い物","body":"卵、パン、牛乳"}'

以下のような実行結果が表示されます。

{"id":1,"title":"買い物","body":"卵、パン、牛乳","created_at":"2026-07-15T12:00:00+09:00"}

id = 1 のノートの body が更新され、更新後の内容がJSONで返りました。

更新が実際にDBに反映されていることを、Show(GET /notes/:id)で id = 1 のノートを取り出して確認します。

curl http://localhost:8080/notes/1

以下のような実行結果が表示されます。

{"id":1,"title":"買い物","body":"卵、パン、牛乳","created_at":"2026-07-15T12:00:00+09:00"}

body が 卵、パン、牛乳 に更新された状態で返ってきました。PUT で送った内容がDBに保存され、その後の GET でも同じ内容が読み取れることが確認できています。

続いて、存在しない id を指定した場合の挙動も確認します。ハンドラで gorm.ErrRecordNotFound を判定して 404 Not Found を返す処理が入っているためです。

curl -X PUT http://localhost:8080/notes/999 -H "Content-Type: application/json" -d '{"title":"任意","body":"任意"}' -i

以下のような実行結果が表示されます。

HTTP/1.1 404 Not Found
Content-Type: application/json; charset=utf-8
Date: XXX, XX XXX XXXX XX:XX:XX GMT
Content-Length: 45

{"error":"ノートが見つかりません"}

存在しない id = 999 を指定したところ、Show と同じく 404 Not Found と {"error":"ノートが見つかりません"} の JSON が返りました。

4.3 コードの解説

var n Note
if err := db.First(&n, c.Param("id")).Error; err != nil { ... }

var input Note
if err := c.ShouldBindJSON(&input); err != nil { ... }
n.Title = input.Title
n.Body = input.Body

if err := db.Save(&n).Error; err != nil { ... }

まず db.First で既存レコードを取り出し、次に c.ShouldBindJSON でリクエストボディを別の構造体に読み込みます。既存レコードのフィールドを書き換えてから db.Save(&n) を呼ぶことで、updated_at などの管理カラムも含めて安全に更新できます。

5. ノートの削除(Delete)

最後に、指定IDのノートを削除する DELETE /notes/:id を追加します。

ノートを削除するハンドラを追加するため、handler.go の末尾に、以下の関数を追記します。

func deleteNote(c *gin.Context) {
    if err := db.Delete(&Note{}, c.Param("id")).Error; err != nil {
        c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
        return
    }
    c.Status(http.StatusNoContent)
}

続いて、DELETE /notes/:id を deleteNote に紐づけるため、main.go の r.PUT("/notes/:id", updateNote) の下に、以下の1行を追加します。

    r.DELETE("/notes/:id", deleteNote)

既存のサーバが動いている場合は Ctrl+C で停止し、以下のコマンドで再起動します。

go run .

別のターミナルで、id = 1 のノートを削除します。

curl -X DELETE http://localhost:8080/notes/1 -i

以下のような実行結果が表示されます(204 No Content が返るのでボディはありません)。

HTTP/1.1 204 No Content
...

削除が成功したため、ステータス 204 No Content(ボディ無し)が返りました。-i オプションを付けているので、ステータス行とヘッダが表示されています。

コードを解説します。

if err := db.Delete(&Note{}, c.Param("id")).Error; err != nil { ... }
c.Status(http.StatusNoContent)

db.Delete(&Note{}, c.Param("id")) で、パスパラメータで受け取った id のレコードを削除します。成功時は c.Status(http.StatusNoContent) で 204 No Content を返し、レスポンスボディを持たないことを示します。

これで、5つのCRUDエンドポイントを持つノートアプリケーションのREST APIが完成しました。