Service : écouteurs de canal et canaux

Il existe trois catégories d’objets de canal : canaux, écouteurs de canal et usines de canaux. Les canaux sont l’interface entre l’application et la pile de canaux. Les écouteurs de canal sont chargés de créer des canaux du côté réception (ou écoute), généralement en réponse à une nouvelle connexion ou un nouveau message entrant. Les générateurs de canaux sont responsables de créer des canaux du côté de l'envoi pour lancer la communication avec un terminal.

Écouteurs de canal et canaux

Les écouteurs de canal sont responsables de la création de canaux et de la réception de messages à partir de la couche inférieure ou du réseau. Les messages reçus sont remis à la couche ci-dessus à l’aide d’un canal créé par l’écouteur de canal.

Le diagramme suivant illustre le processus de réception des messages et leur remise à la couche ci-dessus.

Écouteurs de canal et canaux

Écouteur de canal qui reçoit des messages et les transmet au niveau supérieur via des canaux.

Le processus peut être modélisé conceptuellement en tant que file d’attente à l’intérieur de chaque canal, bien que l’implémentation ne puisse pas réellement utiliser une file d’attente. L’écouteur de canal est chargé de recevoir des messages à partir de la couche inférieure ou du réseau et de les placer dans la file d’attente. Le canal est chargé d’obtenir des messages de la file d’attente et de les remettre à la couche supérieure lorsque cette couche demande un message, par exemple en appelant Receive sur le canal.

WCF fournit des utilitaires de classe de base pour ce processus-ci. Pour obtenir un diagramme des classes d’assistance de canal décrites dans cet article, consultez Vue d’ensemble du modèle de canal.

La discussion suivante est basée sur l’exemple Transport : UDP .

Création d’un écouteur de canal

L’élément UdpChannelListener implémenté par l’exemple dérive de la classe ChannelListenerBase. Il utilise un seul socket UDP pour recevoir des datagrammes. La OnOpen méthode reçoit des données à l’aide du socket UDP dans une boucle asynchrone. Les données sont ensuite converties en messages à l’aide du système d’encodage de message :

message = UdpConstants.MessageEncoder.ReadMessage(
  new ArraySegment<byte>(buffer, 0, count),
  bufferManager
);

Étant donné que le même canal de datagramme représente des messages qui arrivent de plusieurs sources, l'UdpChannelListener est un écouteur Singleton. Il y a, au plus, un IChannel actif associé à cet écouteur à la fois. L’exemple génère un autre uniquement si un canal retourné par la AcceptChannel méthode est ensuite supprimé. Lorsqu’un message est reçu, il est mis en file d’attente dans ce canal singleton.

UdpInputChannel

La UdpInputChannel classe implémente IInputChannel. Il se compose d’une file d’attente de messages entrants alimentée par le socket UdpChannelListener. Ces messages sont retirés de la file d'attente par la Receive méthode.