Lorsqu'il s'agit de tester des applications nécessitant un verrouillage distribué, Shed Lock est un outil puissant qui peut être efficacement intégré à une base de données H2. En tant que fournisseur de Shed Lock, j'ai été témoin des défis et des opportunités liés à la mise en œuvre et au test de tels mécanismes de verrouillage. Dans cet article de blog, je vais vous guider tout au long du processus d'utilisation de Shed Lock avec une base de données H2 à des fins de test.
Comprendre le verrouillage du hangar
Shed Lock est une bibliothèque qui fournit des verrous distribués pour les tâches planifiées dans les applications Java. Il garantit qu'une tâche particulière n'est exécutée qu'une seule fois sur plusieurs instances d'une application, évitant ainsi les conditions de concurrence et autres problèmes de concurrence. Ceci est crucial dans les systèmes distribués où plusieurs nœuds peuvent tenter d'exécuter la même tâche simultanément.
Le concept de base derrière Shed Lock est simple : il utilise une base de données pour stocker les informations de verrouillage. Lorsqu'une tâche est sur le point d'être exécutée, elle tente d'acquérir un verrou dans la base de données. Si le verrou est disponible, la tâche continue ; sinon, il attend ou ignore l'exécution. Ce mécanisme garantit qu'une seule instance de la tâche peut s'exécuter à la fois.


Pourquoi utiliser la base de données H2 pour les tests ?
La base de données H2 est une base de données en mémoire légère, rapide et facile à configurer. Il ne nécessite pas de processus serveur distinct, ce qui le rend idéal pour tester les environnements. Lors du test de Shed Lock, l'utilisation d'une base de données H2 vous permet de démarrer rapidement un environnement de test sans les frais généraux liés à la gestion d'un système de base de données à part entière.
Mise en place du projet
Pour commencer à utiliser Shed Lock avec une base de données H2, vous devez d'abord configurer un projet Java. Vous pouvez utiliser un outil de construction comme Maven ou Gradle. Voici un exemple de la façon d'ajouter les dépendances nécessaires à un projet Maven :
<dependencies> <dependency> <groupId>net.javacrumbs.shedlock</groupId> <artifactId>shedlock-spring</artifactId> <version>4.44.0</version> </dependency> <dependency> <groupId>net.javacrumbs.shedlock</groupId> <artifactId>shedlock-provider-jdbc-template</artifactId> <version>4.44.0</version> </dependency> <dependency> <groupId>com.h2database</groupId> <artifactId>h2</artifactId> <version>2.1.214</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-jdbc</artifactId> </dependency> </dependencies>
Configuration de la base de données H2
Une fois les dépendances ajoutées, vous devez configurer la base de données H2. Dans une application Spring Boot, vous pouvez le faire dans leapplication.propriétésouapplication.ymldéposer. Voici un exemple deapplication.propriétés:
spring.datasource.url=jdbc:h2:mem:testdb spring.datasource.driverClassName=org.h2.Driver spring.datasource.username=sa spring.datasource.password=mot de passe spring.h2.console.enabled=true
Ces propriétés configurent la base de données H2 pour qu'elle s'exécute en mode en mémoire. Lespring.h2.console.enabled=trueLa propriété active la console H2, ce qui peut être utile pour le débogage.
Configuration du verrouillage du hangar
Ensuite, vous devez configurer Shed Lock pour utiliser la base de données H2 comme fournisseur de verrous. Vous pouvez le faire en créant une classe de configuration :
importer net.javacrumbs.shedlock.core.LockProvider ; importer net.javacrumbs.shedlock.provider.jdbc.template.JdbcTemplateLockProvider ; importer net.javacrumbs.shedlock.spring.annotation.EnableSchedulerLock ; importer org.springframework.context.annotation.Bean ; importer org.springframework.context.annotation.Configuration ; importer org.springframework.jdbc.core.JdbcTemplate ; importer javax.sql.DataSource ; @Configuration @EnableSchedulerLock(defaultLockAtMostFor = "PT30S") public class ShedLockConfig { @Bean public LockProvider lockProvider(DataSource dataSource) { return new JdbcTemplateLockProvider( JdbcTemplateLockProvider.Configuration.builder() .withJdbcTemplate(new JdbcTemplate(dataSource)) .usingDbTime() .build() ); } }
Dans cette classe de configuration, nous définissons unFournisseur de verrouillagebean qui utilise leJdbcTemplateLockProvideravec la source de données H2. Le@EnableSchedulerLockL'annotation active la fonctionnalité Shed Lock dans l'application Spring.
Création d'une tâche planifiée
Créons maintenant une tâche planifiée simple qui utilise Shed Lock. Voici un exemple :
importer net.javacrumbs.shedlock.spring.annotation.SchedulerLock ; importer org.springframework.scheduling.annotation.Scheduled ; importer org.springframework.stereotype.Component ; @Component public class ScheduledTask { @Scheduled(fixedRate = 5000) @SchedulerLock(name = "scheduledTask", lockAtMostFor = "PT10S", lockAtLeastFor = "PT5S") public void runTask() { System.out.println("La tâche est en cours d'exécution..."); } }
Le@ProgramméL'annotation définit le calendrier de la tâche et le@SchedulerLockL'annotation garantit que la tâche n'est exécutée qu'une seule fois sur plusieurs instances. Lenomattribut du@SchedulerLockL'annotation est utilisée pour identifier le verrou, et lelockAtMostForetverrouillerAuMoinsPourLes attributs définissent la durée maximale et minimale pendant laquelle le verrou est maintenu.
Test de la configuration
Pour tester la configuration, vous pouvez exécuter l'application Spring Boot. Vous devriez voir la tâche s'exécuter à l'intervalle spécifié et le mécanisme de verrouillage doit garantir qu'elle ne s'exécute qu'une seule fois. Vous pouvez également utiliser la console H2 pour vérifier les entrées de verrouillage dans la base de données.
Scénarios de tests avancés
En plus des tests de base, vous souhaiterez peut-être tester des scénarios plus avancés, tels que l'expiration du verrouillage, l'accès simultané et la gestion des erreurs. Vous pouvez utiliser des frameworks de test comme JUnit et Mockito pour simuler ces scénarios.
Par exemple, vous pouvez écrire un test unitaire pour vérifier que le verrou est libéré après lelockAtMostFordurée:
importer net.javacrumbs.shedlock.core.LockConfiguration ; importer net.javacrumbs.shedlock.core.LockProvider ; importer net.javacrumbs.shedlock.core.SimpleLock ; importer org.junit.jupiter.api.Test ; importer org.springframework.beans.factory.annotation.Autowired ; importer org.springframework.boot.test.context.SpringBootTest ; importer java.time.Duration ; importer java.time.Instant ; importer statique org.junit.jupiter.api.Assertions.assertNotNull ; importer statique org.junit.jupiter.api.Assertions.assertNull ; @SpringBootTest public class LockExpirationTest { @Autowired private LockProvider lockProvider; @Test public void testLockExpiration() { LockConfiguration lockConfig = new LockConfiguration(Instant.now(), "testLock", Duration.ofSeconds(5)); Verrou SimpleLock = lockProvider.lock(lockConfig); assertNotNull(lock, "Le verrou doit être acquis"); essayez { Thread.sleep (6000); } catch (InterruptedException e) { e.printStackTrace(); } SimpleLock newLock = lockProvider.lock(lockConfig); assertNotNull(newLock, "Le verrouillage devrait être disponible après expiration"); } }
Conclusion
Utiliser Shed Lock avec une base de données H2 pour les tests est un moyen simple et efficace de garantir l'exactitude de vos mécanismes de verrouillage distribués. En suivant les étapes décrites dans cet article de blog, vous pouvez configurer rapidement un environnement de test et tester divers scénarios pour vous assurer que votre application fonctionne comme prévu.
Si vous souhaitez acheter des solutions Shed Lock ou si vous avez des questions sur l'intégration de Shed Lock à votre application, nous sommes là pour vous aider. Que vous ayez besoinSerrures de porte de hangarpour la sécurité physique ouVerrou quart de tourpour un contrôle d'accès spécifique, voireSerrure extérieurepour les applications externes, notre équipe d’experts peut vous apporter les meilleures solutions. Contactez-nous pour démarrer une discussion sur l’approvisionnement et trouver les produits adaptés à vos besoins.
Références
- Documentation officielle de ShedLock
- Documentation officielle de Spring Boot
- Documentation officielle de la base de données H2
