Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła