Skip to main content
Diesen Ansatz nutzt du, wenn du einen sofort nutzbaren Browser-Client willst, der bereits:
  • die WebSocket/STOMP Verbindung aufbaut (/ws mit SockJS-Fallback auf /sock)
  • die Standard-Topics abonniert (/topic/msm/* und /user/topic/msm/*)
  • SSR-Render- und JSON-Requests publiziert

Setup

Bundle einbinden und App initialisieren:
Wenn du den Client aus einem ES-Modul initialisierst, kannst du die Instanz exportieren:
MSM2.App öffnet die WebSocket-Verbindung automatisch und registriert Standard-Listener für HTML- und JSON-Responses.

Mit msm-framework-js initialisieren

Wenn die Bibliothek als separates Browser-Skript eingebunden wird, erstelle den Client nach dem Laden der Bibliothek. Übergib den WebSocket-Endpunkt deiner Anwendung:
Ersetze wss://music.mastermindcms.com durch die WebSocket-URL deiner Anwendung. In einem Bundler kannst du msm-framework-js als Abhängigkeit hinzufügen und denselben Aufruf new MSM2.App(...) verwenden.

APIs aufrufen

Nach der Initialisierung stellt MSM2App Convenience-Methoden für zwei WebSocket-Request-Stile bereit:
  • Render (SSR): renderPage, renderElement, invokeAndRender, updateBeanAndRender, addToRepositoryAndRender, saveToRepositoryAndRender, removeFromRepositoryAndRender, addDocumentAndRender, removeDocumentAndRender
  • JSON: invoke, invokeAndGetJson$, updateBeanAndGetJson$, Repository-Calls und Datenbank-Dokument-Calls

Beispiel: SSR rendern

Beispiel: Backend-Service aufrufen und JSON erhalten

Beispiel: Custom Topic abonnieren

Wenn dein Backend eigene Events unter /topic/** publiziert, kannst du einen zusätzlichen Listener registrieren:

Hinweise

  • Für JSON-Calls kannst du actionId zur Korrelation verwenden, wenn du eigene Request-Messages baust. Bei invokeAndGetJson$ und ähnlichen Helfern wird actionId automatisch erzeugt.
  • Autorisierung kann je nach Konfiguration über Session/Remember-me Cookies oder über JWT erfolgen.