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(¬es).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(¬es).Error; err != nil {
...
}
c.JSON(http.StatusOK, notes)
db.Find(¬es) で 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が完成しました。