使用 Go 建立您的第一個 REST API

使用 Go 建立您的第一個 REST API – 讓我們開始吧！

那麼，您已經聽說過有關 Go 的熱議，對吧？它快速、簡單，基本上是當今後端開發的搖滾明星。如果您是 Go 新手或只是想用它來建造一些很酷的東西，那麼您來對地方了。本週，我們將深入研究如何使用 Go 建立您自己的 REST API，所以請係好安全帶——這將是一次有趣的旅程！

為什麼要去？

現在，到底為什麼這麼多開發者對 Go 著迷呢？好吧，想像一下：谷歌工程師厭倦了等待他們的程式編譯，決定創建一些不會讓他們想要抓狂的東西。輸入 Go——一種不僅可以完成工作，而且可以快速、輕鬆地完成工作的語言。

Go 是為當今的硬體而建構的，充分利用了多核心系統。它的秘密武器？ Goroutines——這些神奇的小型並發工作者，可以毫不費力地同時處理大量任務。無論您是在建立 Web 應用程式、API 還是微服務，Go 都能讓一切順利運行，就像您一直夢想的運作良好的機器一樣。

最重要的是：Go 非常容易學。無論您是從 Python、Java 還是像 PHP 這樣「經典」的東西切換過來，在說「Hello，World！」之前，您都將開始使用 Go 進行程式設計。而且它運行快——非常快。還需要我多說嗎？

設定您的 Go 項目

好了，閒聊夠了，讓我們動手吧。首先，我們需要建立一個簡單的 Go 專案。別擔心，我已經幫你解決了：

1. 確保已安裝 Go。如果沒有，請在這裡獲取。

2. 現在，讓我們建立一個專案目錄並初始化專案：
   

   mkdir go-rest-api
   cd go-rest-api
   go mod init github.com/yourusername/go-rest-api

1. 在此目錄中，建立一個名為 main.go 的新文件，並準備好進行一些編碼魔法。

編寫API

這就是事情變得令人興奮的地方！我們將建立一個超級簡單的 API 來管理書籍清單（因為誰不喜歡書籍？）。我們的 API 將具有以下端點：

• GET /books – 取得所有書籍（耶，書籍！）
• POST /books – 新增新書
• GET /books/:id – 透過 ID 取得特定書籍（因為並非所有書籍都是一樣的）

準備好了嗎？讓我們深入研究程式碼：

package main

import (
    "encoding/json"
    "fmt"
    "log"
    "net/http"
    "strconv"

    "github.com/gorilla/mux"
)

type Book struct {
    ID     int    `json:"id"`
    Title  string `json:"title"`
    Author string `json:"author"`
}

var books []Book

// Get all books
func getBooks(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(books)
}

// Get a single book by ID
func getBook(w http.ResponseWriter, r *http.Request) {
    params := mux.Vars(r)
    id, err := strconv.Atoi(params["id"])
    if err != nil {
        http.Error(w, "Invalid book ID", http.StatusBadRequest)
        return
    }
    for _, book := range books {
        if book.ID == id {
            w.Header().Set("Content-Type", "application/json")
            json.NewEncoder(w).Encode(book)
            return
        }
    }
    http.Error(w, "Book not found", http.StatusNotFound)
}

// Add a new book
func createBook(w http.ResponseWriter, r *http.Request) {
    var book Book
    _ = json.NewDecoder(r.Body).Decode(&book)
    book.ID = len(books) + 1 // Assign an ID (we’re just winging it here)
    books = append(books, book)
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(book)
}

func main() {
    // Add some dummy data to start with
    books = append(books, Book{ID: 1, Title: "The Go Programming Language", Author: "Alan A. A. Donovan"})
    books = append(books, Book{ID: 2, Title: "Learning Go", Author: "Jon Bodner"})

    // Initialize the router
    r := mux.NewRouter()

    // Define the endpoints
    r.HandleFunc("/books", getBooks).Methods("GET")
    r.HandleFunc("/books/{id}", getBook).Methods("GET")
    r.HandleFunc("/books", createBook).Methods("POST")

    // Start the server
    fmt.Println("Server is running on port 8000...")
    log.Fatal(http.ListenAndServe(":8000", r))
}

分解它

1. Mux Router：我們使用 gorilla/mux 來處理 API 中的路由。它可以輕鬆定義路由，並且是在 Go 中建立 Web 服務的首選。您可以使用以下命令安裝它：

   go get -u github.com/gorilla/mux

1. 處理程序：我們設定了 getBooks、getBook 和 createBook 函數來處理 HTTP 請求。他們使用 Go 的 net/http 套件來處理回應和資料編碼/解碼。簡單！

2. JSON 編碼：Go 內建的 json 套件在這裡完成繁重的工作，將我們的資料轉換為 JSON 格式，以便客戶端和 API 之間輕鬆通訊。

運行 API

現在到了有趣的部分——讓我們運行這個東西！在您的終端機中，只需執行：

go run main.go

繁榮！您的 API 已啟動並正在執行。現在您可以使用Postman或curl等工具來測試它：

• 取得所有書籍：

  curl http://localhost:8000/books

• 取得一本特定的書：

  curl http://localhost:8000/books/1

• 新增新書：

  curl -X POST http://localhost:8000/books -d '{"title":"New Book","author":"New Author"}' -H "Content-Type: application/json"

接下來是什麼？

這個小 API 只是 Go 在後端開發的冰山一角。下週，我們將透過添加身份驗證（是的，我們將採用完整的 JWT）並保護這些端點免受不必要的訪客的侵害來進行升級。

敬請關注第 2 部分－在 Go 中使用 JWT（JSON Web 令牌）在 REST API 中設定用於驗證的中間件

以上是使用 Go 建立您的第一個 REST API的詳細內容。更多資訊請關注PHP中文網其他相關文章！