diub-Dokumentation

Inhalt

Titel


4 diub.Class

4.1 diub.Database

4.1.1 RecordBase

Eine Id-Klasse basierend auf einem String.

Der parameterlos Konstruktor nutzt HUIDGenerator zur Generierung der nächsten Id.

4.1.2 LUIDRecordBase - 64-Bit-UID mit wählbarem Generator

64-Bit-Id Klassen mit wählbarem Generator als Basis für Datensätze (Records).

4.2 diub.Universal

4.2.1 GetSystemID

Liefert eine UID, die auf Basis des Zeitpunktes des ersten Aufrufs berechnet und dann in der Registry gespeichert wird.

namespace diub.Universal; static private ushort GetSystemId ();

4.3 diub.Threads

4.3.1 Pipeline (obsolet)

Hinweis

Einfache Pools und auch Verarbeitungsketten lassen sich mit folgenden Klassen flexibler abbilden:

Klasse zur Bildung von Multi-Threaded-Verarbeitungs-Ketten.

  • Die Verarbeitungsstufen arbeiten zueinander aysnchron.
  • Ebenso kann jede einzelne Verarbeitungstufe Multi-Threaded ausgelegt sein.

Beschränkungen

  • Die Verarbeitungs-Funktionen müssen von diesem Typ sein:
    void FunctionName (Action<PipelineWorkerPool, dynamic> CallBack, object data);
  • Es kann stets nur ein einziger Parameter weitergegeben werden.
  • Dieser Parameter muss in der Verarbeitungs-Funktion retypisiert werden.

// Pipeline anlegen pipeline = new Pipeline (); // Verarbeitungssufe hinzufügen pipeline.Insert (FileSystemWatcherHandler, 1024, 1, nameof (FileSystemWatcherHandler)); ... // Pipeline leer ? Alles verarbeitet ? pipeline.WaitIsEmpty (); // Pipeline beenden pipeline.Truncate (); // eigentliche Verarbeitungsfunktion void FileSystemWatcherHandler (PipelineWorkerPool Member, dynamic Data) { ... }

4.4 Looper

Eine einfache Klasse um einen Thread für jeden Aufruf von Loop genau 1 mal auszuführen.

Methoden

  • End
    Signalsiert den Thread zu beenden. Wartet optional auf die Beedigung des Threads.
  • Stop
    Beendet den Schleifen-Thread hart, falls dieser nach <paramref name="Timeout"/> Millisekunden nicht beendet ist!
  • WaitEmpty
    Wartet bis alle ausstehenden Durchläufe abgearbeitet sind.
  • WaitEnd
    Wartet auf das Ende des Schleifen-Threads.
  • ForceLoop
    min. einen Schleifendurchlauf sicherstellen

Properties

  • LoopsLeft
    Anzahl der noch austehenden Loops, inklusive de gerade laufenden.

4.5 Stack & Queue

4.5.1 diubStack & diubQueue

  • diubQueue
    Thread-sichere First-in-first-out Implementierung ohne Begrenzung der Anzahl.
    Ersetzt ConcurrentQueue.
  • diubStack
    Thread-sichere Last-in-first-out Implementierung ohne Begrenzung der Anzahl.
    Ersetzt ConcurrentQueue.

Properties

  • IsEmpty
    Status ob die Warteschlange leer ist.
  • Counter
    Anzahl der Daten-Objekte in der Warteschlange.

Methoden

Nutzung als Queue (FIFO)

  • Add
    Fügt ein Daten-Objekt der Warteschlange hinzu.
  • Take
    Entnimmt ein Daten-Objekt vom Anfang der Warteschlange.

Nutzung als Stack (LIFO)

  • Push
    Fügt ein Daten-Objekt am Anfang er Liste ein.
  • Pop
    Entnimmt ein Daten-Objekt vom Anfang der Warteschlange.

4.5.2 LimitedStack & LimitedQueue

Eine in der Anzahl begrenzte Thread-sichere Warteschlange für Daten als Queue (FIFO) oder Stack (LIFO) .

Wird die maximale Anzahl Daten-Objekte erreicht, wird der anliefernde Thread pausiert, bis wieder Platz ist.

Properties

  • IsEmpty
    Status ob die Warteschlange leer ist.
  • Counter
    Anzahl der Daten-Objekte in der Warteschlange.

Methoden

Nutzung als Queue (FIFO)

  • Add
    Fügt ein Daten-Objekt der Warteschlange hinzu.
  • Take
    Entnimmt ein Daten-Objekt vom Anfang der Warteschlange.

Nutzung als Stack (LIFO)

  • Push
    Fügt ein Daten-Objekt am Anfang er Liste ein.
  • Pop
    Entnimmt ein Daten-Objekt vom Anfang der Warteschlange.

4.6 xSemaphore

Im Prinzip nur ein Semaphore, das zusätzlich aber die Anzahl der blokierten (wartenden)Threads zurückliefert.

Properties

  • Waiting
    Die Anzahl der blokierten/wartenden Threads.
  • Available
    Die noch verfügbaren Warteplätze.

4.7 Secure

SecureCounter und SecureBool liefern Thread-feste Variablen.

Die Vergleichsoperationen laufen synchronisiert, das bedeutet, das beide Counter blockiert werden. Achtung: Dead-Lock Gefahr!