CKTIS / Java
Semaphore — ograniczanie współbieżnego dostępu
java.util.concurrent.Semaphore ogranicza dostęp za pomocą licznika pozwoleń. Poznaj blokujące acquire(), nieblokujące tryAcquire() oraz bezpieczne zwracanie pozwoleń przez release().
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
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 to semafor zliczający: pozwolenia ograniczają współbieżny dostęp, ale nie są obiektami zasobów. new Semaphore(n) domyślnie nie zapewnia sprawiedliwości.
Semaphore.acquire() pobiera pozwolenie, czekając w razie potrzeby; może zgłosić InterruptedException. Semaphore.tryAcquire() natychmiast zwraca true po pobraniu albo false. Wariant z limitem czasu może czekać i zostać przerwany.
Semaphore.release() dodaje pozwolenie. Przy ograniczaniu zasobów wywołuj je w finally tylko po udanym pobraniu; dodatkowe zwolnienie zwiększa limit. Semafor nie sprawdza właściciela. Umieść acquire() przed try, aby przerwane oczekiwanie nie powodowało zwolnienia.
new Semaphore(n, true) zapewnia kolejność FIFO w wewnętrznych punktach kolejkowania, nie kolejność rozpoczęcia wywołań. Bezargumentowe tryAcquire() nie czeka i może pobrać dostępne pozwolenie z pominięciem kolejki. Działania przed release() zachodzą przed działaniami po udanym pobraniu w innym wątku na tym samym semaforze (happens-before). Sam limit nie chroni struktur zasobów przed wyścigami.
Przykłady
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();
}
}
}
}Wynik
false acquired
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.