24 lines
1.2 KiB
ReStructuredText
24 lines
1.2 KiB
ReStructuredText
.. _-handleWebSocketMessagesForProtocol-java-:
|
|
|
|
handleWebSocketMessagesForProtocol
|
|
==================================
|
|
|
|
Description
|
|
-----------
|
|
Handles WebSocket requests with the given handler if the given subprotocol is offered in the ``Sec-WebSocket-Protocol``
|
|
header of the request and rejects other requests with an ``ExpectedWebSocketRequestRejection`` or an
|
|
``UnsupportedWebSocketSubprotocolRejection``.
|
|
|
|
The directive first checks if the request was a valid WebSocket handshake request and if the request offers the passed
|
|
subprotocol name. If yes, the directive completes the request with the passed handler. Otherwise, the request is
|
|
either rejected with an ``ExpectedWebSocketRequestRejection`` or an ``UnsupportedWebSocketSubprotocolRejection``.
|
|
|
|
To support several subprotocols, for example at the same path, several instances of ``handleWebSocketMessagesForProtocol`` can
|
|
be chained using ``~`` as you can see in the below example.
|
|
|
|
For more information about the WebSocket support, see :ref:`server-side-websocket-support-java`.
|
|
|
|
Example
|
|
-------
|
|
|
|
.. includecode:: ../../../../code/docs/http/javadsl/server/directives/WebSocketDirectivesExamplesTest.java#handleWebSocketMessagesForProtocol
|