Lade...
 

CX_WEB_SERVICE_MANAGER::OpenMorphITConnection

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
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    
Funktionsaufruf: Call(OpenMorphITConnection)