- die WebSocket/STOMP Verbindung aufbaut (
/wsmit 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: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:
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 stelltMSM2App 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
actionIdzur Korrelation verwenden, wenn du eigene Request-Messages baust. BeiinvokeAndGetJson$und ähnlichen Helfern wirdactionIdautomatisch erzeugt. - Autorisierung kann je nach Konfiguration über Session/Remember-me Cookies oder über JWT erfolgen.