WebSocket Inbound Protocol

This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

WebSocket Inbound Protocol

The WSO2 Enterprise Integrator (WSO2 EI) WebSocket protocol implementation is based on the WebSocket protocol, and allows full-duplex message mediation.

Following is a sample WebSocket inbound endpoint configuration:

<inboundEndpoint name="WebSocketListenerEP" onError="fault" protocol=“ws" sequence=“TestIn" suspend="false”> <parameters> <parameter name="inbound.ws.port">9091</parameter> <parameter name="ws.outflow.dispatch.sequence">TestOut</parameter> <parameter name="ws.client.side.broadcast.level">0</parameter> <parameter name="ws.outflow.dispatch.fault.sequence">fault</parameter> </parameters> </inboundEndpoint>

WebSocket inbound endpoint parameters

Parameter

Description

Required

inbound.ws.port

The netty listener port on which the WebSocket inbound listens.

Yes

ws.client.side.broadcast.level 

The client broadcast level that defines how WebSocket frames are broadcasted from the WebSocket inbound endpoint to the client. Broadcast happens based on the subscriber path client connected to the WebSocket inbound endpoint. The three possible levels are as follows:
0 - Only a unique client can receive the frame from a WebSocket inbound endpoint.
1 - All the clients connected with the same subscriber path receives the WebSocket frame.
2 - All the clients connected with the same subscriber path, except the one who publishes the frame to the inbound, receives the WebSocket frame.

Yes

ws.outflow.dispatch.sequence

The sequence for the back-end to client mediation.

Yes

ws.outflow.dispatch.fault.sequence

The fault sequence for the back-end to client mediation path.

Yes

ws.boss.thread.pool.size

The size of the netty boss pool.

No

ws.worker.thread.pool.size

The size of the worker thread pool.

No

ws.subprotocol.handler.class

The custom subprotocol handler classes separated by a semicolon.

No

ws.default.content.type

Specifies the content type of the Web Socket frames that are received from the inbound endpoint.

No

ws.shutdown.status.code

Specifies the status code of the closed web socket frame sent when the inbound endpoint is closed.

No

ws.shutdown.status.message

Specifies the status message of the closed web socket frame when the inbound endpoint is closed.

No