CX_WEB_SERVICE_MANAGER::OpenMorphITConnection
186192
Beschreibung:
Öffnet eine Websocket-Verbindung zum angegebenen MorphIT-Server. Erst nach erfolgreicher Registrierung mit dem MorphIT-Server können Web-Widgets nativ verwendet werden und je nach Server-Konfiguration auch eingehende MorphIT-Verbindungen an diese Instanz gebunden werden.
Dieser Aufruf kehrt sofort zurück und wartet nicht auf eine erfolgreiche Registrierung. Sobald sich die Instanz erfolreich beim MorphIT-Server registriert hat, liefert HasMorphITConnection TRUE zurück. Sobald OpenMorphITConnection aufgerufen wurde, werden weitere Aufrufe ignoriert. Um den Zielserver zu ändern, muss zuerst CloseMorphITConnection aufgerufen werden, um eine bestehende Verbindung oder einen Verbindungsversuch abzubrechen.
Sollte der Server nicht erreichbar sein, oder die Verbindung nicht akzeptieren, dann versucht ClassiX alle 10 Sekunden die Verbindung zu dem Server erneut aufzubauen. Gleiches geschieht auch, falls der Server eine bestehende Verbindung beendet.
Code-Beispiel:
Define(StartMorphITAutomatically)
g_minorVersion 186191 > if {
LocalVar(host, port, ssl, endpoint)
"CX_MORPHIT_PORT" SystemObject Call(GetEnvironment) Dup -> port Cardinality ifnot { (-1) return }
"CX_MORPHIT_HOST" SystemObject Call(GetEnvironment) Truncate Dup -> host Cardinality ifnot { (-1) return }
"CX_MORPHIT_SSL" SystemObject Call(GetEnvironment) Integer if TRUE else FALSE -> ssl
"CX_MORPHIT_ENDPOINT" SystemObject Call(GetEnvironment) Truncate Dup -> endpoint Cardinality ifnot { "/" -> endpoint } //Use default endpoint
ssl host port endpoint webServiceManager Call(OpenMorphITConnection)
0
}
;
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | STRING | Der Websocket-Endpunkt (Bsp: "/") |
Top-1 | INTEGER | Der Port, an welchen der Server Websocket-Verbindungen annimmt (HTTP-Port) | |
Top-2 | STRING | Der Hostname/IP des Servers zu dem die Verbindung aufgebaut werden soll | |
Top-3 | INTEGER (TRUE/FALSE) | Gibt an, ob die Verbindung verschlüsselt über SSL (TRUE) aufgebaut werden soll, oder nicht (FALSE) | |
Stack(Out) | Top |