Skip to main content
Version: v10.15

Working with WebSockets


WebSockets represent the next evolution of web communications a full-duplex, bidirectional communications channel that operate through a single socket over the Web. It provides a true standard that you can use to build scalable, real-time web applications. It provides full-duplex communication channels over a single TCP connection. Its only relationship to HTTP is that its handshake is interpreted by HTTP servers as an Upgrade Request.

With WaveMaker you can integrate any third-party WebSocket Service into your app and build real-time apps. Just like a REST service, you can import a WebSocket Service and create a Variable to communicate with the service. The data received from the service at the client is held by the Variable, which can be further used to bind to Widgets like Charts, Data Table, Lists, etc and have them reflect data in real-time.

Data Handling

Data returned from the WebSocket Service can be handled in three different ways:

As data snapshot

By choosing to refresh the WebSocket service variable, you will be dealing with the latest data returned by the service. This option can be used when you want to deal the latest information.

Append data

By choosing to add as last record, you can append the data to the variable dataset. In such cases for performance and UI optimization, it is advisable to set a limit on the size of the data held by the variable. This option can be used when displaying tracking information in a chart format like stock performance, heart rate monitor graph, and more.

Prepend data

By choosing to add as first record, you can prepend the data to the variable dataset. In such cases for performance and UI optimization, it is advisable to set a limit on the size of the data held by the variable. This option can be used when displaying the data in a list or data table format, with the latest entry on the top of the list, like match scores or weather reports.

Importing a WebSocket Service

Just like any web service, a WebSocket service can be imported into a WaveMaker app.

  1. Provide the WebSocket service URL, test the connection and import the service.

  2. To leverage the full power of the platform, you should provide the sample request and response body while configuring the service. This helps the platform to generate request and response type metadata for the service, which can be utilized while binding the input to the corresponding Variable and the output of the Variable to a widget.

  3. WebSocket Service can be further configured by specifying the Query, Path, and Body Parameters as per the app requirements.

  4. The newly created service will be visible under the Web Service

  5. Select the service name listed under WebSocket Service to access the Service Settings.

Limitation

Since WMO is hosted on https, a WebSocket service on ws:// protocol cannot be tested because of security limitations on browsers. To cater this, the platform detects if the URL entered by the user is on ws:// protocol and throws a warning to the user with a message. At this point the TEST button is disabled. You can still proceed, however, by checking the Proceed without Test option. You can check this flag, provide sample Request Body and Sample Response and proceed to config screen without testing.

note

It is not recommended to use ws:// URL as it may not work. Best practice is to use wss:// URLs only.

WebSocket Data Consumption

To use the WebSocket Service within your app, you need to create a Variable. This is the interface for the app developer to interact with a WebSocket Service imported into a WaveMaker app. The Variable has methods to interact with the target service like opening and closing the connection, sending and receiving messages to and from the server. It also holds the data to be sent to the service and the data received from the service.

Click here to know more.