Utilisation de la bibliothèque Perl de l'IMu

Le bundle de code source de l’API IMu Perl pour la version 2.0 (ou supérieure) est nécessaire pour développer une application basée sur IMu. Ce bundle contient toutes les classes qui composent l’API IMu Perl. Contactez l’assistance Axiell pour obtenir l’accès aux bundles de l’API IMu.

Pour construire des applications Perl, le bundle de code source doit être extrait sur la machine serveur et le chemin d’accès au code source spécifié dans la variable d’environnement PERL5LIB ou comme argument au module lib. Par exemple, si le code source de l’API IMu est installé dans le répertoire /usr/local/lib/imu, les lignes suivantes seront ajoutées au code Perl :

use lib '/usr/local/lib/imu'; use IMu; 

Programme de test

La compilation et l’exécution de ce programme très simple basé sur un terminal constituent un bon test pour vérifier si l’environnement de développement a été correctement configuré pour utiliser IMu :

#!/usr/bin/perl  use strict; use warnings; use lib '/usr/local/lib/imu'; use IMu;  printf("IMu version %s\n", $IMu::VERSION); exit(0);

Le fichier IMu.pm définit une classe appelée IMu. Cette classe comprend le membre VERSION qui contient la version de cette distribution d’IMu.

Exceptions

De nombreuses méthodes dans les objets de la bibliothèque IMu lèvent une exception (die dans la terminologie Perl) lorsqu’une erreur se produit. Pour cette raison, le code qui utilise des objets de bibliothèque IMu doit être entouré d’un bloc eval.

Le code suivant est un modèle de base pour écrire des programmes Perl qui utilisent la bibliothèque IMu :

# ⋯ eval { # Create and use IMu objects # ... }; if ($@) { # Handle or report error # ... } 

La plupart des exceptions IMu lèvent un objet IMu::Exception. Dans de nombreux cas, votre code peut simplement gérer la variable $@ (comme dans ce modèle). Si davantage d’informations sont nécessaires au sujet de l’objet IMu::Exception qui a été levé, consultez la rubrique Exceptions.

Note: La plupart des exemples qui suivent supposent que les fragments de code sont entourés de code structuré de cette manière.