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 IMu::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.

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 IMu::Session, puis d’appeler la méthode connect. Par exemple :
```
use IMu::Session; # ⋯ my $session = IMu::Session->new('server.com', 12345); $session->connect(); 
```
Vous pouvez également ne transmettre aucune valeur au constructeur, puis définir les propriétés host et port (à l’aide des méthodes setHost et setPort) avant d’appeler connect :
```
use IMu ::Session ; # ⋯ my $session = IMu ::Session->new() ;  $session->setHost('server.com') ; $session->setPort(12345) ; $session->connect() ; 
```
Si l’hôte ou le port n’est pas défini, la valeur par défaut de la classe IMu::Session sera utilisée. Ces valeurs par défaut peuvent être remplacées en définissant les propriétés de classe (statiques) defaultHost et defaultPort :
```
use IMu ::Session ;  # ⋯ IMu ::Session ::setDefaultHost('server.com') ; IMu ::Session ::setDefaultPort(12345) ;  my $session = IMu ::Session->new() ;  $session->connect() ; 
```
Cette technique est utile lorsque vous prévoyez de créer plusieurs connexions au même serveur ou lorsque vous souhaitez qu’un objet Handler établisse automatiquement la connexion.

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 IMu::Handler d’IMu.

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

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