Package org.eclipse.jetty.websocket.core.server

Interface Handshaker

All Known Implementing Classes:

AbstractHandshaker, HandshakerSelector, RFC6455Handshaker, RFC8441Handshaker

public interface Handshaker

Method Summary

Modifier and Type	Method	Description
boolean	isWebSocketUpgradeRequest(Request request)	A preliminary check to see if a request is likely to be a valid WebSocket Upgrade Request.
static Handshaker	newInstance()
boolean	upgradeRequest(WebSocketNegotiator negotiator, Request request, Response response, Callback callback, WebSocketComponents components, Configuration.Customizer defaultCustomizer)	Attempts to upgrade a request to WebSocket.

Method Details

newInstance

static Handshaker newInstance()

isWebSocketUpgradeRequest

boolean isWebSocketUpgradeRequest(Request request)

A preliminary check to see if a request is likely to be a valid WebSocket Upgrade Request. If this returns true the Request may be a valid upgrade request, but if this returns false returns false you can avoid calling upgradeRequest(WebSocketNegotiator, Request, Response, Callback, WebSocketComponents, Configuration.Customizer) entirely as it will always fail

Parameters:

request - the request

Returns:

true if the request is thought to be a valid websocket upgrade request.

upgradeRequest

boolean upgradeRequest(WebSocketNegotiator negotiator,
 Request request,
 Response response,
 Callback callback,
 WebSocketComponents components,
 Configuration.Customizer defaultCustomizer)
                throws WebSocketException

Attempts to upgrade a request to WebSocket.

Returns true if the WebSocket upgrade is successful and a successful response is generated and the callback eventually completed, or if the WebSocket upgrade failed and a failure response is generated and the callback eventually completed. Returns false if a response is not generated and the caller is responsible for generating a response and completing the callback.

Parameters:

negotiator - the negotiator

request - the request

response - the response

callback - the callback

components - the WebSocket components

defaultCustomizer - the customizer

Returns:

true if a response was generated, false if a response is not generated

Throws:

WebSocketException - there is an error during the upgrade