CKTIS / Java
Semaphore — obmedzenie súbežného prístupu
java.util.concurrent.Semaphore obmedzuje prístup pomocou počítadla povolení. Naučte sa používať blokujúce acquire(), neblokujúce tryAcquire() a bezpečne vracať povolenia pomocou release().
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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: povolenia obmedzujú súbežný prístup, ale nie sú objektmi zdrojov. new Semaphore(n) v predvolenom nastavení nezaručuje spravodlivé poradie.
Semaphore.acquire() získa povolenie a v prípade potreby čaká; môže vyhodiť InterruptedException. Semaphore.tryAcquire() okamžite vráti true, ak povolenie získa, inak false. Variant s časovým limitom môže čakať a môže byť prerušený.
Semaphore.release() pridá povolenie. Pri obmedzovaní prístupu k zdrojom ju volajte v finally iba po úspešnom získaní povolenia; ďalšie uvoľnenie zvýši limit. Semafor nekontroluje, kto povolenie vlastní. Umiestnite acquire() pred try, aby prerušené čakanie nespôsobilo uvoľnenie.
new Semaphore(n, true) zaručuje poradie FIFO v interných bodoch zaraďovania do frontu, nie poradie začiatku volaní. tryAcquire() bez argumentov nečaká a môže získať dostupné povolenie pred vláknami, ktoré už čakajú vo fronte. Akcie pred release() sa dejú pred akciami po úspešnom získaní povolenia iným vláknom na tom istom semafore (happens-before). Samotný limit nechráni dátové štruktúry zdrojov pred súbehovými konfliktmi.
Prí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ýsledok
false acquired
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.