ZK AU Engine"
From Documentation
| Line 1: | Line 1: | ||
{{ZKConfigurationReferencePageHeader}} | {{ZKConfigurationReferencePageHeader}} | ||
| − | = | + | =WebSocket = |
{{versionSince|8.5.0}} | {{versionSince|8.5.0}} | ||
{{ZK EE}} | {{ZK EE}} | ||
| − | |||
| − | |||
| − | |||
| − | To enable WebSocket | + | By default, ZK communicates with a server in [https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest XMLHttpRequest] or [https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch Fetch API] asynchronously. Now you can switch to WebSocket. Then <javadoc>org.zkoss.zkmax.au.websocket.WebSocketEndPoint</javadoc> handles ping/pong messages from and to the client. This feature works only for browsers that support WebSocket natively. |
| + | |||
| + | To enable WebSocket connection, add the following listener into zk.xml | ||
<source lang="xml"> | <source lang="xml"> | ||
| − | + | <listener> | |
| − | + | <listener-class>org.zkoss.zkmax.au.websocket.WebSocketWebAppInit</listener-class> | |
| − | + | </listener> | |
</source> | </source> | ||
| Line 21: | Line 20: | ||
When WebSocket connection is enabled, we'll use WebSocketServerPush by default when server-push started. | When WebSocket connection is enabled, we'll use WebSocketServerPush by default when server-push started. | ||
| − | Note that we cannot guarantee the accessing of the information provided by | + | Note that we cannot guarantee the accessing of the information provided by HTTP requests when a WebSocket connection is enabled. |
{{ZKConfigurationReferencePageFooter}} | {{ZKConfigurationReferencePageFooter}} | ||
Revision as of 09:54, 13 April 2022
WebSocket
Since 8.5.0
- Available for ZK:
-
By default, ZK communicates with a server in XMLHttpRequest or Fetch API asynchronously. Now you can switch to WebSocket. Then WebSocketEndPoint handles ping/pong messages from and to the client. This feature works only for browsers that support WebSocket natively.
To enable WebSocket connection, add the following listener into zk.xml
<listener>
<listener-class>org.zkoss.zkmax.au.websocket.WebSocketWebAppInit</listener-class>
</listener>
To change the URL pattern, please refer to this library property.
When WebSocket connection is enabled, we'll use WebSocketServerPush by default when server-push started.
Note that we cannot guarantee the accessing of the information provided by HTTP requests when a WebSocket connection is enabled.