https://github.com/tonylapoche/api-library-spring
API Rest développé avec Spring Boot | Objectif: crée des tables avec des liaisons entre les entités "Auteurs, Genres et Livres".
https://github.com/tonylapoche/api-library-spring
api-rest crud-api h2-database java mapstruct maven spring-boot
Last synced: 12 months ago
JSON representation
API Rest développé avec Spring Boot | Objectif: crée des tables avec des liaisons entre les entités "Auteurs, Genres et Livres".
- Host: GitHub
- URL: https://github.com/tonylapoche/api-library-spring
- Owner: TonyLaPoche
- License: mit
- Created: 2024-11-01T10:37:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-04T16:06:23.000Z (over 1 year ago)
- Last Synced: 2025-02-13T05:30:21.547Z (about 1 year ago)
- Topics: api-rest, crud-api, h2-database, java, mapstruct, maven, spring-boot
- Language: Java
- Homepage:
- Size: 26.4 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Library API
Ce projet est une API REST de gestion de bibliothèques pour des livres de type RPG. Elle permet d’effectuer des opérations CRUD pour les livres, auteurs et genres, le tout en utilisant **Spring Boot**. Ce projet est un terrain d’entraînement pour explorer et maîtriser les concepts de développement d’API en Java avec Spring Boot.
## Statut du Projet
**En cours de développement** 🚧
Ce projet est activement en cours de construction et n’est pas encore finalisé. Il s’agit d’un environnement de pratique et de formation pour expérimenter divers aspects de Spring Boot.
## Fonctionnalités
L’API inclut les fonctionnalités suivantes (à différentes étapes de développement) :
- Gestion des **livres** (CRUD complet)
- Gestion des **auteurs** et des genres associés
- Validation des données via des DTO
- Gestion des exceptions personnalisées
- Mapping d’entités à DTO pour la sérialisation JSON
- Documentation API avec Swagger (prévu)
## Technologies Utilisées
- **Java 17** – Langage principal
- **Spring Boot** – Framework d’application
- **Spring Data JPA** – Gestion des données et ORM
- **Hibernate** – ORM pour la gestion de la persistance
- **H2 Database** – Base de données en mémoire pour le développement et les tests
- **MapStruct** – Mapper pour la conversion entités <-> DTO
- **Lombok** – Réduction du code boilerplate
- **Maven** – Gestion des dépendances et du cycle de vie du projet
## Installation et Lancement
1. Cloner le dépôt :
```bash
git clone https://github.com/ton-username/rpg-library-api.git
cd rpg-library-api
```
2. Installer les dépendances avec Maven :
```bash
mvn clean install
```
3. Lancer l’application :
```bash
mvn spring-boot:run
```
4. L’API sera accessible par défaut sur `http://localhost:8080`.
## Endpoints API
Quelques endpoints principaux (cette liste est non exhaustive) :
| Méthode HTTP | Endpoint | Description |
|--------------|---------------------|---------------------------------|
| GET | `/api/books` | Liste de tous les livres |
| POST | `/api/books` | Ajouter un nouveau livre |
| PUT | `/api/books/{id}` | Mettre à jour un livre existant |
| DELETE | `/api/books/{id}` | Supprimer un livre |
| GET | `/api/authors` | Liste de tous les auteurs |
| GET | `/api/kinds` | Liste de tous les genres |
## Note
Ce projet étant en développement, certaines fonctionnalités sont sujettes à des modifications ou des ajouts. N’hésitez pas à me faire part de vos retours ou suggestions pour améliorer le projet !
## Auteur
Créé par [TonyLaPoche](https://github.com/TonyLaPoche).