はじめに
こんにちは、Webエンジニアの岩田史門(@SI_Monxy)です！
今回はずっと気になっていたGo言語に入門してみたのでREST APIの実装について記事を書いてみました！
改善点や修正点があれば、コメントにて優しくご指導いただけると嬉しいです！
概要
この記事では、Goを使って基本的なCRUD操作を行うREST APIを構築する方法を説明します。この記事を読み終えると、Go言語で簡単なREST APIを作成し、CRUD（Create、Read、Update、Delete）操作を実装する方法が理解できます。
プロジェクトのセットアップ
まず、プロジェクトディレクトリを作成し、go modを初期化します。
mkdir go-rest-api
cd go-rest-api
go mod init go-rest-api
次に、必要なパッケージをインストールします。ここでは、HTTPルーティングにgorilla/muxを使用します。
go get -u github.com/gorilla/mux
メインアプリケーションファイルの作成
main.goファイルを作成し、基本的なセットアップを行います。
package main
import (
"log"
"net/http"
"github.com/gorilla/mux"
)
func main() {
router := mux.NewRouter()
// ルートを設定
router.HandleFunc("/api/items", getItems).Methods("GET")
router.HandleFunc("/api/items/{id}", getItem).Methods("GET")
router.HandleFunc("/api/items", createItem).Methods("POST")
router.HandleFunc("/api/items/{id}", updateItem).Methods("PUT")
router.HandleFunc("/api/items/{id}", deleteItem).Methods("DELETE")
log.Fatal(http.ListenAndServe(":8000", router))
}
モデルの作成
データを表すモデルを作成します。ここでは簡単なアイテムモデルを作成します。
package main
type Item struct {
ID string `json:"id"`
Name string `json:"name"`
Price int `json:"price"`
}
ハンドラ関数の実装
CRUD操作を行うためのハンドラ関数を実装します。ここではメモリ内のデータ構造を使用しますが、実際にはデータベースを使用することが一般的です。
package main
import (
"encoding/json"
"net/http"
"github.com/gorilla/mux"
)
var items []Item
func getItems(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(items)
}
func getItem(w http.ResponseWriter, r *http.Request) {
params := mux.Vars(r)
for _, item := range items {
if item.ID == params["id"] {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(item)
return
}
}
http.NotFound(w, r)
}
func createItem(w http.ResponseWriter, r *http.Request) {
var item Item
_ = json.NewDecoder(r.Body).Decode(&item)
item.ID = "1" // ここでは簡単のためIDを固定していますが、実際にはユニークなIDを生成する必要があります
items = append(items, item)
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(item)
}
func updateItem(w http.ResponseWriter, r *http.Request) {
params := mux.Vars(r)
for index, item := range items {
if item.ID == params["id"] {
items = append(items[:index], items[index+1:]...)
var newItem Item
_ = json.NewDecoder(r.Body).Decode(&newItem)
newItem.ID = params["id"]
items = append(items, newItem)
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(newItem)
return
}
}
http.NotFound(w, r)
}
func deleteItem(w http.ResponseWriter, r *http.Request) {
params := mux.Vars(r)
for index, item := range items {
if item.ID == params["id"] {
items = append(items[:index], items[index+1:]...)
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(item)
return
}
}
http.NotFound(w, r)
}
サーバの起動と動作確認
すべてのファイルを保存した後、サーバを起動します。
go run main.go
ブラウザやPostmanなどのツールを使って、APIエンドポイントにアクセスし、正しく動作するか確認します。
- GET /api/items - すべてのアイテムを取得
- GET /api/items/{id} - 指定したIDのアイテムを取得
- POST /api/items - 新しいアイテムを作成
- PUT /api/items/{id} - 指定したIDのアイテムを更新
- DELETE /api/items/{id} - 指定したIDのアイテムを削除
まとめ
この記事では、Goを使って基本的なCRUD操作を行うREST APIを構築する方法を紹介しました。