de.bsvrz.sys.funclib.concurrent
Class Semaphore

java.lang.Object
  extended by de.bsvrz.sys.funclib.concurrent.Semaphore

public class Semaphore
extends Object

Diese Klasse implementiert ein Semaphor, das zur Synchronisation von Threads verwendet werden kann.

Author:
Kappich Systemberatung

Constructor Summary
Semaphore(int permits)
          Einen Semaphor erzeugen, der permit viele acquire Zugriffe zuläßt, bis er jeden weiteren Thread, der acquire aufruft, mit wait "schlafen" legt.
 
Method Summary
 void acquire()
          Eine Sperre des Semaphores anfordern, sind keine Sperren mehr zu vergeben, dann wird der Thread mit wait() angehalten.
 void release()
          Eine Sperre des Semaphores freigeben, dies befreit andere Threads, die auf eine Sperre warten.
 void setUpperBoundPermit(int upperBoundPermit)
          Diese Methode setzt die Anzahl der Sperren neu.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Semaphore

public Semaphore(int permits)
Einen Semaphor erzeugen, der permit viele acquire Zugriffe zuläßt, bis er jeden weiteren Thread, der acquire aufruft, mit wait "schlafen" legt.

Parameters:
permits - Wie viele Threads dürfen in den kritischen Abschnitt
Method Detail

acquire

public void acquire()
Eine Sperre des Semaphores anfordern, sind keine Sperren mehr zu vergeben, dann wird der Thread mit wait() angehalten. Ein anderer Thread, der seine Sperre wieder aufgibt, kann den wartenden Thread wieder befreien.


release

public void release()
Eine Sperre des Semaphores freigeben, dies befreit andere Threads, die auf eine Sperre warten.


setUpperBoundPermit

public void setUpperBoundPermit(int upperBoundPermit)
Diese Methode setzt die Anzahl der Sperren neu. Es ist somit zur Laufzeit möglich, dem Semaphor neue Sperren zu geben (entweder Sperren entziehen oder neue Sperren freischalten). Gibt es neue Sperren, dann werden sofort alle Threads, die warten, mit notifyAll darauf hingewiesen.

TBD Dies ist keine "normale" Funktion, die auf Semaphoren angewandt wird. Ist diese Methode hier in Ordnung ?

Parameters:
upperBoundPermit - Neue Obergrenze, soviele Sperren stehen nun zur Verfügung