Unsupported APIs

The following part of the Java™ API for WebSocket are not supported in the current release:

• message handlers – these include the methods of javax.websocket.Session interface:
  • addMessageHandler
  • removeMessageHandler
  • getMessageHandlers

  An attempt to use any of these methods will result in UnsupportedOperationException.

• access to WebSocketContainer – an attempt to use javax.websocket.Session.getContainer() method will result in UnsupportedOperationException.
• sending binary messages via OutputStream/Writer – an attempt to use the following methods will result in UnsupportedOperationException:
  • RemoteEndpoint.Basic.getSendStream()
  • RemoteEndpoint.Basic.getSendWriter()
• reading messages through InputStream/Reader – an attempt to use InputStream or Reader as the message type in the methods with the @OnMessage annotation will result in DeploymentException and a failure to deploy the endpoint.
• encoders/decoders – an attempt to use the following methods will result in UnsupportedOperationException:
  • RemoteEndpoint.Async.sendObject(java.lang.Object)
  • RemoteEndpoint.Async.sendObject(java.lang.Object, javax.websocket.SendHandler)
  • RemoteEndpoint.Basic.sendObject(java.lang.Object)

  An attempt to use java.lang.Object as the message or the return type in the methods with the @OnMessage annotation will result in DeploymentException and a failure to deploy the endpoint.