Introduction aux WebSockets

1. Les étapes de la communication

Trois étapes constituent la communication par WebSocket :

2. L’établissement de la communication

L’établissement de la communication par WebSocket doit pouvoir se faire sur le même port que les requêtes HTTP classiques. La requête cliente initiant la communication est donc tout simplement une requête HTTP.

Cette requête possède des en-têtes particuliers qui permettent ensuite de communiquer sur le protocole WebSocket.

Voici un exemple de ce type de requête :

La requête est classique (protocole, URL, méthode). Les différences se situent dans les en-têtes de requête et de réponse. Les en-têtes Connection et Upgrade permettent de demander l’établissement d’une connexion avec le protocole...

1. La mise en place de l’environnement de développement

L’objectif de ce chapitre est d’appréhender le fonctionnement des websockets au travers d’un projet exemple nommé Projet_WebSocket.

plugins { 
    id 'java' 
    id 'war' 
} 
 
repositories { 
    jcenter() 
} 
 
dependencies { 
    compileOnly group: 'jakarta.websocket', name: 
'jakarta.websocket-api', version: '2.0.0' 
} 

2. Le développement par annotations

Introduction

Le développement des WebSockets peut se faire par l’utilisation d’annotations sur des classes POJO. C’est la manière retenue dans l’ouvrage pour faire la présentation.

Les annotations sont présentes dans les packages jakarta.websocket et jakarta.websocket.server. 

@ServerEndPoint

L’annotation @ServerEndPoint permet de déclarer une classe POJO comme étant un point de terminaison côté serveur (Server End Point). Cette annotation attend un paramètre value permettant de définir l’URL de la ressource associée. Dans la suite de l’ouvrage, cette classe sera nommée WebSocket.

Voici un exemple de mise en œuvre :

@ServerEndpoint(value="/acces") 
public class CompteurAccesWebSocket  
{ 
    ... 
}...

1. Introduction

La spécification WebSocket décrit une API cliente permettant de communiquer avec une ressource exposée avec l’annotation @ServerEndPoint. Les acteurs principaux sont :

2. La mise en place de l’environnement de développement

Dans le cadre de l’ouvrage, l’application cliente sera développée sous la forme d’une console Java classique à partir d’un projet Gradle nommé Projet_Client_WebSocket.

Lorsque le projet est créé, il reste à modifier le fichier build.gradle pour mettre en place les dépendances suivantes afin d’obtenir l’implémentation Tomcat de la partie client de la spécification WebSocket :

implementation group: 'org.apache.tomcat', name: 'tomcat-websocket', 
version: '10.0.7' 
implementation group: 'org.apache.tomcat', name: 'tomcat-api', 
version: '10.0.7' 

Rafraîchissez votre projet pour qu’il soit prêt pour le développement.

3. Le développement par annotations

Introduction

Comme pour le côté serveur, il est possible de développer la partie cliente avec des annotations. La différence avec la partie serveur est l’impossibilité d’utiliser l’annotation @ServerEndPoint. Il est donc...

1. Introduction

Les navigateurs modernes permettent d’établir une communication par WebSocket avec une ressource exposée sur un serveur. Vous pouvez visualiser en détail la liste des navigateurs compatibles à l’adresse suivante : http://caniuse.com/#feat=websockets

Pour résumer, voici les versions minimales des navigateurs les plus courants :

2. L’interface WebSocket

Le langage JavaScript propose une interface nommée WebSocket et décrite par le W3C. Sa définition est accessible à l’URL suivante : https://websockets.spec.whatwg.org/

Ce qu’il faut retenir, c’est qu’il y a quatre gestionnaires d’événements (EventHandler) permettant de gérer les différentes étapes de la communication :

À ces différents EventHandler, il est possible d’associer une méthode qui sera appelée lors de la survenue de l’événement.

À côté de ces EventHandler, la méthode send() permet d’envoyer un message passé en paramètre.

3. Le côté client de l’exemple

L’exemple consiste en une page web HTML nommée...