CKTIS / Java
Semaphore — omezení souběžného přístupu
java.util.concurrent.Semaphore omezuje přístup pomocí počítadla povolení. Naučte se používat blokující acquire(), neblokující tryAcquire() a bezpečně vracet povolení pomocí release().
Verze: 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 je počítací semafor: povolení omezují souběžný přístup, ale nejsou objekty prostředků. new Semaphore(n) ve výchozím nastavení nezaručuje spravedlivé pořadí.
Semaphore.acquire() získá povolení a v případě potřeby čeká; může vyhodit InterruptedException. Semaphore.tryAcquire() okamžitě vrátí true, pokud povolení získá, jinak false. Varianta s časovým limitem může čekat a může být přerušena.
Semaphore.release() přidá povolení. Při omezování přístupu k prostředkům ji volejte v finally pouze po úspěšném získání povolení; další uvolnění zvýší limit. Semafor nekontroluje, kdo povolení vlastní. Umístěte acquire() před try, aby přerušené čekání nezpůsobilo uvolnění.
new Semaphore(n, true) zajišťuje pořadí FIFO v interních bodech zařazování do fronty, nikoli pořadí zahájení volání. tryAcquire() bez argumentů nečeká a může získat dostupné povolení před vlákny, která už čekají ve frontě. Akce před release() se dějí před akcemi po úspěšném získání povolení jiným vláknem na stejném semaforu (happens-before). Samotný limit nechrání datové struktury prostředků před souběhovými konflikty.
Příklady
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();
}
}
}
}Výsledek
false acquired
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.