Aller au contenu principal

Chapitre 4: Annotations Security, Test et Avancées

1. Annotations Spring Security​

@EnableWebSecurity​

Active la configuration de sécurité personnalisée.

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        return http
            .csrf(csrf -> csrf.disable())
            .authorizeHttpRequests(auth -> auth
                .requestMatchers("/api/auth/**").permitAll()
                .requestMatchers("/api/admin/**").hasRole("ADMIN")
                .anyRequest().authenticated()
            )
            .sessionManagement(session ->
                session.sessionCreationPolicy(SessionCreationPolicy.STATELESS)
            )
            .build();
    }
}

@EnableMethodSecurity​

Active la sécurité au niveau des méthodes.

@Configuration
@EnableMethodSecurity  // Active @PreAuthorize, @PostAuthorize, @Secured
public class MethodSecurityConfig {
}

@PreAuthorize​

Vérifie les autorisations avant l'exécution de la méthode.

@RestController
@RequestMapping("/api/admin")
public class AdminController {

    @GetMapping("/users")
    @PreAuthorize("hasRole('ADMIN')")
    public List<User> getAllUsers() { ... }

    @GetMapping("/stats")
    @PreAuthorize("hasAnyRole('ADMIN', 'MANAGER')")
    public Stats getStats() { ... }

    @DeleteMapping("/users/{id}")
    @PreAuthorize("hasRole('ADMIN') and #id != principal.id")
    public void deleteUser(@PathVariable Long id) { ... }

    @GetMapping("/users/{id}")
    @PreAuthorize("#id == principal.id or hasRole('ADMIN')")
    public User getUser(@PathVariable Long id) { ... }

    @PreAuthorize("isAuthenticated()")
    @GetMapping("/profile")
    public User getProfile() { ... }
}

@PostAuthorize​

Vérifie les autorisations après l'exécution.

@GetMapping("/{id}")
@PostAuthorize("returnObject.owner == authentication.name or hasRole('ADMIN')")
public Document getDocument(@PathVariable Long id) {
    return documentService.findById(id);
}

@Secured​

Spécifie les rôles requis (plus simple que @PreAuthorize).

@Secured("ROLE_ADMIN")
public void adminOnly() { ... }

@Secured({"ROLE_ADMIN", "ROLE_MANAGER"})
public void adminOrManager() { ... }

@RolesAllowed​

Standard JSR-250, similaire à @Secured.

@RolesAllowed("ADMIN")
public void adminOnly() { ... }

Résumé Security​

AnnotationUsage
@EnableWebSecurityActive la config Security
@EnableMethodSecurityActive la sécurité par méthode
@PreAuthorizeVérification AVANT exécution (SpEL)
@PostAuthorizeVérification APRÈS exécution
@SecuredRôles requis (simple)
@RolesAllowedRôles requis (JSR-250)

2. Annotations de Test​

@SpringBootTest​

Charge le contexte Spring complet pour les tests d'intégration.

@SpringBootTest
class UserServiceIntegrationTest {

    @Autowired
    private UserService userService;

    @Test
    void shouldCreateUser() {
        User user = userService.create(new UserDto("Jean", "jean@test.com"));
        assertThat(user.getId()).isNotNull();
    }
}

// Avec un serveur web aléatoire
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
class ApiIntegrationTest {

    @Autowired
    private TestRestTemplate restTemplate;

    @Test
    void shouldReturnProducts() {
        ResponseEntity<List> response = restTemplate.getForEntity("/api/products", List.class);
        assertThat(response.getStatusCode()).isEqualTo(HttpStatus.OK);
    }
}

@WebMvcTest​

Teste uniquement la couche contrôleur (pas de BDD, pas de services réels).

@WebMvcTest(ProductController.class)
class ProductControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private ProductService productService;

    @Test
    void shouldReturnProducts() throws Exception {
        when(productService.findAll()).thenReturn(List.of(new Product("Laptop", 999.99)));

        mockMvc.perform(get("/api/products"))
            .andExpect(status().isOk())
            .andExpect(jsonPath("$[0].name").value("Laptop"));
    }
}

@DataJpaTest​

Teste uniquement la couche de persistance JPA.

@DataJpaTest
class UserRepositoryTest {

    @Autowired
    private UserRepository userRepository;

    @Autowired
    private TestEntityManager entityManager;

    @Test
    void shouldFindByEmail() {
        entityManager.persistAndFlush(new User("Jean", "jean@test.com"));

        Optional<User> found = userRepository.findByEmail("jean@test.com");

        assertThat(found).isPresent();
        assertThat(found.get().getName()).isEqualTo("Jean");
    }
}

@MockBean​

Remplace un bean Spring par un mock Mockito.

@WebMvcTest(UserController.class)
class UserControllerTest {

    @MockBean
    private UserService userService;  // Mock au lieu du vrai service

    @Test
    void shouldReturnUser() {
        when(userService.findById(1L)).thenReturn(new User("Jean"));
        // ...
    }
}

@SpyBean​

Enveloppe un vrai bean avec un spy Mockito (appels réels sauf ceux stubés).

@SpringBootTest
class NotificationTest {

    @SpyBean
    private EmailService emailService;

    @Test
    void shouldSendEmail() {
        doNothing().when(emailService).sendEmail(anyString(), anyString());
        // Le reste des méthodes appelle le vrai code
    }
}

@TestConfiguration​

Fournit une configuration spécifique aux tests.

@TestConfiguration
public class TestSecurityConfig {

    @Bean
    public SecurityFilterChain testFilterChain(HttpSecurity http) throws Exception {
        return http.csrf(c -> c.disable())
            .authorizeHttpRequests(a -> a.anyRequest().permitAll())
            .build();
    }
}

@ActiveProfiles​

Active un profil Spring spécifique pour le test.

@SpringBootTest
@ActiveProfiles("test")
class ServiceTest {
    // Utilise application-test.yml
}

@Sql / @SqlGroup​

Exécute des scripts SQL avant/après un test.

@DataJpaTest
@Sql("/test-data.sql")
class ProductRepositoryTest {
    // test-data.sql est exécuté avant chaque test
}

@Sql(scripts = "/cleanup.sql", executionPhase = Sql.ExecutionPhase.AFTER_TEST_METHOD)

Résumé Test​

AnnotationPortéeUsage
@SpringBootTestContexte completTests d'intégration
@WebMvcTestCouche Web seuleTests de contrôleurs
@DataJpaTestCouche JPA seuleTests de repositories
@MockBeanBean mockéRemplacer un bean
@SpyBeanBean espionnéWrapper un vrai bean
@ActiveProfilesProfilChoisir la config test
@SqlBDDCharger des données SQL

3. Annotations Asynchrone et Planification​

@EnableAsync / @Async​

Exécute une méthode de manière asynchrone (dans un thread séparé).

@Configuration
@EnableAsync
public class AsyncConfig {
}

@Service
public class EmailService {

    @Async
    public CompletableFuture<String> sendEmailAsync(String to, String body) {
        // Exécuté dans un thread séparé
        // ... envoi email
        return CompletableFuture.completedFuture("Email envoyé à " + to);
    }
}

@EnableScheduling / @Scheduled​

Planifie l'exécution périodique d'une méthode.

@Configuration
@EnableScheduling
public class SchedulingConfig {
}

@Service
public class CleanupService {

    @Scheduled(fixedRate = 60000)  // Toutes les 60 secondes
    public void cleanupExpiredTokens() {
        tokenRepository.deleteExpired();
    }

    @Scheduled(fixedDelay = 30000)  // 30 secondes après la fin de l'exécution précédente
    public void processQueue() {
        queueService.processNext();
    }

    @Scheduled(cron = "0 0 2 * * ?")  // Tous les jours à 2h du matin
    public void dailyReport() {
        reportService.generateDailyReport();
    }

    @Scheduled(cron = "0 0 * * * MON-FRI")  // Chaque heure, lundi au vendredi
    public void hourlySync() {
        syncService.sync();
    }
}

Syntaxe Cron​

┌───────── seconde (0-59)
│ ┌─────── minute (0-59)
│ │ ┌───── heure (0-23)
│ │ │ ┌─── jour du mois (1-31)
│ │ │ │ ┌─ mois (1-12)
│ │ │ │ │ ┌ jour de la semaine (0-7, MON-SUN)
│ │ │ │ │ │
* * * * * *
ExpressionDescription
0 0 * * * *Chaque heure
0 0 2 * * *Tous les jours à 2h
0 0 9-17 * * MON-FRIChaque heure de 9h à 17h en semaine
0 */15 * * * *Toutes les 15 minutes
0 0 0 1 * *Le premier de chaque mois à minuit

4. Annotations de Cache​

@EnableCaching / @Cacheable / @CacheEvict / @CachePut​

@Configuration
@EnableCaching
public class CacheConfig {
}

@Service
public class ProductService {

    @Cacheable(value = "products", key = "#id")
    public Product findById(Long id) {
        // Résultat mis en cache ; les appels suivants ne touchent pas la BDD
        return productRepository.findById(id).orElseThrow();
    }

    @Cacheable(value = "productList", unless = "#result.size() == 0")
    public List<Product> findAll() {
        return productRepository.findAll();
    }

    @CachePut(value = "products", key = "#product.id")
    public Product update(Product product) {
        // Met à jour le cache avec le nouveau résultat
        return productRepository.save(product);
    }

    @CacheEvict(value = "products", key = "#id")
    public void delete(Long id) {
        // Supprime l'entrée du cache
        productRepository.deleteById(id);
    }

    @CacheEvict(value = "products", allEntries = true)
    public void clearCache() {
        // Vide tout le cache "products"
    }
}

5. Annotations AOP (Programmation Orientée Aspect)​

@Aspect / @Before / @After / @Around​

@Aspect
@Component
public class LoggingAspect {

    @Before("execution(* com.example.service.*.*(..))")
    public void logBefore(JoinPoint joinPoint) {
        log.info("Appel: {}", joinPoint.getSignature().getName());
    }

    @After("execution(* com.example.service.*.*(..))")
    public void logAfter(JoinPoint joinPoint) {
        log.info("Fin: {}", joinPoint.getSignature().getName());
    }

    @Around("@annotation(com.example.annotation.Timed)")
    public Object measureTime(ProceedingJoinPoint joinPoint) throws Throwable {
        long start = System.currentTimeMillis();
        Object result = joinPoint.proceed();
        long duration = System.currentTimeMillis() - start;
        log.info("{} exécuté en {} ms", joinPoint.getSignature().getName(), duration);
        return result;
    }
}

6. Annotations Spring Boot Auto-Configuration​

@EnableAutoConfiguration​

Inclus dans @SpringBootApplication. Active la configuration automatique basée sur les dépendances.

@EnableAutoConfiguration(exclude = {DataSourceAutoConfiguration.class})
// Désactive l'auto-configuration de la DataSource

@ConditionalOn...​

Famille d'annotations pour la configuration conditionnelle.

AnnotationCondition
@ConditionalOnPropertyPropriété a une certaine valeur
@ConditionalOnClassClasse présente dans le classpath
@ConditionalOnMissingClassClasse absente du classpath
@ConditionalOnBeanBean existe dans le contexte
@ConditionalOnMissingBeanBean n'existe pas dans le contexte
@ConditionalOnExpressionExpression SpEL est vraie
@ConditionalOnWebApplicationL'app est une app web
@ConditionalOnNotWebApplicationL'app n'est pas une app web

7. Annotations de Messaging et Events​

@EventListener​

Écoute les événements Spring.

@Component
public class UserEventListener {

    @EventListener
    public void handleUserCreated(UserCreatedEvent event) {
        log.info("Nouvel utilisateur: {}", event.getUser().getEmail());
        emailService.sendWelcomeEmail(event.getUser());
    }

    @Async
    @EventListener
    public void handleUserCreatedAsync(UserCreatedEvent event) {
        // Traité de manière asynchrone
    }
}

@TransactionalEventListener​

Écoute les événements liés à la transaction.

@TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT)
public void handleAfterCommit(OrderCreatedEvent event) {
    // Exécuté seulement si la transaction a réussi
    notificationService.notifyNewOrder(event.getOrder());
}

8. Annotations REST Client​

@FeignClient (Spring Cloud)​

Déclare un client REST déclaratif.

@FeignClient(name = "user-service", url = "http://localhost:8081")
public interface UserClient {

    @GetMapping("/api/users/{id}")
    UserDto getUser(@PathVariable Long id);

    @PostMapping("/api/users")
    UserDto createUser(@RequestBody CreateUserDto dto);
}

Tableau Récapitulatif Global​

Les 50+ annotations les plus utilisées​

#AnnotationCatégorieRôle
1@SpringBootApplicationBootPoint d'entrée
2@ComponentCoreBean générique
3@ServiceCoreLogique métier
4@RepositoryCoreAccès BDD
5@ControllerWebContrôleur MVC
6@RestControllerWebContrôleur REST
7@ConfigurationCoreClasse de config
8@BeanCoreDéclaration de bean
9@AutowiredCoreInjection
10@QualifierCoreChoix du bean
11@ValueCoreInjection de valeur
12@ProfileCoreActivation par profil
13@ScopeCorePortée du bean
14@LazyCoreInitialisation différée
15@PostConstructCoreInit après injection
16@PreDestroyCoreCleanup avant destruction
17@RequestMappingWebMapping URL
18@GetMappingWebHTTP GET
19@PostMappingWebHTTP POST
20@PutMappingWebHTTP PUT
21@DeleteMappingWebHTTP DELETE
22@PatchMappingWebHTTP PATCH
23@PathVariableWebParamètre URL
24@RequestParamWebParamètre query
25@RequestBodyWebCorps JSON
26@RequestHeaderWebEn-tête HTTP
27@ResponseStatusWebCode HTTP réponse
28@ExceptionHandlerWebGestion d'exception
29@RestControllerAdviceWebGestion globale erreurs
30@CrossOriginWebCORS
31@ValidValidationActive la validation
32@NotNullValidationPas null
33@NotBlankValidationPas vide
34@SizeValidationTaille min/max
35@EmailValidationFormat email
36@EntityJPAEntité = table
37@TableJPAConfig table
38@IdJPAClé primaire
39@GeneratedValueJPAAuto-génération ID
40@ColumnJPAConfig colonne
41@OneToManyJPARelation 1:N
42@ManyToOneJPARelation N:1
43@ManyToManyJPARelation N:N
44@QueryJPARequête custom
45@TransactionalJPATransaction
46@EnableWebSecuritySecurityConfig sécurité
47@PreAuthorizeSecurityAutorisation pré-exécution
48@SpringBootTestTestTest d'intégration
49@WebMvcTestTestTest contrôleur
50@DataJpaTestTestTest repository
51@MockBeanTestMock de bean
52@AsyncAvancéExécution asynchrone
53@ScheduledAvancéTâche planifiée
54@CacheableAvancéMise en cache
55@EventListenerAvancéÉcoute d'événements

⬅️ Retour au Module 17 | ⬅️ Retour à l'accueil