Adaptateur WebSocket

Statut documentaire : architecture — voir Maturité et preuves.

Rôle

Un adaptateur WebSocket fournit un canal bidirectionnel de longue durée pour événements interactifs, notifications, commandes ou interactions applicatives en streaming.

Architecture

client
   <-> adaptateur WebSocket
   <-> frontière message/channel
   <-> capacité Runtime ou applicative

Utiliser WebSocket lorsque

• le client doit recevoir des notifications initiées par le serveur ;
• une session interactive longue durée est plus adaptée qu'un polling HTTP répété ;
• événements ou commandes nécessitent une livraison bidirectionnelle à faible overhead.

Pour la livraison classique de pages/documents ou les API simples requête/réponse, HTTP reste une frontière plus simple.

Règles de conception

• définir une enveloppe de message applicative plutôt que d'exposer des objets Runtime bruts ;
• définir l'authentification avant d'accepter des messages applicatifs ;
• borner les buffers entrants/sortants et définir la backpressure ;
• définir explicitement keepalive, reconnexion et invalidation de session ;
• considérer qu'une reconnexion peut nécessiter de reconstruire l'état de session/applicatif ;
• propager les identifiants de corrélation dans le traitement des messages.

Statut

Les paths, noms de channels, balises de configuration et classes internes exacts dépendent du déploiement/module et ne constituent pas une API publique stable.