Eine Methode ausführen
Jede Operation dieser Anwendung - Text lesen, die Sprachmodelle wählen und die Modulverwaltung - wird auf dieselbe Weise gestartet und meldet ihren Ausgang auf dieselbe Weise. Es sind Execute-Methoden des Data Layer; wie Execute-Methoden allgemein funktionieren, ist in Execute-Methoden beschrieben.
Der Aufbau einer Operation
Eine Operation liegt unter ihrer eigenen Adresse und hat immer drei Teile:
<operation>/execute write here to run it <operation>/input/... the values it works on <operation>/output/status-code what happened, as a number <operation>/output/status-text what happened, in words
Manche Operationen haben mehr unter output/ - zum Beispiel den Text eines Leseergebnisses -, aber
execute, status-code und status-text sind immer vorhanden.
Eine Operation ausführen
-
Schreiben Sie die Eingabeknoten.
-
Schreiben Sie auf
execute. Der Wert spielt keine Rolle; der Schreibvorgang selbst löst die Operation aus. -
Lesen Sie
output/status-code, um zu erfahren, ob sie funktioniert hat.
Das Schreiben auf execute ist ein blockierender Aufruf: Er kehrt zurück, wenn die Operation
abgeschlossen ist. Sie müssen also kein "ready"-Flag pollen und keinen Zustand in Ihrem Programm
verfolgen. Eingaben behalten ihre Werte zwischen den Durchläufen, eine wiederholte Operation braucht
also nur Schritt 2.
Den Ausgang prüfen
output/status-code ist eine vorzeichenbehaftete Zahl, und allein das Vorzeichen sagt Ihnen, ob es
funktioniert hat:
| Wert | Bedeutung |
|---|---|
größer als 0 |
Die Operation war erfolgreich |
0 |
Die Operation ist seit dem Start der Anwendung nicht gelaufen |
kleiner als 0 |
Die Operation ist fehlgeschlagen und hat nichts erzeugt |
Die Prüfung in einer SPS ist also einfach status-code < 0. Einen bestimmten Code brauchen Sie nur,
wenn Sie auf verschiedene Fehler unterschiedlich reagieren wollen - etwa auf eine nicht installierte
Sprache anders als auf eine Kamera, die nicht antwortet.
output/status-text enthält denselben Ausgang als Satz und nennt den beanstandeten Wert, wenn es
einen gibt:
ok: 4 word(s), mean score 0.91 (eng, SINGLE_BLOCK) error: crop/startX + crop/width (100 + 900 = 1000) exceeds the image width 640
Lesen Sie ihn, wenn etwas schiefgeht; bauen Sie keine Logik darauf auf, weil sich der Wortlaut zwischen Releases ändern kann. Die vollständige Liste der Codes steht in Ausführungsstatus.
|
Der Grund kommt auf Derselbe Text wird in das Anwendungsprotokoll geschrieben, sodass ein Fehler auch ganz ohne den Data
Layer diagnostizierbar ist: auf ctrlX OS über das ctrlX Logbook oder |
Eine Operation zur Zeit
Ein Modul führt jeweils eine Operation aus. Eine zweite zu starten, während die erste noch läuft,
stellt sie nicht in eine Warteschlange - sie kehrt sofort mit Statuscode -1 (belegt) zurück und tut
nichts. Der Schreibvorgang selbst antwortet mit TooManyOperations (ctrlX: DL_TOO_MANY_OPERATIONS),
siehe Eine Operation zur Zeit.
Die Sperre gilt pro Modul, verschiedene Module lesen also parallel - eine zweite Kamera wird von der ersten nicht aufgehalten.
Die Ausgaben gehören zum startenden Durchlauf
Jede Methode leert ihre eigenen Ausgabeknoten, sobald sie beginnt - read-text sein
output/result. Sie werden geleert, bevor irgendetwas fehlschlagen kann; ein Durchlauf, der aus
irgendeinem Grund fehlschlägt, lässt sie also leer zurück, statt das Ergebnis eines früheren
Durchlaufs zu behalten.
Deshalb ist es sicher, eine Ausgabe zu lesen, ohne vorher output/status-code zu prüfen: Was Sie
sehen, ist entweder das Ergebnis dieses Durchlaufs oder nichts, nie ein veralteter Wert von einem
früheren Bild.
output/status-code und output/status-text sind die Ausnahme - sie beschreiben immer den letzten
Versuch, und genau das ist ihr Zweck.
|
Lesen Sie eine Ausgabe, bevor Sie den nächsten Durchlauf auslösen. Die Ausgaben beschreiben den
jüngsten Durchlauf, und der nächste Aufruf leert sie in dem Moment, in dem er startet. Wenn Sie
Der einzige Fall, der nichts leert, ist ein Aufruf, der als
Warten Sie, bis |