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.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!