Utilisation de la bibliothèque Java de l'IMu

Un seul fichier jar, imu-2.0.jar (ou supérieur), est nécessaire pour développer une application basée sur IMu. Ce jar contient toutes les classes qui composent l’API Java IMu. Contactez l’assistance Axiell pour obtenir l’accès aux bundles de l’API IMu.

Comme pour tous les fichiers jar, le jar IMu doit être inclus dans le classpath Java afin que le compilateur Java et l’environnement d’exécution Java puissent trouver et utiliser les classes IMu. Les outils de développement Java tels qu’Eclipse et NetBeans vous permettent d’ajouter une référence au jar IMu à votre projet.

Toutes les classes de l’API Java IMu sont incluses dans un seul package, com.kesoftware.imu. Comme c’est habituellement le cas dans le développement Java, vous pouvez faire référence à une classe IMu dans votre code en :

• En utilisant le nom complet :

  com.kesoftware.imu.Session session = new com.kesoftware.imu.Session() ;

• Importer explicitement la classe requise :

  import com.kesoftware.imu.Session ; Session session = new Session() ; 

• Importer implicitement toutes les classes du package :

  import com.kesoftware.imu.* ; Session session = new Session() ; 

Programme de test

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

import com.kesoftware.imu.*; class Hello { static void main(String[] args) { System.out.format("IMu version %s%n", IMu.VERSION); System.exit(0); } } 

La bibliothèque IMu comprend une classe appelée IMu. Cette classe comprend le membre statique String VERSION qui contient la version de cette distribution d’IMu.

Exceptions

De nombreuses méthodes des objets de la bibliothèque IMu lèvent une exception lorsqu’une erreur se produit. Pour cette raison, le code qui utilise des objets de bibliothèque IMu doit être entouré d’un bloc try / catch.

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

import com.kesoftware.imu.*; try{ // Créer et utiliser des objets IMu // ⋯ } catch (Exception e) { // Gérer ou signaler l'erreur // ⋯ } 

La plupart des exceptions IMu lèvent un objet IMuException. IMuException est une sous-classe de la classe Java standard Exception. Dans de nombreux cas, votre code peut simplement intercepter l’exception standard Exception (comme dans ce modèle). Si davantage d’informations sont nécessaires au sujet de l’exception IMuException exacte qui a été levée, 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.