Erstellen Sie Ihre erste REST-API mit Go

Erstellen Sie Ihre erste REST-API mit Go – legen wir los!

Sie haben also die Begeisterung für Go gehört, oder? Es ist schnell, einfach und heutzutage im Grunde der Rockstar der Backend-Entwicklung. Wenn Sie neu bei Go sind oder einfach nur etwas Cooles damit bauen möchten, sind Sie hier genau richtig. Diese Woche werden wir uns mit der Entwicklung Ihrer ganz eigenen REST-API mit Go befassen, also schnallen Sie sich an – es wird eine lustige Fahrt!

Warum gehen?

Warum schwärmen so viele Entwickler von Go? Nun, stellen Sie sich Folgendes vor: Google-Ingenieure, die es satt hatten, auf die Kompilierung ihrer Programme zu warten, beschlossen, etwas zu entwickeln, das sie nicht dazu bringen würde, sich die Haare auszureißen. Geben Sie Los ein – eine Sprache, die nicht nur die Arbeit erledigt, sondern sie auch schnell und mühelos erledigt.

Go ist für die heutige Hardware konzipiert und nutzt die Vorteile von Multi-Core-Systemen voll aus. Seine Geheimwaffe? Goroutinen – diese magischen kleinen gleichzeitigen Arbeiter, die unzählige Aufgaben gleichzeitig erledigen können, ohne ins Schwitzen zu geraten. Egal, ob Sie Web-Apps, APIs oder Microservices erstellen, Go sorgt dafür, dass alles reibungslos läuft, wie die gut geölte Maschine, von der Sie immer träumen.

Und hier ist der Clou: Go ist unglaublich einfach zu erlernen. Egal, ob Sie von Python, Java oder sogar etwas so „Klassischem“ wie PHP umsteigen, Sie werden in Go programmieren, bevor Sie „Hallo, Welt!“ sagen können. Und es läuft schnell – wirklich schnell. Muss ich noch mehr sagen?

Einrichten Ihres Go-Projekts

Okay, genug geplaudert, machen wir uns die Hände schmutzig. Zuerst müssen wir ein einfaches Go-Projekt einrichten. Keine Sorge, ich bin für Sie da:

1. Stellen Sie sicher, dass Go installiert ist. Wenn nicht, holen Sie es sich hier.

2. Jetzt erstellen wir ein Projektverzeichnis und initialisieren das Projekt:
   

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

1. Erstellen Sie in diesem Verzeichnis eine neue Datei mit dem Namen main.go und machen Sie sich bereit für etwas Programmiermagie.

Schreiben der API

Hier wird es spannend! Wir werden eine supereinfache API erstellen, um eine Liste von Büchern zu verwalten (denn wer liebt Bücher nicht?). Unsere API wird die folgenden Endpunkte haben:

• GET /books – Holt alle Bücher (Juhu, Bücher!)
• POST /books – Füge ein neues Buch hinzu
• GET /books/:id – Rufen Sie ein bestimmtes Buch anhand seiner ID ab (da nicht alle Bücher gleich sind)

Fertig? Tauchen wir ein in den Code:

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))
}

Aufschlüsseln

1. Mux-Router: Wir verwenden Gorilla/Mux, um das Routing in unserer API zu verwalten. Es erleichtert das Definieren von Routen und ist eine Anlaufstelle für die Erstellung von Webdiensten in Go. Sie können es installieren mit:

   go get -u github.com/gorilla/mux

1. Handler: Wir haben die Funktionen getBooks, getBook und createBook eingerichtet, um HTTP-Anfragen zu verarbeiten. Sie verwenden das Net/http-Paket von Go, um Antworten und Datenkodierung/-dekodierung zu verarbeiten. Kinderleicht!

2. JSON-Kodierung: Das integrierte JSON-Paket von Go übernimmt hier die schwere Arbeit und konvertiert unsere Daten in das JSON-Format für eine einfache Kommunikation zwischen dem Client und der API.

Ausführen der API

Jetzt kommt der spaßige Teil: Lassen Sie uns das Ding ausführen! Führen Sie in Ihrem Terminal einfach Folgendes aus:

go run main.go

Boom! Ihre API ist betriebsbereit. Sie können es jetzt mit Tools wie Postman oder Curl testen:

• Alle Bücher erhalten:

  curl http://localhost:8000/books

• Besorgen Sie sich ein bestimmtes Buch:

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

• Neues Buch hinzufügen:

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

Was kommt als nächstes?

Diese kleine API ist nur die Spitze des Eisbergs, wenn es darum geht, was Go in der Backend-Entwicklung leisten kann. Nächste Woche werden wir eine höhere Stufe erreichen, indem wir die Authentifizierung hinzufügen (ja, wir setzen auf vollständiges JWT) und diese Endpunkte vor unerwünschten Besuchern schützen.

Bleiben Sie dran für Teil 2 – Einrichten von Middleware für die Authentifizierung in einer REST-API mithilfe von JWT (JSON Web Tokens) in Go

Das obige ist der detaillierte Inhalt vonErstellen Sie Ihre erste REST-API mit Go. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!