Connexion à un serveur IMu

La plupart des programmes basés sur IMu commencent par créer une connexion à un serveur IMu. Les connexions à un serveur sont créées et gérées à l’aide de la classe Session de l’IMu. Avant de se connecter, le nom de l’hôte et le numéro de port auquel se connecter doivent être spécifiés. Cela peut se faire de trois manières.

1. La façon la plus simple de créer une connexion à un serveur IMu est de passer le nom d’hôte et le numéro de port au constructeur Session, puis d’appeler la méthode Connect. Par exemple:

   C#

   using IMu; // ⋯ Session session = new Session("server.com", 12345) ; session.Connect() ; 

   VB

   ImportationsIMu ' ⋯ Dim session = New Session("server.com", 12345) session.Connect() 

2. Il est également possible de ne transmettre aucune valeur au constructeur, puis de définir les propriétés Host et Port avant d'appeler Connect:

   C#

   using IMu; // ⋯ Session session = new Session(); session.Host = "server.com"; session.Port = 12345; session.Connect(); 

   VB

   Imports IMu ' ⋯ Dim session as Session = New Session session.Host = "server.com" session.Port = 12345 session.Connect() 

3. Si l’hôte ou le port n’est pas défini, la valeur par défaut de la classe Session sera utilisée. Ces valeurs par défaut peuvent être modifiées en définissant les propriétés (statiques) de la classe DefaultHost et DefaultPort:

   C#

   using IMu; // ⋯ Session.DefaultHost = "server.com"; Session.DefaultPort = 12345; Session session = new Session(); session.Connect(); 

   VB

   Imports IMu ' ⋯ Session.DefaultHost = "server.com" Session.DefaultPort = 12345 Dim session = New Session session.Connect() 

   Cette technique est utile lorsque l'on prévoit de créer plusieurs connexions au même serveur ou que l'on souhaite obtenir un objet Handler pour créer la connexion automatiquement.

Handlers

Une fois qu’une connexion à un serveur IMu a été établie, il est possible de créer des objets handler pour soumettre des requêtes au serveur et recevoir des réponses.

Note: Lorsqu’un objet handler est créé, un objet correspondant est créé par le serveur IMu pour traiter les requêtes du handler.

Tous les handlers sont des sous-classes de la classe Handler d’IMu.

Note: Vous ne créez généralement pas un objet Handler directement, mais utilisez plutôt une sous-classe.

Dans ce document, nous examinons le handler le plus fréquemment utilisé, Module, qui vous permet de trouver et de récupérer des enregistrements à partir d’un seul module EMu.