Go로 첫 번째 REST API 구축하기

Go로 첫 번째 REST API 구축 – 시작해 보세요!

그럼 바둑(Go)에 대한 소문을 들어보셨죠? 빠르고 간단하며 기본적으로 요즘 백엔드 개발의 핵심입니다. Go를 처음 사용하거나 Go를 사용하여 뭔가 멋진 것을 만들고 싶다면 잘 찾아오셨습니다. 이번 주에는 Go를 사용하여 나만의 REST API를 구축하는 방법에 대해 알아볼 예정입니다. 버클을 채우세요. 정말 재미있을 것입니다!

왜 가야합니까?

이제 왜 그렇게 많은 개발자들이 Go에 매료되고 있는 걸까요? 자, 이것을 상상해 보십시오: 프로그램이 컴파일되기를 기다리는 데 지친 Google 엔지니어들은 머리를 찢고 싶지 않은 무언가를 만들기로 결정했습니다. Go를 입력하세요. 단지 작업을 완료하는 것이 아니라 빠르고 쉽게 작업을 수행하는 언어입니다.

Go는 멀티 코어 시스템을 최대한 활용하여 오늘날의 하드웨어에 맞게 제작되었습니다. 그 비밀 무기? 고루틴 — 땀을 흘리지 않고도 수많은 작업을 동시에 처리할 수 있는 마법 같은 작은 동시 작업자입니다. 웹 앱, 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 라우터: 우리는 API에서 라우팅을 처리하기 위해 gorilla/mux를 사용하고 있습니다. 경로를 쉽게 정의할 수 있으며 Go에서 웹 서비스를 구축하는 데 적합합니다. 다음을 사용하여 설치할 수 있습니다.

   go get -u github.com/gorilla/mux

1. 처리기: HTTP 요청을 처리하기 위해 getBooks, getBook 및 createBook 함수를 설정했습니다. Go의 net/http 패키지를 사용하여 응답과 데이터 인코딩/디코딩을 처리합니다. 쉽죠!

2. JSON 인코딩: Go에 내장된 json 패키지는 여기서 무거운 작업을 수행하여 클라이언트와 API 간의 쉬운 통신을 위해 데이터를 JSON 형식으로 변환합니다.

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 웹 토큰)를 사용하여 REST API에서 인증을 위한 미들웨어 설정을 기대하세요

위 내용은 Go로 첫 번째 REST API 구축하기의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!