CKTIS / Java
Semaphore — limiter l’accès concurrent
java.util.concurrent.Semaphore limite l’accès à l’aide d’un compteur de permis. Découvrez acquire(), qui bloque, tryAcquire(), qui ne bloque pas, et le retour sûr des permis avec release().
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
Semaphore s = new Semaphore(permits, fair);
s.acquire(); // throws InterruptedException
try {
// Use the permit.
} finally {
s.release();
}
boolean acquired = s.tryAcquire();
if (acquired) {
try {
// Use the permit.
} finally {
s.release();
}
}
boolean acquiredInTime = s.tryAcquire(timeout, unit); // throws InterruptedException
if (acquiredInTime) {
try {
// Use the permit.
} finally {
s.release();
}
}Semaphore est un sémaphore à compteur : les permis limitent l’accès concurrent, mais ne sont pas des objets représentant des ressources. new Semaphore(n) n’est pas équitable par défaut.
Semaphore.acquire() prend un permis et attend si nécessaire ; la méthode peut lever InterruptedException. Semaphore.tryAcquire() renvoie immédiatement true si un permis est acquis, ou false dans le cas contraire. La variante avec délai peut attendre et être interrompue.
Semaphore.release() ajoute un permis. Pour limiter l’accès à des ressources, appelez cette méthode dans finally uniquement après une acquisition réussie ; une libération supplémentaire augmente la limite. Un sémaphore ne vérifie pas qui détient le permis. Placez acquire() avant try afin qu’une attente interrompue ne provoque pas de libération.
new Semaphore(n, true) garantit l’ordre FIFO aux points de mise en file internes, mais pas l’ordre de début des appels. Sans argument, tryAcquire() n’attend pas et peut prendre un permis disponible avant les threads déjà en file d’attente. Les actions précédant release() se produisent avant celles qui suivent une acquisition réussie par un autre thread sur le même sémaphore (happens-before). La limite seule ne protège pas les structures de données des ressources contre les accès concurrents problématiques.
Exemples
import java.util.concurrent.Semaphore;
public class Main {
public static void main(String[] args) throws InterruptedException {
Semaphore slots = new Semaphore(1);
slots.acquire();
try {
System.out.println(slots.tryAcquire());
} finally {
slots.release();
}
if (slots.tryAcquire()) {
try {
System.out.println("acquired");
} finally {
slots.release();
}
}
}
}Résultat
false acquired
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.