Boîte de dialogue Propriétés IDL générique

C'est une fonctionnalité de JBuilder Entreprise.

Pour ouvrir la boîte de dialogue Propriétés pour les fichiers IDL OrbixWeb, cliquez avec le bouton droit sur un fichier IDL dans le volet projet et sélectionnez Propriétés. Pour que cette boîte de dialogue s'affiche, sélectionnez d'abord OrbixWeb comme Compilateur IDL dans la page Construction de la boîte de dialogue Projet|Propriétés du projet.

Afin de compiler les fichiers générés, vous devez créer et ajouter une bibliothèque de classes à votre projet qui référence les fichiers classe OrbixWeb. Utilisez la page CORBA de la boîte de dialogue Outils|Configuration Entreprise.

La boîte de dialogue Propriétés IDL OrbixWeb vous permet de spécifier les options de compilation des interfaces distantes définies en langage IDL (Interface Definition Language). Quand un fichier est compilé, elle génère les définitions d'interfaces Java, les stubs client Java et les squelettes de code serveur. Cela permet à un client Java d'appeler de manière transparente un objet IDL situé sur un serveur distant ou permet à un serveur Java de définir des objets qui peuvent être appelés de manière transparente par des clients IDL.

Lorsque vous invoquez le compilateur IDL en cliquant avec le bouton droit sur un fichier IDL et en sélectionnant Construire ou Reconstruire, le fichier IDL source est compilé et une structure de répertoire contenant les mappages Java des déclarations IDL est créée. Généralement plusieurs fichiers Java correspondent à un seul fichier IDL pour marshaller/dé-marshaller les types de données Java en types CORBA et proposer des messages IIOP. Les noms de fichier IDL doivent se terminer par l'extension .idl.

Pour plus d'informations sur le développement d'applications objet distribuées en utilisant JBuilder, voir le Guide du développeur d'applications distribuées. Pour plus d'informations sur la création d'une application CORBA avec des interfaces définies avec IDL, voir "Exploration des applications distribuées CORBA dans JBuilder".

Pour plus d'informations, consultez la documentation OrbixWeb.

Traiter ce fichier IDL

Quand cette option est sélectionnée, vous pouvez définir des options de compilation, ajouter au projet en cours les fichiers et/ou paquets compilés et voir les résultats du compilateur.

Lorsque l'option est cochée, la sélection de OK définit les options utilisées par l'outil OrbixWeb au moment de la compilation du fichier IDL. Définissez les bonnes options pour qu'à la compilation, les définitions des interfaces Java ainsi que les stubs et les squelettes du serveur et du client Java soient générés.

Lorsque l'option Traiter ce fichier IDL n'est pas cochée, la sélection de OK enregistre les options sélectionnées, mais n'appelle pas le compilateur OrbixWeb au moment de la compilation du fichier IDL. Cela signifie que les stubs client et les squelettes serveur ne sont pas générés lorsque le fichier IDL est compilé.

La première étape de création d'une application de ce type consiste à spécifier tous vos objets et leurs interfaces en utilisant le langage IDL (Interface Definition Language) de OMG. L'IDL peut être mis en correspondance avec de nombreux langages de programmation.

La spécification de l'interface créée est utilisée pour générer les routines stub pour le programme client et le code squelette pour l'implémentation de l'objet. Les routines stub sont utilisées par le programme client pour les invocations de méthodes. Vous utilisez le code squelette, ainsi que le code que vous écrivez, pour créer le serveur qui implémente l'objet. Le code pour le client et celui pour l'objet, une fois terminés, sont utilisées comme entrée de votre compilateur Java pour produire une applet ou une application Java et un serveur d'objet.

Page Options du compilateur

Cette page fournit des options pour modifier le code source Java généré lorsqu'un fichier source IDL est compilé. Par défaut, un fichier source IDL est compilé et une structure de répertoires contenant les correspondances Java pour les déclarations IDL est créée. Généralement, un fichier IDL sera mis en correspondance avec plusieurs fichiers Java, car Java n'autorise qu'une interface ou classe publique par fichier.

Paquet

Génère le code dans le paquet spécifié. Le nom de paquet pour les définitions est mis au début avec le nom de paquet spécifié. Si un répertoire ayant ce nom de paquet n'existe pas, il sera créé. Si le répertoire paquet existe, son contenu est mis à jour. (Equivalent à l'indicateur -jP IDL.EXE).

Pas de filtrage des commentaires

Sélectionnez cette option pour autoriser les commentaires. Désélectionnez cette option pour filtrer les commentaires. (Equivalent à l'indicateur -c IDL.EXE).

Créer un filtrage par objet

Sélectionnez cette option pour indiquer que le code de filtrage par objet sera généré. (Equivalent à l'indicateur -F IDL.EXE).

Conformité OMG

Sélectionnez cette option pour indiquer que seul le code conforme aux spécifications CORBA OMG (Object Management Group) sera généré. Si cette case est cochée, le code incluant la fonctionnalité OrbixWeb n'est pas généré. (Equivalent à l'indicateur -jOMG IDL.EXE).

Préprocessus seulement

Lorsque cette option est sélectionnée, ne lance que le préprocesseur IDL. (Equivalent à l'indicateur -E IDL.EXE).

Créer le support pour "equals"

Lorsque cette option est sélectionnée, propose le support pour la méthode equals() dans le code généré. (Equivalent à l'indicateur -jQ IDL.EXE).

Créer seulement le client

Lorsque cette option est sélectionnée et que les fichiers sont compilés, ne génère que le code côté client (stubs). Lorsqu'elle est désélectionnée, le code côté client et côté serveur est généré. (Equivalent à l'indicateur -jc IDL.EXE).

Chemin d'inclusion

Cliquez sur le bouton Points de suspension pour ouvrir une boîte de dialogue qui permet de sélectionner le répertoire dans lequel rechercher les fichiers à inclure dans la construction. Vous devez sélectionner un répertoire contenant un fichier .idl. (Equivalent à l'indicateur -I IDL.EXE).

Options supplémentaires

Ce champ vous permet de spécifier les options qui ne sont pas disponibles dans cette boîte de dialogue. Pour une liste des options possibles, consultez la documentation OrbixWeb.

Protocole de marshalling

Spécifie si le code marshalling doit être généré pour l'IIOP (InterORB Object Protocol). Par défaut, le code généré supporte les deux protocoles IIOP et OrbixWeb. (Equivalent à l'indicateur -m IDL.EXE).

Page Définitions conditionnelles

Cette page affiche la liste des symboles définis pour la compilation conditionnelle de l'IDL. Cliquez sur Nouveau pour ajouter un nouveau symbole, cliquez sur Supprimer pour enlever le symbole mis en évidence.

Bouton Nouveau

Ouvre une boîte de dialogue qui vous permet de définir un nom de symbole pour la compilation conditionnelle IDL, par exemple #define name def.

Bouton Supprimer

Ce bouton permet de supprimer le symbole sélectionné de la liste des symboles définis pour la compilation conditionnelle.

Bouton OK

Lorsque l'option Traiter ce fichier IDL est cochée, la sélection de OK définit les options utilisées par l'outil OrbixWeb au moment de la compilation du fichier IDL. Définissez les options correctes afin que, lors de la compilation, les définitions d'interface Java, les stubs client et les squelettes de code serveur soient générés dans un sous-répertoire du projet portant le même nom que le projet.

Lorsque l'option Traiter ce fichier IDL n'est pas cochée, la sélection de OK enregistre les options sélectionnées, mais n'appelle pas le compilateur OrbixWeb au moment de la compilation du fichier IDL. Cela signifie que les stubs client et les squelettes serveur ne sont pas générés lorsque le fichier IDL est compilé.