java-ee
La API de WebSockets
Buscar..
Observaciones
WebSocket es un protocolo que permite la comunicación entre el cliente y el servidor / punto final mediante una única conexión TCP.
WebSocket está diseñado para implementarse en navegadores web y servidores web, pero puede ser utilizado por cualquier aplicación cliente o servidor.
Este tema sobre las API de Java para websockets fue desarrollado por JSR 356 e incorporado en las especificaciones de Java EE 7.
Creación de una comunicación WebSocket
WebSocket proporciona un protocolo de comunicación dúplex / bidireccional a través de una única conexión TCP.
- el cliente abre una conexión a un servidor que está escuchando una solicitud de WebSocket
- un cliente se conecta a un servidor utilizando un URI.
- Un servidor puede escuchar solicitudes de múltiples clientes.
Punto final del servidor
Puede crear un punto de acceso de servidor WebSocket simplemente anotando un POJO con @ServerEndpoint
. @OnMessage
decora un método que recibe mensajes entrantes. @OnOpen
se puede usar para decorar un método que se llamará cuando se reciba una nueva conexión de un par. De manera similar, se llama a un método anotado con @OnClose
cuando se cierra una conexión.
@ServerEndpoint("/websocket")
public class WebSocketServerEndpoint
{
@OnOpen
public void open(Session session) {
System.out.println("a client connected");
}
@OnClose
public void close(Session session) {
System.out.println("a client disconnected");
}
@OnMessage
public void handleMessage(String message) {
System.out.println("received a message from a websocket client! " + message);
}
}
Cliente Enpoint
Similar al punto final del servidor, puede crear un punto final de cliente WebSocket anotando un POJO con @ClientEndpoint
.
@ClientEndpoint
public class WebsocketClientEndpoint {
Session userSession = null;
// in our case i.e. "ws://localhost:8080/myApp/websocket"
public WebsocketClientEndpoint(URI endpointURI) {
WebSocketContainer container = ContainerProvider.getWebSocketContainer();
container.connectToServer(this, endpointURI);
}
@OnOpen
public void onOpen(Session userSession) {
System.out.println("opening websocket");
this.userSession = userSession;
}
@OnClose
public void onClose(Session userSession, CloseReason reason) {
System.out.println("closing websocket");
this.userSession = null;
}
@OnMessage
public void onMessage(String message) {
System.out.println("received message: "+ message);
}
public void sendMessage(String message) {
System.out.println("sending message: "+ message);
this.userSession.getAsyncRemote().sendText(message);
}
}
Codificadores y decodificadores: WebSockets orientados a objetos
Gracias a los codificadores y decodificadores, el JSR 356 ofrece modelos de comunicación orientados a objetos.
Definición de mensajes
Asumamos que todos los mensajes recibidos deben ser transformados por el servidor antes de ser enviados de vuelta a todas las sesiones conectadas:
public abstract class AbstractMsg {
public abstract void transform();
}
Supongamos ahora que el servidor administra dos tipos de mensajes: un mensaje basado en texto y un mensaje basado en enteros.
Los mensajes enteros multiplican el contenido por sí mismo.
public class IntegerMsg extends AbstractMsg {
private Integer content;
public IntegerMsg(int content) {
this.content = content;
}
public Integer getContent() {
return content;
}
public void setContent(Integer content) {
this.content = content;
}
@Override
public void transform() {
this.content = this.content * this.content;
}
}
Mensaje de cadena anteponer texto:
public class StringMsg extends AbstractMsg {
private String content;
public StringMsg(String content) {
this.content = content;
}
public String getContent() {
return content;
}
public void setContent(String content) {
this.content = content;
}
@Override
public void transform() {
this.content = "Someone said: " + this.content;
}
}
Codificadores y Decodificadores
Hay un codificador por tipo de mensaje y un solo decodificador para todos los mensajes. Los codificadores deben implementar la Encoder.XXX<Type>
cuando Decoder debe implementar Decoder.XXX<Type>
.
La codificación es bastante sencilla: desde un mensaje, el método de encode
debe generar una cadena con formato JSON. Aquí está el ejemplo para IntegerMsg
.
public class IntegerMsgEncoder implements Encoder.Text<IntegerMsg> {
@Override
public String encode(IntegerMsg object) throws EncodeException {
JsonObjectBuilder builder = Json.createObjectBuilder();
builder.add("content", object.getContent());
JsonObject jsonObject = builder.build();
return jsonObject.toString();
}
@Override
public void init(EndpointConfig config) {
System.out.println("IntegerMsgEncoder initializing");
}
@Override
public void destroy() {
System.out.println("IntegerMsgEncoder closing");
}
}
Codificación similar para la clase StringMsg
. Obviamente, los codificadores se pueden factorizar a través de clases abstractas.
public class StringMsgEncoder implements Encoder.Text<StringMsg> {
@Override
public String encode(StringMsg object) throws EncodeException {
JsonObjectBuilder builder = Json.createObjectBuilder();
builder.add("content", object.getContent());
JsonObject jsonObject = builder.build();
return jsonObject.toString();
}
@Override
public void init(EndpointConfig config) {
System.out.println("StringMsgEncoder initializing");
}
@Override
public void destroy() {
System.out.println("StringMsgEncoder closing");
}
}
El decodificador procede en dos pasos: verifica si el mensaje recibido se ajusta al formato exceptuado con willDecode
y luego transforma el mensaje crudo recibido en un objeto con decode
:
La clase pública MsgDecoder implementa Decoder.Text {
@Override
public AbstractMsg decode(String s) throws DecodeException {
// Thanks to willDecode(s), one knows that
// s is a valid JSON and has the attribute
// "content"
JsonObject json = Json.createReader(new StringReader(s)).readObject();
JsonValue contentValue = json.get("content");
// to know if it is a IntegerMsg or a StringMsg,
// contentValue type has to be checked:
switch (contentValue.getValueType()) {
case STRING:
String stringContent = json.getString("content");
return new StringMsg(stringContent);
case NUMBER:
Integer intContent = json.getInt("content");
return new IntegerMsg(intContent);
default:
return null;
}
}
@Override
public boolean willDecode(String s) {
// 1) Incoming message is a valid JSON object
JsonObject json;
try {
json = Json.createReader(new StringReader(s)).readObject();
}
catch (JsonParsingException e) {
// ...manage exception...
return false;
}
catch (JsonException e) {
// ...manage exception...
return false;
}
// 2) Incoming message has required attributes
boolean hasContent = json.containsKey("content");
// ... proceed to additional test ...
return hasContent;
}
@Override
public void init(EndpointConfig config) {
System.out.println("Decoding incoming message...");
}
@Override
public void destroy() {
System.out.println("Incoming message decoding finished");
}
}
ServerEndPoint
El Server EndPoint se parece bastante a la comunicación de WebSocket con tres diferencias principales:
La anotación ServerEndPoint tiene los atributos de los
encoders
ydecoders
Los mensajes no se envían con
sendText
sino consendObject
Se utiliza la anotación OnError. Si se produjo un error durante
willDecode
, se procesará aquí y la información del error se enviará al cliente@ServerEndpoint (value = "/ webSocketObjectEndPoint", decoders = {MsgDecoder.class}, encoders = {StringMsgEncoder.class, IntegerMsgEncoder.class}) clase pública ServerEndPoint {
@OnOpen public void onOpen(Session session) { System.out.println("A session has joined"); } @OnClose public void onClose(Session session) { System.out.println("A session has left"); } @OnMessage public void onMessage(Session session, AbstractMsg message) { if (message instanceof IntegerMsg) { System.out.println("IntegerMsg received!"); } else if (message instanceof StringMsg) { System.out.println("StringMsg received!"); } message.transform(); sendMessageToAllParties(session, message); } @OnError public void onError(Session session, Throwable throwable) { session.getAsyncRemote().sendText(throwable.getLocalizedMessage()); } private void sendMessageToAllParties(Session session, AbstractMsg message) { session.getOpenSessions().forEach(s -> { s.getAsyncRemote().sendObject(message); }); }
}
Como era bastante detallado, aquí hay un cliente de JavaScript básico para aquellos que desean tener un ejemplo visual. Tenga en cuenta que este es un ejemplo tipo chat: todas las partes conectadas recibirán la respuesta.
<!DOCTYPE html>
<html>
<head>
<title>Websocket-object</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<!-- start of BAD PRACTICE! all style and script must go into a
dedicated CSS / JavaScript file-->
<style>
body{
background: dimgray;
}
.container{
width: 100%;
display: flex;
}
.left-side{
width: 30%;
padding: 2%;
box-sizing: border-box;
margin: auto;
margin-top: 0;
background: antiquewhite;
}
.left-side table{
width: 100%;
border: 1px solid black;
margin: 5px;
}
.left-side table td{
padding: 2px;
width: 50%;
}
.left-side table input{
width: 100%;
box-sizing: border-box;
}
.right-side{
width: 70%;
background: floralwhite;
}
</style>
<script>
var ws = null;
window.onload = function () {
// replace the 'websocket-object' with the
// context root of your web application.
ws = new WebSocket("ws://localhost:8080/websocket-object/webSocketObjectEndPoint");
ws.onopen = onOpen;
ws.onclose = onClose;
ws.onmessage = onMessage;
};
function onOpen() {
printText("", "connected to server");
}
function onClose() {
printText("", "disconnected from server");
}
function onMessage(event) {
var msg = JSON.parse(event.data);
printText("server", JSON.stringify(msg.content));
}
function sendNumberMessage() {
var content = new Number(document.getElementById("inputNumber").value);
var json = {content: content};
ws.send(JSON.stringify(json));
printText("client", JSON.stringify(json));
}
function sendTextMessage() {
var content = document.getElementById("inputText").value;
var json = {content: content};
ws.send(JSON.stringify(json));
printText("client", JSON.stringify(json));
}
function printText(sender, text) {
var table = document.getElementById("outputTable");
var row = table.insertRow(1);
var cell1 = row.insertCell(0);
var cell2 = row.insertCell(1);
var cell3 = row.insertCell(2);
switch (sender) {
case "client":
row.style.color = "orange";
break;
case "server":
row.style.color = "green";
break;
default:
row.style.color = "powderblue";
}
cell1.innerHTML = new Date().toISOString();
cell2.innerHTML = sender;
cell3.innerHTML = text;
}
</script>
<!-- end of bad practice -->
</head>
<body>
<div class="container">
<div class="left-side">
<table>
<tr>
<td>Enter a text</td>
<td><input id="inputText" type="text" /></td>
</tr>
<tr>
<td>Send as text</td>
<td><input type="submit" value="Send" onclick="sendTextMessage();"/></td>
</tr>
</table>
<table>
<tr>
<td>Enter a number</td>
<td><input id="inputNumber" type="number" /></td>
</tr>
<tr>
<td>Send as number</td>
<td><input type="submit" value="Send" onclick="sendNumberMessage();"/></td>
</tr>
</table>
</div>
<div class="right-side">
<table id="outputTable">
<tr>
<th>Date</th>
<th>Sender</th>
<th>Message</th>
</tr>
</table>
</div>
</div>
</body>
</html>
El código está completo y fue probado bajo Payara 4.1. El ejemplo es estándar puro (sin biblioteca / framework externo)