Comment construire une application crud avec Golang, Gin et PostgreSQL

Ce tutoriel vous montre comment créer une application CRUD (Create, Read, Update, Delete) simple à l'aide de Golang, du framework Gin et de PostgreSQL. Vous apprendrez à gérer les données stockées dans une base de données PostgreSQL.

Table des matières

1. Présentation
2. Prérequis
3. Structure du projet
4. Configuration du projet
5. Création de bases de données et de tables
6. Implémentation des gestionnaires CRUD
7. Tests API
8. Conclusion

1. Présentation

Ce guide utilise Gin, un framework Web léger Golang, pour créer des points de terminaison d'API. L'application interagit avec une base de données PostgreSQL via le pilote pgx. Une connaissance de base des API Golang et REST est supposée.

2. Prérequis

Avant de commencer, assurez-vous d'avoir :

• Golang (version 1.20 ou ultérieure)
• PostgreSQL (n'importe quelle version)
• Postman (ou un outil de test d'API similaire)
• Un éditeur de code (par exemple, VS Code)

3. Structure du projet

Organisez votre projet comme suit :

<code>crud-app/
├── main.go            
├── config/
│   └── database.go    
├── controllers/
│   └── item.go        
├── models/
│   └── item.go        
├── routes/
│   └── routes.go      
├── go.mod             
└── go.sum             </code>

4. Configuration du projet

1. Créez le répertoire du projet et initialisez un module Go :

   mkdir crud-app
   cd crud-app
   go mod init github.com/yourusername/crud-app  // Replace with your GitHub username

2. Installer les packages nécessaires :

   go get github.com/gin-gonic/gin
   go get github.com/jackc/pgx/v5

5. Création de base de données et de tables

1. Créez une base de données PostgreSQL (par exemple, crud_app).

2. Connectez-vous à la base de données et créez la table items :

   CREATE DATABASE crud_app;
   \c crud_app
   CREATE TABLE items (
       id SERIAL PRIMARY KEY,
       name TEXT NOT NULL,
       description TEXT,
       price NUMERIC(10, 2)
   );

6. Implémentation des gestionnaires CRUD

6.1 Connexion à la base de données (config/database.go) :

package config

import (
    "database/sql"
    "fmt"
    "log"

    _ "github.com/jackc/pgx/v5/stdlib"
)

var DB *sql.DB

func ConnectDatabase() {
    // ... (Connection string with your credentials) ...
}

6.2 Définition du modèle (models/item.go) :

package models

type Item struct {
    ID          int     `json:"id"`
    Name        string  `json:"name"`
    Description string  `json:"description"`
    Price       float64 `json:"price"`
}

6.3 Gestionnaires CRUD (controllers/item.go) : (Exemple : Créer)

package controllers

import (
    "crud-app/config"
    "crud-app/models"
    "github.com/gin-gonic/gin"
    "net/http"
)

func CreateItem(c *gin.Context) {
    // ... (Implementation for creating a new item) ...
}

Implémentez des fonctions similaires pour la lecture, la mise à jour et la suppression d'éléments.

6.4 Définitions d'itinéraires (routes/routes.go) :

package routes

import (
    "crud-app/controllers"
    "github.com/gin-gonic/gin"
)

func SetupRoutes(router *gin.Engine) {
    router.POST("/items", controllers.CreateItem)
    // ... (Add routes for other CRUD operations) ...
}

6.5 Application principale (main.go) :

package main

import (
    "crud-app/config"
    "crud-app/routes"
    "github.com/gin-gonic/gin"
)

func main() {
    config.ConnectDatabase()
    r := gin.Default()
    routes.SetupRoutes(r)
    r.Run(":8080")
}

7. Tests d'API

Exécutez l'application (go run main.go) et testez les points de terminaison à l'aide de Postman ou d'un outil similaire.

8. Conclusion

Vous avez créé avec succès une application CRUD de base. N'oubliez pas de renseigner les implémentations manquantes du gestionnaire CRUD et d'adapter la chaîne de connexion à la base de données à votre environnement. Cette base peut être étendue avec des fonctionnalités plus avancées.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!