Guide du développeur Enterprise JavaBeans

Guide du développeur Enterprise JavaBeans VERSION 5 Borland JBuilder

Consultez le fichier DEPLOY.TXT situé dans le répertoire redist de JBuilder pour avoir la liste complète des fichiers que vous pouvez distribuer en accord avec votre contrat de licence JBuilder. Les applications mentionnées dans ce manuel sont brevetées par Borland Software Corporation ou en attente de brevet. Ce document ne donne aucun droit sur ces brevets. COPYRIGHT 1997, 2001 Borland Software Corporation. Tous droits réservés. Tous les produits Borland sont des marques commerciales ou des marques déposées de Borland Software Corporation aux Etats-Unis et dans les autres pays. Les autres noms de produits sont des marques commerciales ou des marques déposées de leurs fabricants respectifs. Pour connaître les conditions et limites des fournisseurs tiers, lisez les Remarques version sur votre CD JBuilder. JBE0050WW21002entjb 2E1R0401 0102030405-9 8 7 6 54321 PDF

Table des matières Chapitre 1 Introduction au développement des EJB 1-1 Pourquoi avons-nous besoin des Enterprise JavaBeans?........... 1-2 Rôles dans le développement d une application EJB.............. 1-3 Rôles application................ 1-3 Rôles infrastructure.............. 1-3 Rôles déploiement et opérations....... 1-4 Architecture EJB.................. 1-5 Le serveur EJB................. 1-5 Le conteneur EJB................ 1-6 Comment fonctionne un enterprise bean?. 1-6 Types d enterprise beans............. 1-7 Beans session.................. 1-7 Beans entité................... 1-7 Développement des enterprise beans...... 1-8 Comment contacter le support développeur de Borland.................... 1-9 Ressources en ligne............... 1-9 World Wide Web.............. 1-9 Groupes de discussion Borland......1-10 Groupes de discussion Usenet......1-10 Rapports de bogues.............1-10 Conventions de la documentation........ 1-11 Chapitre 2 Configuration du serveur d applications cible 2-1 Ajout des fichiers du serveur d applications à votre projet................... 2-2 Rendre ORB accessible à JBuilder........ 2-3 Sélection d un serveur d applications...... 2-4 Chapitre 3 Création des enterprise beans avec JBuilder 3-1 Création d un groupe EJB............. 3-2 Création d un groupe EJB vide........ 3-2 Création d un groupe EJB à partir d enterprise beans existant..... 3-3 Création d un enterprise bean.......... 3-4 Création d un bean session.......... 3-6 Création d un bean entité........... 3-7 Ajout de la logique métier à votre bean.... 3-9 Exposition des méthodes métier via l interface distante............ 3-11 Génération de la classe du bean à partir d une interface distante............. 3-12 Création des interfaces locale et distante d un bean existant................ 3-15 Compilation du bean............... 3-17 Modification des descripteurs de déploiement 3-20 Chapitre 4 Création des beans entité à partir d une table existante dans une base de données 4-1 Création des beans entité avec le Modeleur Bean entité EJB........ 4-1 Chapitre 5 Test d un enterprise bean 5-1 Création d un client de test............ 5-1 Utilisation de l application client de test..... 5-3 Test de votre enterprise bean........... 5-5 Chapitre 6 Déploiement des enterprise beans 6-1 Création d un fichier descripteur de déploiement.................. 6-2 Le rôle du descripteur de déploiement...... 6-2 Les types d informations du descripteur de déploiement....... 6-3 Informations structurelles.......... 6-4 Informations sur l assemblage de l application............... 6-4 Sécurité.................... 6-5 Rôles de sécurité............... 6-5 Permissions de méthodes.......... 6-5 Liaison aux références des rôles de sécurité............ 6-5 Déploiement sur un serveur d applications... 6-6 Déploiement d un ou de plusieurs fichiers JAR......... 6-6 Déploiement sur les serveurs WebLogic ou WebSphere................. 6-9 Définition des options de déploiement avec la boîte de dialogue Propriétés.... 6-10 i

Déploiement dynamique sur un serveur d applications........ 6-11 Chapitre 7 Utilisation de l éditeur de descripteur de déploiement 7-1 Affichage de l éditeur de descripteur de déploiement.................. 7-2 Visualisation du descripteur de déploiement d un enterprise bean............... 7-2 Ajout des informations d un nouvel enterprise bean.......... 7-4 Modification des informations concernant le bean................ 7-5 Informations sur les enterprise beans...... 7-5 Panneau Main................. 7-5 Panneau Environment............. 7-7 Panneau EJB references............ 7-8 Panneau Security role references....... 7-9 Panneau Resource references.........7-10 Panneau Persistence..............7-12 Panneau Finders................7-14 Panneau Properties...............7-15 Transactions conteneur..............7-20 Ajout d une transaction gérée par le conteneur................7-20 Travail sur les sources de données........7-21 Définition des niveaux d isolation......7-23 Définition des propriétés des sources de données...........7-23 Ajout des rôles de sécurité et des méthodes autorisées...........7-25 Création d un rôle de sécurité.........7-25 Assignation des méthodes autorisées....7-26 Visualisation et modification des propriétés WebLogic et WebSphere.............7-27 Vérification des informations du descripteur..7-28 Chapitre 8 Utilisation de DataExpress pour les composants EJB 8-1 Les composants DataExpress EJB........ 8-2 Composants pour le serveur......... 8-2 Composants pour le client........... 8-2 Création des beans entité............. 8-2 Création du bean session côté serveur...... 8-3 Ajout des composants fournisseur et résolveur au bean session......... 8-3 Ecriture de la méthode setsessioncontext(). 8-4 Ajout d une référence EJB au descripteur de déploiement...... 8-5 Ajout des méthodes de fourniture et de résolution................ 8-5 Appel de la méthode find........... 8-6 Construction du côté client............ 8-7 Gestion des relations................ 8-9 Projet exemple.................... 8-9 Chapitre 9 Développement des beans session 9-1 Types de beans session............... 9-1 Beans session stateful.............. 9-1 Beans session stateless............. 9-2 Ecriture de la classe du bean session....... 9-2 Implémentation de l interface SessionBean.. 9-2 Ecriture des méthodes métier......... 9-3 Ajout d une ou de plusieurs méthodes ejbcreate()................... 9-3 Comment JBuilder peut vous aider à créer un bean session............ 9-4 La vie d un bean session.............. 9-5 Beans stateless.................. 9-5 Beans stateful.................. 9-6 Etat prêt pour la méthode et état prêt pour la transaction............. 9-7 Un bean session pour faire vos courses...... 9-9 Fichiers de l exemple du chariot virtuel.. 9-10 Le bean session Cart............. 9-10 Ajout des méthodes nécessaires..... 9-11 Ajout des méthodes métier........ 9-13 Classe Item................... 9-15 Exceptions................... 9-15 Interfaces exigées............... 9-16 L interface locale.............. 9-16 L interface distante............. 9-17 Le descripteur de déploiement de Cart. 9-18 Chapitre 10 Développement des beans entité 10-1 Persistance et beans entité............ 10-1 Persistance gérée par le bean......... 10-2 Persistance gérée par le conteneur...... 10-2 Clés primaires des beans entité......... 10-3 Ecriture de la classe du bean entité....... 10-3 Implémentation de l interface EntityBean. 10-4 Déclaration et implémentation des méthodes des beans entité....... 10-5 ii

Création des méthodes Create.......10-5 Création des méthodes Find........10-7 Ecriture des méthodes métier.......10-8 Utilisation des experts de JBuilder pour créer un bean entité..........10-8 La vie d un bean entité..............10-8 L état de non existence.............10-9 L état en pool..................10-9 L état prêt................... 10-10 Retour à l état en pool............ 10-10 Exemple du bean entité bank.......... 10-11 L interface locale d un bean entité..... 10-11 L interface distante d un bean entité.... 10-12 Un bean entité dont la persistance est gérée par le conteneur......... 10-12 Un bean entité dont la persistance est gérée par le bean............ 10-14 La classe clé primaire............ 10-19 Le descripteur de déploiement....... 10-19 Descripteur de déploiement d un bean entité dont la persistance est auto-gérée.............. 10-21 Descripteur de déploiement d un bean entité dont la persistance est gérée par le conteneur....... 10-22 Chapitre 11 Création des interfaces locales et distantes 11-1 Création de l interface locale........... 11-1 La classe de base EJBHome.......... 11-2 Création d une interface locale pour un bean session............. 11-2 Méthodes create() des beans session... 11-3 Création d une interface locale pour un bean entité.............. 11-4 Méthodes create() des beans entité.... 11-4 Méthodes find des beans entité...... 11-5 Création de l interface distante.......... 11-6 L interface EJBObject.............. 11-7 Chapitre 12 Développement des clients des enterprise beans 12-1 Localisation de l interface locale........ 12-2 Obtenir l interface distante............ 12-2 Beans session.................. 12-2 Beans entité.................. 12-3 Les méthodes find et la classe de la clé primaire............. 12-4 Méthodes create et remove........ 12-4 Appel des méthodes............... 12-5 Suppression des instances de beans...... 12-6 Référencement d un bean avec son handle... 12-6 Gestion des transactions............. 12-7 Découvrir les informations sur le bean..... 12-8 Création d un client avec JBuilder....... 12-9 Chapitre 13 Gestion des transactions 13-1 Caractéristiques des transactions........ 13-1 Support des transactions dans le conteneur.. 13-2 Enterprise beans et transactions......... 13-3 Comparaison entre les transactions gérées par le bean et celles gérées par le conteneur...... 13-3 Attributs des transactions.......... 13-4 Transactions locales et globales....... 13-5 Utilisation de l API de transaction....... 13-6 Gestion des exceptions dans les transactions. 13-8 Exceptions au niveau du système...... 13-8 Exceptions au niveau de l application... 13-8 Gestion des exceptions au niveau de l application............... 13-9 Annulation de la transaction....... 13-9 Options pour continuer une transaction 13-10 Index I-1 iii

iv

Chapitre 1 Chapitre1Introduction au développement des EJB Enterprise JavaBeans (EJB) specification (http://java.sun.com/ products/ejb/docs.html) définit de manière formelle un modèle de composant Java côté serveur et une interface de programmation pour les serveurs d applications. Les développeurs construisent des composants, appelés enterprise beans, pour contenir la logique métier de l entreprise. Les enterprise beans s exécutent sur un serveur EJB qui fournit aux beans des services comme la gestion des transactions et la sécurité. Les développeurs n ont pas à se préoccuper de la programmation de ces services de bas niveau et complexes ; ils peuvent se concentrer sur l encapsulation des règles métier de leur organisation à l intérieur des beans, tout en sachant que les services sont accessibles aux beans lorsque c est nécessaire. Outre son rôle d ultime arbitre pour le cadre de travail EJB, la spécification Enterprise JavaBeans sert essentiellement aux fournisseurs, comme Borland, qui construisent les serveurs EJB et les conteneurs dans lesquels s exécutent les beans. Ce manuel aidera le développeur JBuilder à savoir ce qu il veut savoir sur le développement des enterprise beans et sur la création des applications qui les utilisent. Si vous êtes déjà familier du développement des EJB et souhaitez apprendre à créer des enterprise beans avec JBuilder, commencez par le Chapitre 3, Création des enterprise beans avec JBuilder. Introduction au dé veloppement des EJB 1-1

Pourquoi avons-nous besoin des Enterprise JavaBeans? Pourquoi avons-nous besoin des Enterprise JavaBeans? Le modèle client-serveur de développement des applications a eu une popularité considérable. L application client réside sur une machine locale et accède aux données d un ensemble de données tel qu un système de gestion de bases de données relationnelles (SGBR). Ce modèle fonctionne bien tant que le système n a qu un petit nombre d utilisateurs. Lorsque de plus en plus d utilisateurs veulent accéder aux données, ces applications n évoluent pas suffisamment bien pour suivre la demande. Comme la logique se trouve sur le client, il doit être installé sur chaque machine. La gestion devient donc de plus en plus difficile. Petit à petit, est apparue la nécessité de diviser les applications en un nombre de niveaux supérieur aux deux niveaux du modèle client-serveur. Dans une application multiniveau, seule l interface utilisateur réside sur la machine locale alors que la logique de l application s exécute dans un niveau intermédiaire sur un serveur. Le niveau final est toujours constitué par les données stockées. Lorsqu il convient de mettre à jour la logique d une application, les modifications sont apportées au logiciel du niveau intermédiaire sur le serveur, ce qui simplifie considérablement la gestion des mises à jour. Pourtant, la création d applications distribuées fiables, sécurisées et faciles à gérer est notoirement difficile. Par exemple, la gestion des transactions dans un système distribué est une lourde tâche. Heureusement, l utilisation de composants respectant la spécification EJB pour construire des systèmes distribués permet de : Diviser le développement d un système distribué en plusieurs tâches spécifiques assignées à des spécialistes. Par exemple, si l application est un système comptable, le développeur d enterprise beans doit connaître la comptabilité. L administrateur système doit savoir comment surveiller une application déployée en cours d exécution. Chaque spécialiste assume un rôle particulier. Rendre les services du serveur et du conteneur EJB accessibles à l enterprise bean et aux développeurs d applications. Le fournisseur de serveur EJB et le fournisseur de conteneur EJB (c est souvent le même) prennent en charge beaucoup des tâches les plus difficiles, si bien que le développeur n a pas à le faire. Par exemple, le conteneur dans lequel un enterprise bean s exécute peut fournir au bean les services de transaction et de sécurité automatiquement. Rendre portables les enterprise beans. Le bean une fois écrit peut être déployé sur n importe quel serveur EJB qui respecte le standard Enterprise JavaBeans. Cependant, chaque bean est à même d inclure des éléments spécifiques au fournisseur. 1-2 Guide du dé veloppeur Enterprise JavaBeans

R ô les dans le dé veloppement d une application EJB Rôles dans le développement d une application EJB Le travail de développement d une application distribuée EJB se divise en six parties ou rôles distincts. Chaque rôle est pris en charge par un spécialiste du domaine. Le travail ainsi divisé, la création et la gestion d un système distribué deviennent beaucoup plus faciles. Rôles application Ceux qui assurent les rôles concernant les applications écrivent le code des enterprise beans et des applications qui les utilisent. Ce deux domaines exigent une compréhension du métier lui-même mais à des niveaux différents. Voici les deux rôles application : Fournisseur de beans Les fournisseurs de beans (également appelés développeurs de beans) créent les enterprise beans et écrivent la logique des méthodes métier qu ils intègrent. Ils définissent également les interfaces distante et locale des beans et ils créent les descripteurs de déploiement des beans. Les fournisseurs de beans n ont pas obligatoirement besoin de savoir comment leurs beans seront assemblés et déployés. Assembleur d applications Les assembleurs d applications écrivent les applications qui utilisent les enterprise beans. Ces applications comprennent habituellement d autres composants, comme les clients GUI, les applets, les JSP (JavaServer Pages) et les servlets. Ces composants sont assemblés en une application distribuée. Les assembleurs ajoutent des instructions d assemblage aux descripteurs de déploiement des beans. Bien que les assembleurs d applications aient besoin de connaître les méthodes contenues dans les enterprise beans pour les appeler, ils n ont pas besoin de savoir comment elles sont implémentées. Les utilisateurs de JBuilder concernés par Enterprise JavaBeans sont généralement des fournisseurs de beans et des assembleurs d applications. Ce manuel leur est donc dédié. JBuilder possède des experts, des concepteurs et d autres outils qui simplifient le développement des enterprise beans et des applications qui les utilisent. Rôles infrastructure Sans le support d une infrastructure, les enterprise beans et les applications qui les utilisent ne peuvent pas s exécuter. Bien que les deux rôles concernant l infrastructure soient distincts, ils sont presque toujours assurés par le même fournisseur. Ils apportent aux enterprise beans les Introduction au dé veloppement des EJB 1-3

R ô les dans le dé veloppement d une application EJB services du niveau système ainsi que l environnement dans lequel ils s exécutent. Voici les deux rôles infrastructure : Fournisseur de serveurs EJB Les fournisseurs de serveurs EJB sont des spécialistes de la gestion distribuée des transactions, des objets distribués et d autres services de bas niveau. Ils fournissent le cadre de travail applicatif dans lequel s exécutent les conteneurs EJB. Au minimum, les fournisseurs de serveurs EJB doivent fournir aux beans un service d annuaire et un service de transaction. Fournisseur de conteneurs EJB Les fournisseurs de conteneurs EJB fournissent les outils nécessaires au déploiement des enterprise beans et le support des beans à l exécution. Un conteneur procure des services de gestion à un ou à plusieurs beans. Il communique avec le serveur EJB afin d accéder aux services dont le bean a besoin. Dans la majorité des cas, le fournisseur de serveurs EJB et le fournisseur de conteneurs EJB sont confondus. Borland AppServer fournit à la fois le serveur et le conteneur. Rôles déploiement et opérations Les dernières étapes du développement d une application distribuée EJB sont le déploiement de l application et la surveillance, pendant qu elle s exécute, de l informatique de l entreprise et de l infrastructure de son réseau. Voici les rôles déploiement et opérations : Déployeur Les déployeurs connaissent l environnement opératoire des applications distribuées. Ils adaptent l application EJB à l environnement opératoire cible en modifiant les propriétés des enterprise beans au moyen des outils fournis par le fournisseur de conteneurs. Par exemple, les déployeurs déterminent les politiques de transaction et de sécurité en définissant les propriétés correspondantes dans le descripteur de déploiement. Ils intègrent d autre part, l application aux logiciels de gestion existant dans l entreprise. Administrateur système L application une fois déployée, l administrateur système la surveille pendant son exécution et prend les décisions appropriées si elle se comporte anormalement. Les administrateurs système sont chargés de configurer et d administrer l informatique et l infrastructure réseau de l entreprise, ce qui comprend le serveur EJB et le conteneur EJB. 1-4 Guide du dé veloppeur Enterprise JavaBeans

Architecture EJB Architecture EJB Les applications distribuées multiniveaux sont souvent composées d un client s exécutant sur une machine locale, d un niveau intermédiaire s exécutant sur un serveur qui contient la logique métier et d un niveau final constitué d un système d information d entreprise (SIE). Un SIE peut être un système de bases de données relationnelles, un système ERP, une application standard, ou tout ensemble contenant les données qu il faut accéder. Cette figure montre un système distribué EJB typique comportant trois niveaux : le client; le serveur, le conteneur et les beans déployés sur eux; ainsi que le système d information de l entreprise. Figure 1.1 Diagramme de l architecture EJB Notre sujet étant le développement des enterprise beans, nous nous concentrerons sur le niveau intermédiaire. Le serveur EJB Le serveur EJB fournit aux enterprise beans des services système et gère les conteneurs dans lesquels s exécutent les beans. Il doit offrir un service d annuaire accessible via JNDI et un service de transaction. Très souvent, le serveur EJB fait bénéficier de fonctions supplémentaires qui le Introduction au dé veloppement des EJB 1-5

Architecture EJB distinguent de ses concurrents. Borland AppServer est un exemple de serveur EJB. Le conteneur EJB Un conteneur est un système d exécution pour un ou plusieurs enterprise beans. Il fournit la communication entre les beans et le serveur EJB. Il fournit la gestion des transactions, de la sécurité et de la distribution sur le réseau. Un conteneur est à la fois du code et un outil qui génère le code spécifique à chaque enterprise bean. Un conteneur fournit également les outils du déploiement de l enterprise bean ; c est aussi un moyen pour le conteneur de surveiller et de gérer l application. Le serveur EJB et le conteneur EJB fournissent ensemble l environnement où le bean s exécute. Le conteneur fournit des services de gestion à un ou à plusieurs beans. Le serveur fournit les services au bean, mais le conteneur agit pour le compte des beans pour obtenir ces services. Bien qu il s agisse d une partie vitale de l architecture Enterprise JavaBeans, les développeurs d enterprise bean et les assembleurs d applications n ont pas à se préoccuper du conteneur. C est un acteur en coulisse des systèmes distribués EJB. Nous n en dirons donc pas plus sur les conteneurs et leur fonctionnement. Pour avoir des informations, reportez-vous à la Enterprise JavaBeans 1.1 Specification elle-même (http://java.sun.com/products/ejb/docs.html). Pour des informations spécifiques au conteneur EJB de Borland, voyez le Enterprise JavaBeans Programmer s Guide de Borland AppServer. Comment fonctionne un enterprise bean? Le développeur de beans doit créer les interfaces et les classes suivantes : L interface locale du bean L interface locale définit les méthodes utilisées par le client pour créer, localiser et détruire les instances d un enterprise bean. L interface distante du bean L interface distante définit les méthodes métier implémentées dans le bean. Un client accède à ces méthodes via l interface distante. La classe de l enterprise bean La classe de l enterprise bean implémente la logique métier pour le bean. Le client accède à ces méthodes via l interface distante du bean. Le bean une fois déployé dans le conteneur EJB, le client appelle la méthode create() définie dans l interface locale pour instancier le bean. L interface locale n est pas implémentée dans le bean lui-même, mais par 1-6 Guide du dé veloppeur Enterprise JavaBeans

Types d enterprise beans Types d enterprise beans le conteneur. D autres méthodes, déclarées dans l interface locale, permettent au client de localiser une instance d un bean et de supprimer l instance d un bean lorsqu elle n est plus nécessaire. Lorsque l enterprise bean est instancié, le client peut appeler les méthodes métier qu il contient. Toutefois, le client n appelle jamais de méthode directement dans l instance du bean. Les méthodes accessibles au client sont définies dans l interface distante du bean, et celle-ci est implémentée par le conteneur. Lorsque le client appelle une méthode, le conteneur reçoit la demande et la délègue à l instance du bean. Un enterprise bean peut être un bean session ou un bean entité. Beans session Un enterprise bean session s exécute au bénéfice d un client unique. D une certaine façon, le bean session représente le client pour le serveur EJB. Les beans session peuvent maintenir l état du client, ce qui signifie qu ils peuvent conserver des informations pour le client. L exemple classique où un bean session peut être utilisé est celui du chariot que remplit un acheteur dans un magasin en ligne du web. Au fur et à mesure que l acheteur sélectionne un élément à mettre dans son chariot, le bean session conserve la liste des éléments sélectionnés. Les beans session peuvent avoir une courte durée de vie. Généralement, le bean est supprimé par le client lorsque celui-ci termine la session. Les beans session peuvent être stateful ou stateless. Les beans Stateless ne maintiennent pas d état pour un client particulier. Puisqu ils ne maintiennent pas d état conversationnel, les beans stateless peuvent être utilisés pour supporter plusieurs clients. Beans entité Un bean entité fournit un objet vue des données d une base. Habituellement, le bean représente une ligne dans un ensemble de tables d une base de données relationnelles. Un bean entité sert généralement plusieurs clients. Au contraire des beans session, les beans entité sont supposés avoir une longue durée de vie. Ils maintiennent un état persistant, vivant aussi longtemps que les données restent dans la base, et non aussi (peu) longtemps qu un client particulier a besoin d eux. Introduction au dé veloppement des EJB 1-7

D é veloppement des enterprise beans Le conteneur peut gérer la persistance du bean, ou le bean peut la gérer lui-même. Si la persistance est gérée par le bean, le développeur du bean doit écrire le code incluant les appels à la base de données. Développement des enterprise beans Les chapitres suivants expliquent comment utiliser les experts, les concepteurs et les outils de JBuilder qui faciliteront et accéléreront la création de vos enterprise beans. Il part de l hypothèse que vous savez ce que sont les Enterprise JavaBeans, comment ils fonctionnent et quelles sont leurs exigences. Si votre connaissance d EJB est insuffisante ou si vous voulez avoir plus d informations sur le développement EJB avant de commencer à utiliser les experts et les outils EJB de JBuilder, lisez le Chapitre 9, Développement des beans session et les chapitres qui suivent avant de continuer. Le développement des Enterprise JavaBeans avec JBuilder se divise en plusieurs étapes : 1 Configuration du serveur d applications cible (voir Chapitre 2) 2 Création d un groupe EJB (voir page 3-2) 3 Création d un enterprise bean et de ses interfaces locale et distante (voir page 3-4) 4 Compilation du bean (voir page 3-17) 5 Modification du descripteur de déploiement (voir page 3-20) 6 Création d une application client de test (voir page 5-1) 7 Test de votre enterprise bean (voir page 5-5) 8 Déploiement sur un serveur d applications (voir page 6-6) Vous pouvez aussi utiliser JBuilder pour créer des enterprise beans de type entité, basés sur les tables de n importe quelle base de données accessible via JDBC. Voir Création des beans entité avec le Modeleur Bean entité EJB, page 4-1. Si vous préférez créer d abord l interface distante d un enterprise bean, vous pouvez ensuite utiliser le Créateur de bean EJB pour créer le squelette de la classe et l interface locale en fonction de cette interface distante. Pour plus d informations, voir Génération de la classe du bean à partir d une interface distante, page 3-12. 1-8 Guide du dé veloppeur Enterprise JavaBeans

Comment contacter le support dé veloppeur de Borland Comment contacter le support développeur de Borland Borland offre aux développeurs diverses options de support. Elles comprennent des services gratuits sur Internet, où vous pouvez consulter notre importante base d informations et entrer en contact avec d autres utilisateurs de produits Borland. En outre, vous pouvez choisir parmi plusieurs catégories de support, allant de l installation des produits Borland au support tarifé de niveau consultant, en passant par une assistance complète. Pour obtenir des informations sur les services Borland de support aux développeurs, veuillez consulter notre site Web, à l adresse http://www.borland.fr/support/. Quand vous contacterez le support, préparez des informations complètes sur votre environnement, la version du produit que vous utilisez et une description détaillée du problème. Pour avoir de l aide sur les outils tiers, ou leur documentation, contactez votre fournisseur. Ressources en ligne Vous pouvez obtenir des informations depuis les sources ci-après: World Wide Web FTP Listserv http://www.borland.fr/ ftp.borland.com Documents techniques accessibles par anonymous ftp. Pour vous abonner aux bulletins électroniques, utilisez le formulaire en ligne : http://www.borland.com/contact/listserv.html ou, pour l international, http://www.borland.com/contact/intlist.html World Wide Web Consultez régulièrement www.borland.fr/jbuilder. L équipe produit de JBuilder y place notes techniques, analyses des produits concurrents, réponses aux questions fréquemment posées, exemples d applications, mises à jour du logiciel et informations sur les produits existants ou nouveaux. Vous pouvez vous connecter en particulier aux URL suivantes : http://www.borland.fr/produits/jbuilder/ (mises à jour du logiciel et autres fichiers) Introduction au dé veloppement des EJB 1-9

Comment contacter le support dé veloppeur de Borland http://community.borland.com/ (contient notre magazine d informations web pour les développeurs) Groupes de discussion Borland Vous pouvez vous inscrire à JBuilder et participer à de nombreux groupes de discussion dédiés à JBuilder. Vous trouverez des groupes de discussion, animés par les utilisateurs, pour JBuilder et d autres produits Borland, à l adresse http://www.borland.fr/newsgroups/ Remarque Groupes de discussion Usenet Les groupes Usenet suivants sont dédiées à Java et concernent la programmation : news:comp.lang.java.advocacy news:comp.lang.java.announce news:comp.lang.java.beans news:comp.lang.java.databases news:comp.lang.java.gui news:comp.lang.java.help news:comp.lang.java.machine news:comp.lang.java.programmer news:comp.lang.java.security news:comp.lang.java.softwaretools Ces groupes de discussion sont maintenus par les utilisateurs et ne sont pas des sites Borland officiels. Rapports de bogues Si vous pensez avoir trouvé un bogue dans le logiciel, merci de le signaler dans la page du support développeur de JBuilder, à l adresse http://www.borland.fr/support/jbuilder/. Sur ce site, vous pouvez également demander une fonctionnalité ou consulter la liste des bogues déjà signalés. Quand vous signalez un bogue, indiquez toutes les étapes nécessaires à la reproduction de ce bogue, ainsi que tout paramètre spécial de votre environnement et les autres programmes utilisés avec JBuilder. Précisez bien le comportement attendu et ce qui s est réellement passé. Si vous avez des commentaires (compliments, suggestions ou questions) concernant la documentation de JBuilder, vous pouvez envoyer un e-mail à jpgpubs@borland.com. Uniquement pour la documentation. Les questions de support doivent être adressées au support développeur. JBuilder est fait par des développeurs pour des développeurs. Nous apprécions vraiment vos remarques, car elles nous aident à améliorer notre produit. 1-10 Guide du dé veloppeur Enterprise JavaBeans

Conventions de la documentation Conventions de la documentation La documentation Borland sur JBuilder utilise les polices et les symboles décrits dans le tableau ci-dessous pour signaler du texte particulier. Tableau 1.1 Polices et symboles Police Police à espacement fixe Gras Italiques Signification La police à espacement fixe représente : du texte tel qu il apparaît à l écran du texte que vous devez taper, comme Entrez Hello World dans le champ Titre de l expert Application. des noms de fichiers des noms de chemins des noms de répertoires ou de dossiers des commandes, comme SET PATH, CLASSPATH du code Java des types de données Java, comme boolean, int et long. des identificateurs Java, comme des noms de variables, classes, interfaces, composants, propriétés, méthodes et événements des noms de paquets des noms d argument des noms de champs des mots clés Java, comme void et static Le gras est utilisé pour désigner les outils java, bmj (Borland Make for Java), bcj (Borland Compiler for Java) et les options du compilateur. Par exemple : javac, bmj, -classpath. L italique est utilisé pour les termes nouveaux, les titres des manuels et, parfois, pour la mise en valeur. Touches Cette police indique une touche de votre clavier. Par exemple, Appuyez sur Echap pour quitter un menu. [ ] Les crochets droits dans le texte ou dans la syntaxe entourent les éléments facultatifs. Ne tapez pas ces crochets. < > Les crochets angulaires dans le texte ou dans la syntaxe indiquent une chaîne variable ; entrez la chaîne appropriée à votre code. Ne tapez pas ces crochets. Les crochets angulaires sont également utilisés pour les balises HTML.... Dans les exemples de code, les points de suspension indiquent du code manquant. Sur un bouton, les points de suspension indiquent que ce bouton ouvre un dialogue de sélection. Introduction au dé veloppement des EJB 1-11

Conventions de la documentation JBuilder est disponible sur plusieurs plates-formes. Reportez-vous au tableau ci-dessous pour une description des conventions et répertoires associés aux diverses plates-formes dans la documentation. Tableau 1.2 Conventions et répertoires associés aux plates-formes Elément Chemins Répertoire de base Répertoire.jbuilder5 Répertoire jbproject Captures d écran Signification Les chemins d accès mentionnés dans la documentation sont indiqués par une barre oblique (/). Pour la plate-forme Windows, utilisez une barre oblique inverse (\). L emplacement du répertoire de base dépend de la plate-forme. Pour UNIX et Linux, le répertoire de base peut varier. Par exemple, ce peut être /user/[nomutilisateur] ou /home/ [nomutilisateur] Pour Windows 95/98, le répertoire de base est C:\Windows Pour Windows NT, le répertoire de base est C:\Winnt\ Profiles\[nomutilisateur] Pour Windows 2000, le répertoire de base est C:\Documents and Settings\[nomutilisateur] Le répertoire.jbuilder5, où sont stockés les paramètres de fonctionnement de JBuilder, est placé dans le répertoire de base. Le répertoire jbproject, qui contient les fichiers projet, classe et source, est placé dans le répertoire de base. JBuilder enregistre les fichiers dans ce chemin par défaut. Les captures d écran reflètent l apparence Metal de JBuilder sur diverses plates-formes. 1-12 Guide du dé veloppeur Enterprise JavaBeans

Chapitre 2 Chapitre2Configuration du serveur d applications cible Remarque Remarque Avant de commencer à créer des Enterprise JavaBeans, vous devez configurer le serveur d applications sur lequel vous allez les déployer. Dans tous les cas, Borland AppServer (BAS) ou Inprise Application Server 4.1 (IAS) doit avoir été installé sur votre ordinateur. Pour configurer JBuilder afin qu il cible un ou plusieurs serveurs d applications, 1 Choisissez Outils Configuration Entreprise. 2 Sélectionnez la page Serveur d applications. Vous pouvez accomplir l étape suivante quel que soit le serveur d applications pour lequel vous développez vos enterprise beans. Si vous ne l accomplissez pas, les experts EJB sera estompés dans la galerie d objets. 3 Sélectionnez la page BAS 4.5 ou la page IAS 4.1 et spécifiez le répertoire où est installé Borland AppServer 4.5 ou Inprise Application Server 4.1. Pour BAS 4.5, c est habituellement /Borland/AppServer. Définir une des Configuration du serveur d applications cible 2-1

Ajout des fichiers du serveur d applications à votre projet pages des serveurs d applications Borland vous empêche de définir l autre. 4 Si vous voulez cibler le serveur WebLogic ou WebSphere, sélectionnez la page WebLogic ou WebSphere pour la version souhaitée et spécifiez le répertoire où est installé le serveur d applications WebLogic ou WebSphere. Pour WebSphere, vous devez également spécifier où est installé le JDK IBM livré avec WebSphere. Pour WebLogic 6.0, le répertoire local de BEA est exigé. 5 Si vous voulez utiliser le serveur d applications que vous être en train de définir comme cible du projet en cours, cochez la case Appliquer les paramètres pour le serveur d application modifié au projet en cours. 6 Choisissez OK. Lorsque vous fermez la boîte de dialogue, une bibliothèque BAS 4.5 est automatiquement créée et elle contient tous les fichiers BAS qui vous seront nécessaires pour le développement EJB. (Si votre cible est Inprise Application Server, le nom de la bibliothèque sera IAS 4.1.) Vous devez fermer puis redémarrer JBuilder pour activer les experts EJB. Si vous voulez rendre VisiBroker ORB accessible à JBuilder, vous pouvez attendre de terminer cette étape avant d interrompre et de redémarrer JBuilder. Ajout des fichiers du serveur d applications à votre projet Vous devez ajouter à votre projet une bibliothèque contenant les fichiers de votre serveur d applications. Au début de chaque nouveau projet, vous devez accomplir cette étape. Si vous avez coché la case Appliquer les 2-2 Guide du dé veloppeur Enterprise JavaBeans

Rendre ORB accessible à JBuilder paramètres pour le serveur d application modifié au projet en cours dans la boîte de dialogue Configuration Entreprise, vous pouvez, pour cette fois, sauter cette étape car JBuilder a déjà ajouté la bibliothèque appropriée au projet en cours. Mais, au prochain démarrage d un nouveau projet, vous devrez respecter les étapes suivantes pour ajouter une bibliothèque au projet en cours : 1 Choisissez Projet Propriétés du projet et assurez-vous que l onglet Chemins est sélectionné. 2 Cliquez sur l onglet Bibliothèques nécessaires. 3 Cliquez sur le bouton Ajouter pour afficher la boîte de dialogue Sélection de bibliothèques. Les bibliothèques disponibles dépendent des serveurs d applications installés et configurés avec Outils Configuration Entreprise. 4 Sélectionnez la bibliothèque appropriée. Par exemple, si vous ciblez Borland AppServer, sélectionnez la bibliothèque BAS 4.5 et cliquez deux fois sur OK pour fermer les boîtes de dialogue. Rendre ORB accessible à JBuilder Lorsque vous utilisez Outils Configuration Entreprise pour définir Borland AppServer ou Inprise Application Server, vos paramètres CORBA sont automatiquement configurés en même temps. Vous pouvez voir les paramètres en cours sur la page CORBA de la boîte de dialogue Configuration Entreprise. Vous pouvez souhaiter utiliser cette page pour définir le port SmartAgent de VisiBroker par un numéro unique. De même, pour ajouter au menu Outils une commande démarrant le SmartAgent, cochez l option Ajouter un nouvel élément Smart Agent VisiBroker au menu Outils. Configuration du serveur d applications cible 2-3

S é lection d un serveur d applications Il reste encore une étape à accomplir : démarrer le SmartAgent VisiBroker. Cela gère les problèmes d amorçage initial comme la façon dont le client localise le service d annuaire, ou autre. Pour démarrer le Smart Agent, choisissez Outils Smart Agent VisiBroker. Sélection d un serveur d applications JBuilder peut cibler un des multiples serveurs d applications. Après avoir sélectionné le serveur d applications cible, terminez la configuration de JBuilder en modifiant les propriétés de votre projet : 1 Choisissez Projet Propriétés du projet. 2 Cliquez sur l onglet Serveurs. 3 Cliquez sur le bouton à points de suspension pour afficher la boîte de dialogue Sélection du serveur d applications. Les serveurs d applications disponibles dans la boîte de dialogue dépendent des serveurs d applications supportés par JBuilder, du fait qu ils aient été ajoutés en utilisant l API OpenTools de JBuilder ou le bouton Ajouter de cette boîte de dialogue. 4 Sélectionnez le serveur d applications sur lequel s exécuteront les beans que vous construisez. Borland AppServer 4.5 est le serveur par défaut. L option EJB 1.1 est générique. Sélectionnez-la si le serveur d applications que vous utilisez n est actuellement pas pris en charge par JBuilder. Vous pouvez modifier le descripteur de déploiement résultant à l aide des outils fournis avec ce serveur d applications, pour définir les paramètres exactement comme vous le souhaitez. Vous pouvez également choisir cette option si vous ne ciblez aucun serveur d applications particulier. 5 Choisissez OK pour fermer la boîte de dialogue. 2-4 Guide du dé veloppeur Enterprise JavaBeans

Chapitre 3 Chapitre3Création des enterprise beans avec JBuilder Chaque enterprise bean que vous créez doit appartenir à un groupe EJB de JBuilder. Un groupe EJB est un groupement logique d un ou de plusieurs beans qui seront déployés dans un même fichier JAR. Il contient les informations utilisées pour produire le ou les descripteurs de déploiement pour ce fichier JAR. Vous pouvez modifier le contenu d un groupe EJB avec l éditeur de descripteur de déploiement. Lorsque vous disposez d un groupe EJB et que vous l avez modifié pour votre liaison avec l éditeur de descripteur de déploiement, vous pouvez Construire ou Reconstruire le groupe EJB pour produire le JAR. JBuilder utilise le descripteur de déploiement pour vous aider à identifier les fichiers classe à empaqueter. Selon l extension de son nom de fichier, un groupe EJB peut appartenir à l un ou à l autre des deux types suivants :.ejbgrp.ejbgrpx Un fichier binaire. Un fichier XML. L information est la même que dans un fichier.ejbgrp mais, comme c est un fichier texte, il est plus facile de travailler avec lorsque vous utilisez un système de contrôle de version. Vous pouvez avoir plusieurs groupes EJB dans un projet. Tous les groupes EJB d un même projet utilisent le même chemin de classes du projet et le même JDK, ils sont aussi configurés pour le même serveur d applications cible. Si ce n est déjà fait, suivez les instructions décrites au Chapitre 2, Configuration du serveur d applications cible. Vous devez suivre les Cré ation des enterprise beans avec JBuilder 3-1

Cré ation d un groupe EJB Création d un groupe EJB étapes permettant d ajouter la bibliothèque contenant les fichiers de votre serveur d applications à chaque projet EJB que vous entreprenez. Il y a deux façons de créer un groupe EJB : Utiliser l expert Groupe EJB vide pour créer un groupe EJB vide lorsque vous n avez pas encore créé vos enterprise beans. Utiliser l expert Groupe EJB depuis descripteurs pour créer un EJB à partir des descripteurs de déploiement des enterprise beans dont vous disposez. Si vous n avez pas ouvert de projet avant de lancer l expert de groupe EJB, JBuilder affiche d abord l expert projet. L expert EJB apparaît après la création d un nouveau projet. Création d un groupe EJB vide Remarque Si vous n avez pas encore créé vos enterprise beans, commencez par créer un groupe EJB vide. Pour créer un groupe EJB vide, 1 Choisissez Fichier Nouveau et cliquez sur l onglet Entreprise. Si les experts EJB de la page Entreprise sont estompés, vous n avez pas encore configuré votre serveur d applications. Pour plus d informations sur la façon de le faire, voir Chapitre 2, Configuration du serveur d applications cible. 2 Double-cliquez sur l icône de l expert Groupe EJB vide pour faire apparaître l expert : 3-2 Guide du dé veloppeur Enterprise JavaBeans

3 Spécifiez le nom du groupe EJB. Cré ation d un groupe EJB 4 Spécifiez le type du nouveau groupe. Les choix sont ejbgrp, qui stocke en interne les descripteurs de déploiement au format.zip et était utilisé avant JBuilder 5, et ejbgrpx, qui stocke les descripteurs de déploiement au format XML. Le format XML permet aux utilisateurs de fusionner les modifications s ils les vérifient à l aide d un système de contrôle des sources. Nous recommandons ejbgrpx sauf si vous partagez le fichier avec une version antérieure de JBuilder. 5 Spécifiez le nom du fichier JAR où vous mettrez votre ou vos enterprise beans. JBuilder propose une valeur par défaut correspondant au nom de votre groupe EJB. Vous pouvez accepter ce nom ou en saisir un autre. JBuilder propose également un chemin d accès basé sur le chemin de votre projet. Vous pouvez modifier ou accepter le chemin par défaut. 6 Cliquez sur OK pour créer le groupe EJB. Création d un groupe EJB à partir d enterprise beans existant Si vous disposez déjà d enterprise beans BAS, ajoutez-les au groupe EJB en suivant les étapes ci-dessous : 1 Choisissez Fichier Nouveau et cliquez sur l onglet Entreprise. 2 Double-cliquez sur l icône de l expert Groupe EJB depuis descripteurs pour faire apparaître l expert. 3 Spécifiez le nom de votre nouveau groupe EJB. Cré ation des enterprise beans avec JBuilder 3-3

Cré ation d un enterprise bean 4 Spécifiez le type du nouveau groupe. Les choix sont ejbgrp, qui stocke en interne les descripteurs de déploiement au format.zip et était utilisé avant JBuilder 5, et ejbgrpx, qui stocke les descripteurs de déploiement au format XML. Le format XML permet aux utilisateurs de fusionner les modifications s ils les vérifient à l aide d un système de contrôle des sources. Nous recommandons ejbgrpx sauf si vous partagez le fichier avec une version antérieure de JBuilder. 5 Spécifiez le nom et le chemin du fichier JAR où sera votre enterprise bean. JBuilder propose une valeur par défaut correspondant au nom de votre groupe EJB. Vous pouvez accepter ce nom ou en saisir un autre. 6 Cliquez sur Suivant et spécifiez le répertoire contenant le ou les descripteurs de déploiement que vous voulez ajouter au groupe. L expert vous montre alors les descripteurs de déploiement présents dans le répertoire spécifié dans le champ Descripteurs utilisables trouvés. Création d un enterprise bean 7 Cliquez sur Terminer pour créer le groupe EJB contenant les descripteurs de déploiement des beans existants. La galerie d objets de JBuilder contient deux experts permettant de créer des enterprise beans : l expert Enterprise JavaBean et le Modeleur Bean entité EJB. Le menu Experts en contient un autre : l expert Créateur de bean EJB. Cette section explique comment créer un enterprise bean avec l expert Enterprise JavaBean. 3-4 Guide du dé veloppeur Enterprise JavaBeans

Cré ation d un enterprise bean L expert Enterprise JavaBean et l expert Modeleur Bean entité EJB utilisent un modèle dans lequel la classe et les interfaces locale et distante de votre enterprise bean sont créées en même temps. Si vous préférez commencer le développement de votre enterprise bean en créant en premier votre interface distante, voyez Génération de la classe du bean à partir d une interface distante, page 3-12, pour savoir comment utiliser l expert Créateur de bean EJB afin de générer la classe de votre bean à partir de l interface distante que vous avez créée. Pour commencer à créer un enterprise bean avec l expert Enterprise JavaBean, 1 Choisissez Fichier Nouveau et cliquez sur l onglet Entreprise. 2 Double-cliquez sur l icône de l expert Enterprise JavaBean. L expert apparaît. 3 Dans la liste déroulante, sélectionnez le groupe EJB auquel vous voulez faire appartenir votre enterprise bean. Cliquez sur Suivant pour passer à l étape 2 de l expert. Si vous n avez pas défini de groupe EJB avant de lancer l expert Enterprise JavaBeans ou si vous voulez en créer un nouveau, cliquez sur le bouton Nouveau pour lancer l expert Groupe EJB vide. Vous devez avoir défini au moins un groupe EJB dans votre projet avant de pouvoir créer un enterprise bean. Lorsque le groupe EJB a été créé avec Cré ation des enterprise beans avec JBuilder 3-5

Cré ation d un enterprise bean l expert Groupe EJB vide, sélectionnez le nouveau groupe et choisissez Suivant pour reprendre les étapes de l expert Enterprise JavaBean. 4 Spécifiez le nom de classe de votre bean, la paquet qui le contiendra et sa classe de base. Ensuite, vous devez décider si vous créez un bean session ou un bean entité. Création d un bean session Si vous créez un bean session, 1 Cliquez sur Bean session stateless ou sur Bean session stateful. Pour plus d informations sur les types de beans session, voir Types de beans session, page 9-1. 2 Si vous sélectionnez un Bean session stateful, vous pouvez aussi choisir d implémenter l interface SessionSynchronization en cochant la case Synchronisation de session. Pour plus d informations sur l interface SessionSynchronization, voir L interface SessionSynchronization, page 9-8. 3-6 Guide du dé veloppeur Enterprise JavaBeans

3 Cliquez sur Suivant pour aller à l étape 3. Cré ation d un enterprise bean 4 Spécifiez des noms pour les Classe de l interface locale, Classe de l interface distante et Nom du bean local ; JBuilder propose des noms par défaut en se servant du nom de classe de votre bean. 5 Cliquez sur Terminer. Création d un bean entité Si vous créez un bean entité, 1 Choisissez entre les options Bean entité à persistance gérée par Bean et Bean entité EJB 1.1 à persistance gérée par conteneur. (Si WebSphere 3.5 est votre serveur d applications cible, la seconde option est Bean entité EJB 1.0 à persistance gérée par conteneur.) Pour plus d informations sur la persistance gérée par le bean ou par le conteneur, voir Persistance et beans entité, page 10-1. 2 Spécifiez une Classe clé primaire. Cré ation des enterprise beans avec JBuilder 3-7

Cré ation d un enterprise bean 3 Cliquez sur Suivant pour aller à l étape 3. 4 Spécifiez des noms pour les Classe de l interface locale, Classe de l interface distante et Nom du bean local ; JBuilder propose des noms par défaut en se servant du nom de classe de votre bean. 5 Cliquez sur Terminer. Lorsque vous avez cliqué sur le bouton Terminer, JBuilder crée la classe du bean et ses interfaces locale et distante. Vous les verrez apparaître dans le volet projet. Examinez le code source de la classe du bean et vous verrez que la classe implémente l interface SessionBean s il s agit d un bean session et qu elle implémente l interface EntityBean s il s agit d un bean entité. JBuilder a ajouté des méthodes dont le corps vide : ce sont les méthodes que tous les enterprise beans doivent implémenter. Vous pouvez ajouter au corps de ces méthodes le code qui fournit la logique nécessaire à votre bean lorsque qu elles sont appelées. L interface locale étend l interface EJBHome et contient la méthode create() qui crée le bean. L interface distante étend l interface EJBObject mais elle est vide car vous n avez déclaré aucune méthode de logique métier pour votre bean. Bien que vous puissiez commencer votre bean entité en utilisant l expert Enterprise JavaBeans, le meilleur moyen de créer des beans entité est d utiliser le Modeleur Bean entité EJB. Les beans entité que vous créez avec l expert Enterprise JavaBean ne supporteront pas la vérification de l éditeur de descripteur de déploiement si vous ne complétez pas le bean plus avant. 3-8 Guide du dé veloppeur Enterprise JavaBeans