Spring Boot

Aperçu

Spring Boot est un framework Java qui facilite la création d'applications autonomes de qualité production. Il fournit la configuration automatique, des serveurs embarqués et une approche structurée pour créer des API REST et des applications web.

Démarrage rapide

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>

spring.datasource.url=jdbc:mysql://db.<session-domain>:3306/<username>
spring.datasource.username=<username>
spring.datasource.password=<password>

./mvnw spring-boot:run

git add .
git commit -m "Initial setup"
git push origin main

Développement local avec Docker

Si vous n'avez pas Java installé localement, vous pouvez utiliser Docker pour construire et exécuter votre application Spring Boot.

Exécuter des commandes avec Docker

# Construire le projet
docker run --rm -v $(pwd):/app -w /app maven:3-eclipse-temurin-21 ./mvnw clean package -DskipTests

# Exécuter l'application
docker run --rm -v $(pwd):/app -w /app -p 8080:8080 eclipse-temurin:21 java -jar target/*.jar

Configuration de la base de données

La plateforme NStrim met à votre disposition une base de données MySQL/MariaDB. Configurez votre fichier application.properties avec les bons identifiants.

Configuration complète

spring.datasource.url=jdbc:mysql://db.<session-domain>:3306/<username>
spring.datasource.username=<username>
spring.datasource.password=<password>
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

Structure du projet

├── src/
│   └── main/
│       ├── java/com/example/
│       │   ├── Application.java          # Point d'entrée Spring Boot
│       │   ├── controllers/              # Contrôleurs REST
│       │   ├── models/                   # Entités JPA
│       │   ├── repositories/             # Repositories Spring Data
│       │   └── services/                 # Logique métier
│       └── resources/
│           ├── application.properties    # Configuration
│           ├── templates/                # Templates Thymeleaf
│           └── static/                   # CSS, JS, images
├── pom.xml                               # Dépendances Maven
└── Dockerfile                            # Config Docker
        

Tâches courantes

Créer un contrôleur REST

@RestController
@RequestMapping("/api/users")
public class UserController {

    @GetMapping
    public List<User> getAll() {
        return userRepository.findAll();
    }

    @PostMapping
    public User create(@RequestBody User user) {
        return userRepository.save(user);
    }
}

Créer une entité JPA

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    private String email;

    // getters et setters
}

Créer un repository

public interface UserRepository extends JpaRepository<User, Long> {
    Optional<User> findByEmail(String email);
}

Commandes utiles

Dépannage

Flux de déploiement