HATS vous offre la possibilité de transformer l'accès à vos applications hôte existantes en utilisant des applications client enrichi avec interface graphique exécutées dans les environnements Eclipse RCP, Lotus Notes ou Lotus Expeditor Client.
Eclipse RCP constitue un sous-ensemble des modules d'extension fournis par la plateforme Eclipse, la plateforme d'outils de source ouverte bien connue. L'introduction de la plateforme client enrichi Eclipse vous permet de bénéficier des fonctionnalités essentielles offertes par Eclipse pour construire des applications client natives ciblées pour le bureau d'un utilisateur. Pour plus d'informations sur la plateforme client enrichi Eclipse, voir la page Web http://www.eclipse.org/home/categories/rcp.php.
Lotus Notes est un logiciel complexe et puissant vous permettant d'accéder instantanément à vos informations essentielles. Lotus Notes permet d'envoyer et de recevoir des messages électroniques, de planifier vos rendez-vous, de naviguer sur le Web, de participer à des groupes de discussion sur Internet et de bénéficier d'un accès simplifié à l'ensemble des informations importantes de la journée via la page d'accueil. Pour plus d'informations, voir le centre de documentation Lotus Notes à l'adresse http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp.
Lotus Expeditor Client fournit un environnement d'exécution client enrichi et des composants middleware intégrés pour étendre de nombreuses applications d'entreprise sur les systèmes de bureau et portables gérés par un serveur. Pour plus d'informations sur le développement et le déploiement d'applications pour Lotus Expeditor Client, reportez-vous au centre de documentation Lotus Expeditor à l'adresse http://publib.boulder.ibm.com/infocenter/ledoc/v6r2/index.jsp.
Sauf indication contraire, les instructions fournies ici concernent le développement et le déploiement d'applications client enrichi HATS dans les environnements Eclipse RCP V3.4, Lotus Notes V8.5.1 et Lotus Expeditor Client V6.2. Pour connaître les instructions qui s'appliquent aux versions antérieures d'Eclipse RCP et de Lotus Expeditor Client, voir les versions antérieures des centres de documentation appropriés.
Un environnement client enrichi offre des fonctionnalités qui ne sont pas disponibles dans un environnement Web traditionnel, notamment :
Pour obtenir plus d'informations sur le développements d'applications client enrichi, consultez le Sommaire de l'aide de Rational SDP. Sélectionnez Aide > Sommaire dans la barre de menus et recherchez rich client (client enrichi).
Lors de la création d'applications client enrichi HATS, les différences entre les environnements Eclipse RCP, Lotus Notes et Lotus Expeditor Client sont minimes. Elles sont décrites tout au long de ce chapitre.
La principale différence au niveau architectural entre une application client enrichi HATS et une application Web HATS réside dans l'emplacement d'initialisation de la connexion socket Telnet. Avec une application client enrichi, la connexion socket est initialisée à partir du poste de travail d'un utilisateur et non à partir de WebSphere Application Server, comme c'est le cas avec une application Web HATS. Comme les applications client enrichi requièrent un client sur le poste de travail de l'utilisateur, elles sont essentiellement ciblées pour les utilisateurs internes, habitués à un émulateur de terminal client complet classique.
Les étapes d'élaboration et de test d'une application client enrichi HATS sont quasiment les mêmes que pour une application Web HATS. Vous utilisez HATS Toolkit avec les outils proposés dans la perspective HATS pour développer un projet de client enrichi HATS qui servira ensuite de point de départ pour la génération de l'application client enrichi HATS. Vous disposez des mêmes assistants, éditeurs et vues pour exécuter les activités requises durant le développement. Pour créer des applications ciblées pour Lotus Notes ou Lotus Expeditor Client, Lotus Expeditor Toolkit doit être installé et peut être utilisé pour faciliter leur création.
Comme pour l'environnement Web HATS, vous travaillez sur la présentation et le fonctionnement de l'application, notamment la possibilité de personnaliser les paramètres de rendu par défaut, la navigation entre écrans (à l'aide de macros de saut d'écrans), ainsi que les polices de caractères et couleurs utilisées pour le rendu des écrans.
La majorité des fonctions disponibles dans une application Web HATS sont également proposées dans une application client enrichi HATS. Il s'agit entre autres des fonctions suivantes :
Les fonctions disponibles pour les applications Web HATS qui n'existent pas pour les applications client enrichi HATS sont les suivantes :
Un projet de client enrichi HATS est un projet de module d'extension Eclipse. En tant que projet, il existe dans un espace de travail et est développé par un développeur d'applications HATS. Une fois développé et testé, le projet peut être exporté sous la forme d'une application client enrichi HATS, qui est un module d'extension Eclipse pouvant être installé dans un environnement Eclipse. Un module d'extension Eclipse est un composant proposant un certain type de service dans le contexte d'un environnement Eclipse. Dans le cas de HATS, le module d'extension offre le service requis pour transformer une application hôte.
Chaque module d'extension HATS client enrichi dépend de plusieurs modules d'extension d'exécution. Les dépendances sont référencées dans le fichier de manifeste du projet client enrichi, MANIFEST.MF. Vous devez vous assurer que ces modules d'extension obligatoires sont inclus dans l'environnement de test local et dans l'environnement de production déployé pour que votre module d'extension de HATS client enrichi fonctionne correctement. Pour plus d'informations, voir Projet d'extension d'exécution de la plateforme client enrichi HATS, Test des applications client enrichi HATS et Déploiement d'applications client enrichi HATS.
Lorsque vous créez un projet de client enrichi HATS, vous êtes invité à sélectionner une plateforme cible. Cette sélection indique où vous pensez déployer l'application. Les différences entre un projet ciblé pour le déploiement sur Eclipse RCP, Lotus Notes ou Lotus Expeditor Client sont mineures. Les caractéristiques suivantes sont communes à tous les projets de client enrichi HATS :
Ajout pour les projets dont le déploiement est ciblé sur Eclipse RCP :
Ajouts pour les projets dont le déploiement est ciblé sur Lotus Notes et Lotus Expeditor Client :
L'environnement d'exécution Java (JRE) de votre espace de travail SDP Rational et de votre environnement d'exécution souhaité doivent être les mêmes. Par exemple, si vous développez un module d'extension de HATS client enrichi pour une exécution dans un environnement Eclipse exécutant un JRE (Java Runtime Environment), vous devez définir le niveau de conformité du compilateur de votre espace de travail à 1.6. Pour ce faire, dans la barre de menus Rational SDP, sélectionnez Fenêtre > Préférences > Java > Compilateur et définissez l'option Niveau de conformité du compilateur à la valeur 1.6.
Si vous avez d'autres projets de module d'extension ou Java dans votre espace de travail qui nécessitent d'autres niveaux de conformité, vous pouvez définir le niveau de conformité du compilateur individuellement pour chaque projets de module d'extension ou Java. Pour ce faire, cliquez avec le bouton droit sur le projet, puis sélectionnez Propriétés. Dans le panneau Propriétés, sélectionnez Compilateur Java sur la gauche. Sélectionnez ensuite la case Enable project specific settings et définissez Compiler compliance level sur le niveau approprié.
Lorsque vous créez un projet HATS client enrichi, un projet pour le module d'extension extension d'exécution de la plateforme client enrichi HATS (désormais désigné sous le nom de module d'extension d'exécution) est créé automatiquement s'il n'existe pas déjà dans l'espace de travail. Le module d'extension d'exécution a pour nom et ID com.ibm.hats.rcp.runtime.extension et pout version initiale 1.0.0.
Le module d'extension d'exécution est une extension du module d'extension module d'exécution de la plateforme client enrichi HATS (com.ibm.hats.rcp.runtime). Le module d'exécution de la plateforme client enrichi HATS contient les classes d'exécution HATS et il doit se trouver dans l'environnement pour que les applications client enrichi HATS puissent fonctionner. Le module d'extension d'exécution permet de configurer les paramètres liés à l'environnement d'exécution.
Ce projet de module d'extension contient les artefacts configurables suivants :
Ce projet est identique à un projet HATS EAR dans l'environnement Web, mais il n'existe qu'un module d'extension de ce type par environnement d'exécution. En d'autres termes, un seul module d'extension d'exécution s'exécute dans l'environnement de l'utilisateur. Chaque fichier plugin.xml du projet de client enrichi HATS déclare une dépendance par rapport à ce fichier. Le module d'extension d'exécution ne fait pas référence aux modules d'extension individuels des applications HATS.
Etant donné qu'une seule copie du module d'extension d'exécution peut être lancée dans l'environnement d'exécution, vous devez vous assurer qu'il n'existe qu'une seule copie du module d'extension dans l'environnement de l'utilisateur. S'il existe plusieurs modules d'extension d'exécution dans l'environnement, celui qui possède le niveau de version le plus élevé est utilisé. Ainsi, vous êtes sûr que le code le plus récent est toujours utilisé.
Le projet d'extension d'exécution n'apparaît pas dans la vue Projets HATS, mais il est consultable dans la vue Navigateur. Il est inclus dans la projet généré au moment de l'exportation. Pour plus d'informations, voir Déploiement d'applications client enrichi HATS.
Comme pour un projet Web HATS, lorsque vous créez un nouveau projet HATS client enrichi, un ensemble de dossiers est créé afin de vous aider à organiser les fichiers HATS. Vous trouverez ci-dessous un exemple d'un projet par défaut. Le dossier de plus haut niveau possède le même nom que celui affecté au projet lors de sa création. Ce dossier contient d'autres dossiers de haut niveau qui renferment les objets définis dans le projet HATS. Certains dossiers ne s'affichent qu'à la création de certains objets.

Selon la configuration de votre projet, une partie ou la totalité de ces dossiers peuvent apparaître dans la vue Projets HATS. Vous pouvez aussi indiquer les dossiers qui doivent s'afficher dans la vue Projets HATS ou bien masquer les extensions de fichiers. Pour plus d'informations, voir Préférences HATS.
Vous avez la possibilité de créer des sous-dossiers dans ces dossiers de haut niveau afin d'organiser au mieux votre projet. Par exemple, lorsque vous créez des captures d'écran pour le projet, vous pouvez créer des sous-dossiers dans le dossier Captures d'écran afin d'organiser et de regrouper les écrans capturés. Pour créer un dossier, cliquez à l'aide du bouton droit de la souris sur l'un des dossiers de haut niveau de l'arborescence, puis sélectionnez Nouveau > Dossier. Pour déplacer un fichier vers un autre dossier, cliquez sur ce fichier à l'aide du bouton droit de la souris et sélectionnez Déplacement ou utilisez la méthode de glissement-déplacement.
Il est possible de partager les projets HATS pour une équipe en accédant à la vue du navigateur de votre perspective. Cliquez à l'aide du bouton droit de la souris sur le projet et sélectionnez Team > Share Project. Sélectionnez le type de référentiel dans la liste, puis cliquez sur Suivant. Rational SDP prend en charge plusieurs référentiels. Pour plus d'informations, reportez-vous à la documentation Rational SDP et effectuez une recherche sur repository (référentiel).
Vous pouvez copier, coller, supprimer, déplacer et renommer les ressources client enrichi à l'aide du menu contextuel de la vue Projets HATS. Les ressources suivantes peuvent être copiées ou déplacées entre les projets Web HATS et client enrichi HATS :
Certaines ressources copiées à partir de projets de types différents nécessiteront une modification. Par exemple, une macro copiée à partir d'un projet Web HATS vers un projet de client enrichi HATS devra être mise à jour afin de faire référence à un gestionnaire de macro Java SWT valide (pour les projets HATS, les macros font référence à un gestionnaire de macro JSP). Les personnalisations d'écran devront également être mises à jour à cause des références aux transformations JSP spécifiées dans l'action "appliquer" et des URL spécifiées dans l'action "réacheminer". Un message d'avertissement s'affiche dans la vue Problèmes afin de vous aider à détecter et résoudre ces problèmes. Les scénarios suivants sont repérés :
Il n'existe pas de fonction intégrée permettant de migrer une application Web HATS vers une application plateforme client enrichi HATS. Certains artefacts, tels que les personnalisations d'écran, les macros, les connexions, les captures d'écran, les images, les fichiers source de logique applicative et les fichiers source de composant personnalisé peuvent être migrés manuellement d'un type de projet à un autre sans devoir faire l'objet de modifications importantes. En revanche, d'autres artefacts, tels que les transformations, les objets fenêtre personnalisés, les modèles et les gestionnaires de macro personnalisés, doivent être modifiés de manière plus significative pour pouvoir fonctionner dans un type de projet différent.
Pour déplacer un projet de client enrichi HATS vers un autre système alors que Rational SDP est installé, ou pour enregistrer et restaurer un projet pour un motif quelconque, vous pouvez faire appel aux fonctions d'exportation et d'importation de Rational SDP.
Exportez un projet ainsi que ses projets dépendants sous forme de fichier .zip à l'aide de la fonction Project Interchange de Rational SDP. Cette fonction comporte de nombreux avantages. Elle permet d'exporter simultanément plusieurs projets, y compris le projet d'extension d'exécution requis (com.ibm.hats.rcp.runtime.extension). En outre, il n'est pas nécessaire de créer un projet au niveau de la destination HATS Toolkit avant d'importer le fichier Project Interchange. Pour exporter le ou les projets à partir de HATS Toolkit sous forme de fichier Project Interchange, procédez comme suit :
Pour importer un fichier .zip Project Interchange dans HATS Toolkit :
Pour tester un module d'extension d'application HATS client enrichi dans un environnement de test local, lancez ce module, ainsi que tous les modules d'extension requis dans une instance de la plateforme cible. La plateforme cible fait référence au produit Eclipse (par exemple, Eclipse RCP, Lotus Notes ou Lotus Expeditor Client) sur lequel le module d'extension en cours de développement sera compilé et testé. Pour configurer la plateforme cible, utilisez la boîte de dialogue Fenêtre > Préférences > Plug-in Development > Plateforme cible de Rational SDP.
Pour configurer une plateforme cible Lotus Notes en vue de tests, Lotus Expeditor Toolkit version 6.2.1 ou suivante et Lotus Notes version 8.5.1 ou suivante doivent être installés. Si Lotus Expeditor Toolkit est installé, ainsi que la fonction de configuration de l'environnement de test Lotus Expeditor, la boîte de dialogue de configuration présentée ci-dessous s'affiche lors de la première ouverture de l'espace de travail. Vous pouvez configurer les moments auxquels elle s'ouvre dans les Préférences de configuration de l'environnement de test, affiché ci-dessous. L'Emplacement cible est contenu dans l'emplacement d'installation par défaut de Lotus Notes. Assurez-vous de paramétrer les options Nom VM et Niveau de conformité du compilateur tel qu'indiqué ci-dessous. Si vous sélectionnez l'option Ne jamais afficher, vous pouvez réinitialiser l'option pour afficher cette boîte de dialogue de configuration, en utilisant Fenêtre > Préférences > Services client dans la barre de menus Rational SDP.

Pour configurer une plateforme cible Lotus Expeditor en vue de tests, Lotus Expeditor Toolkit et Lotus Expeditor Client for Desktop doivent être installés et la version de l'un et de l'autre doivent correspondre. Si vous utilisez Lotus Expeditor Client for Desktop version 6.2.0 ou antérieure, DRE (Device Runtime Environment) doit également être installé.
Pour Lotus Expeditor Client, les fonctions suivantes doivent être ajoutées à l'installation par défaut :
Dans le client Lotus Expeditor Client, sélectionnez Fichier > Application > Installer > Rechercher des nouvelles fonctions à installer > Ajouter un emplacement de dossier. Naviguez jusqu'au dossier suivant dans les fichiers du produit Lotus Expeditor Client : desktop\updates\platform, puis sélectionnez Terminer. Développez updates/platform et Development. Cochez Lotus Expeditor Desktop Development Utilities. Développez aussi Runtime Components, puis cochez Service Data Objects (SDO) Components. Cliquez ensuite sur Suivant pour continuer dans l'assistant.
Dans Lotus Expeditor Client version 6.2.0 ou suivante, pour installer la fonction Core JVM - J2SE, dans Lotus Expeditor Client sélectionnez Fichier > Application > Installer > Rechercher des nouvelles fonctions à installer > Ajouter un emplacement de dossier. Naviguez jusqu'à l'emplacement du site Desktop Runtime Environment, à savoir le répertoire update.site.dre.client, puis sélectionnez OK. Acceptez le nom de site par défaut, puis sélectionnez OK et Terminer. Développez le site et Composants d'exécution. Cochez Core JVM Feature - J2SE. Sélectionnez Suivant, puis fermez l'assistant.
Si Lotus Expeditor Toolkit est installé, ainsi que la fonction de configuration de l'environnement de test Lotus Expeditor, la boîte de dialogue de configuration présentée ci-dessous s'affiche lors de la première ouverture de l'espace de travail. Vous pouvez configurer les moments auxquels elle s'ouvre dans les Préférences de configuration de l'environnement de test, affiché ci-dessous. L'Emplacement cible est contenu dans l'emplacement d'installation par défaut de Lotus Expeditor Client for Desktop. Assurez-vous de paramétrer les options Nom VM et Niveau de conformité du compilateur tel qu'indiqué ci-dessous. Si vous sélectionnez l'option Ne jamais afficher, vous pouvez réinitialiser l'option pour afficher cette boîte de dialogue de configuration, en utilisant Fenêtre > Préférences > Services client dans la barre de menus Rational SDP.

En plus du test dans un environnement de test local, vous devez exporter votre projet sous la forme d'une application et la déployer dans un environnement de production afin de tester le processus de déploiement. Pour plus d'informations, voir Déploiement d'applications client enrichi HATS.
Pour que les modules d'extension d'application client enrichi HATS puissent fonctionner dans l'environnement de test local de la plateforme cible, vous devez installer les modules d'extension d'exécution requis sur cette plateforme. Lorsque vous créez un projet et sélectionnez la plateforme cible, ou modifiez par la suite la plateforme cible, HATS Toolkit détecte si les modules d'extension d'exécution requis sont installés au niveau le plus récent sur la plateforme cible sélectionnée. Si ce n'est pas le cas, le toolkit vous invite à procéder à l'installation des modules d'extension d'exécution requis. Vous pouvez activer ou désactiver cette invite dans les préférences de HATS. Voir Préférences HATS pour plus d'informations. Voici les modules d'extension d'exécution requis qui sont installés :
Pour une plateforme cible Lotus Notes, les modules d'extension Eclipse suivants sont également installés :
Après avoir installé les modules d'extension d'exécution de HATS les plus récents sur la plateforme cible, vous devez recharger les nouveaux modules d'extension. Pour ce faire, utilisez la boîte de dialogue Fenêtre > Préférences > Développement de plug-in > Plateforme cible dans Rational SDP, puis cliquez sur Recharger.
Outre la configuration de la plateforme cible et l'installation des modules d'extension d'exécution, vous devrez peut-être définir le JRE par défaut pour votre espace de travail dans Rational SDP.
Lorsque vous effectuez le test sur une plateforme cible Eclipse RCP, définissez le JRE par défaut sur jdk. Pour ce faire, procédez comme suit :
Assurez-vous que vos JRE correspondent. Ainsi, si vous procédez au test dans un environnement Eclipse qui doit exécuter Java 1.6, vous devez mettre à jour le JRE de votre espace de travail pour qu'il corresponde à celui de l'environnement d'exécution.
Lorsque vous effectuez vos tests sur une plateforme cible Lotus Notes, vous avez probablement déjà défini le JRE par défaut pour l'espace de travail à l'aide de la boîte de dialogue de configuration de Lotus Expeditor Toolkit (voir figure 7). Dans le cas contraire, procédez comme suit :
Lorsque vous effectuez vos tests sur une plateforme cible Lotus Expeditor, vous avez probablement déjà défini le JRE par défaut pour l'espace de travail à l'aide de la boîte de dialogue de configuration de Lotus Expeditor Toolkit (voir figure 8). Dans le cas contraire, procédez comme suit :
Une configuration de lancement est nécessaire pour lancer votre projet. HATS créé une configuration de lancement par défaut lorsque vous cliquez sur Exécuter ou Déboguer dans votre projet (voir les instructions dans les sections ci-dessous). Aucune configuration de lancement n'est créé lorsque les boites de dialogue Exécuter ou Déboguer sont ouvertes à partir d'une autre vue, tel que la vue Explorateur de packages, par exemple. La configuration de lancement par défaut est basée sur la plateforme cible du projet, définie dans l'assistant Nouveau projet ou dans l'éditeur des paramètres du projet. Si vous modifiez la configuration de lancement par défaut de sorte qu'elle ne soit plus en mesure de lancer un espace de travail d'exécution, vous pouvez supprimer la configuration de lancement ; elle sera recréée par HATS lorsque vous cliquerez sur Exécuter ou Déboguer de nouveau. Pour lancer votre projet, suivez les instructions relatives à votre plateforme cible indiquées dans les sections ci-dessous.
Pour lancer le projet dans l'environnement de test local pour la plateforme client enrichi Eclipse, procédez comme suit :
Lotus Expeditor Toolkit et Lotus Notes doivent être installés sur le même poste de travail de développement que Rational SDP pour qu'un module d'extension HATS ciblé pour Lotus Notes puisse être testé en local. Pour pouvoir tester votre projet, Lotus Notes ne doit pas être en cours d'exécution, car plusieurs instances de Lotus Notes ne peuvent pas être exécutées simultanément. Voir Configuration de la plateforme cible.
Pour lancer votre projet dans l'environnement de test local de Lotus Notes, procédez comme suit :
Lotus Expeditor Toolkit et Lotus Expeditor Client for Desktop doivent être installés sur le même poste de travail que Rational SDP, pour tester localement un module d'extension HATS ciblé pour Lotus Expeditor. Voir Configuration de la plateforme cible.
Pour lancer votre projet dans l'environnement de test local de Lotus Expeditor Client, procédez comme suit :
Quel que soit le moyen utilisé pour vous procurer le package HATS (CD HATS, Web, ou fourni avec un autre produit), vous installez la même version de HATS Toolkit. Il s'agit d'une version avec utilisation limitée qui vous permet d'évaluer HATS. Pour activer complètement les environnements d'exécution pour la production conformément à votre autorisation d'utilisation du logiciel sous licence, vous devez indiquer vos paramètres de licence dans l'assistant Paramètres de licence de HATS Toolkit. Pour plus d'informations, voir les sections Evaluation de HATS et Activation de l'exécution HATS et de la configuration de la licence, dans Guide d’initiation HATS.
Cette section décrit deux méthodes de déploiement des applications client enrichi HATS. La première permet d'intégrer un environnement client Eclipse complet pour distribution qui comporte tous les éléments nécessaires à l'exécution de votre application client enrichi HATS. La deuxième permet d'intégrer votre application client enrichi HATS pour des clients pour lesquels un environnement Eclipse est déjà installé.
Eclipse SDK, sur lequel repose Rational SDP, permet de générer un client Eclipse complet qui comprend vos modules d'extension d'application HATS et tous les autres modules requis. Ce client peut être réparti sur des systèmes client individuels et s'exécuter en tant qu'applicationautonome.
Pour créer le module client, procédez comme suit :
Un environnement client Eclipse complet est créé. Pour tester votre application, accédez au répertoire c:\hostaccess à l'aide de l'Explorateur Windows®. A partir du dossier Eclipse, cliquez deux fois sur eclipse.exe. Ce répertoire peut être compressé et téléchargé vers des postes client individuels. Ces derniers doivent comporter un environnement JRE (Java Runtime Environment) compatible.
Pour déployer une application client enrichi HATS dans un environnement d'exécution de client Eclipse, procédez comme suit :
Les sections suivantes expliquent comment réaliser chacune de ces tâches.
Pour déployer votre module d'extension d'application client enrichi HATS dans un environnement d'exécution, vous devez d'abord l'intégrer sous forme de fonction Eclipse. Une fonction Eclipse est un artefact de déploiement utilisé pour grouper les modules d'exécution associés. Pour intégrer votre module d'extention en une fonction Eclipse, procédez comme suit.
Si vous n'avez pas spécifié vos paramètres de licence, vous verrez un message indiquant que l'exécution n'est pas activée pour cette application et qu'elle ne peut pas fonctionner dans un environnement de production. Il est possible de tester les applications client enrichi HATS dans un environnement de test local (Eclipse, Lotus Notes, ou Lotus Expeditor Client), mais pas dans un environnement d'exécution (autre qu'un environnement de développement) sans avoir auparavant spécifié les paramètres de licence. En d'autres termes, vous pouvez créer et tester complètement l'application dans l'environnement de développement HATS Toolkit. Vous pouvez également exporter l'application, et il est possible à un utilisateur de l'installer, mais ce dernier ne pourra pas se connecter à l'application. L'exécution est en fait verrouillée et n'autorise aucune connexion. Pour plus d'informations sur la spécification des paramètres de licence, voirActivation de l'exécution HATS et de la configuration de la licence dans HATS - Guide d'initiation. Si vous avez acheté des licences, cliquez sur le bouton Activer l'exécution pour activer l'exécution de votre application. Sinon, cliquez sur Continuer pour poursuivre la procédure d'exportation.
La fonction d'application client enrichi HATS exportée HATS comprend le module d'extension d'exécution et inclut automatiquement une dépendance par rapport aux fonctions d'exécution HATS. Le projet de fonction n'est pas affiché dans la vue Projets HATS, mais dans la vue Navigateur.
Pour procéder à une configuration plus poussée de votre fonction d'application client enrichi HATS, vous pouvez utiliser, à la place de l'assistant de création d'un projet de fonction HATS, l'assistant Nouvelle fonction d'Eclipse standard fourni par Eclipse. Pour lancer cet assistant, dans la barre d'outils Rational SDP, sélectionnez Fichier > Nouveau > Autre > Développement de plug-in > Projet de dispositif. Cet assistant effectue à peu près les mêmes opérations que l'assistant de création d'un projet de fonction HATS mais il n'inclut pas automatiquement le module d'extension d'exécution ni les dépendances requises par rapport aux fonctions de la phase d'exécution de HATS.
Dans un environnement de production, une fonction d'application client enrichi HATS dépend des fonctions de phase d'exécution HATS installées sur le client. Lorsque vous créez une fonction d'application client enrichi HATS à l'aide de l'assistant de création d'un projet de fonction HATS, ce dernier inclut automatiquement une dépendance vers les fonctions d'exécution HATS. Cette dépendance permet d'obtenir que la procédure d'installation et de mise à jour de la fonction déroule automatiquement les fonctions de la phase d'exécution de HATS à partir du site de mise à jour lorsqu'une fonction client enrichi HATS est installée ou mise à jour. Les fonctions de la phase d'exécution de HATS comprennent les fonctions et modules d'extension suivants :
Lorsque la plateforme cible indiquée est Lotus Notes, ajoutez également la fonction Eclipse suivante :
Pour exporter les fonctions de la phase d'exécution de HATS, procédez comme suit :
Après avoir exporté vos fonctions d'application HATS et les fonctions de la phase d'exécution de HATS, vous devez créer un site de mise à jour utilisable par la procédure d'installation et de mise à jour des fonctions pour déployer votre application. Pour créer un site de mise à jour, procédez comme suit :
Lorsque la plateforme cible indiquée est Lotus Notes, ajoutez également la fonction suivante :
Vous venez de créer un site de mise à jour, c:\myHATS dans cet exemple, comprenant le fichier site.xml indiquant les fonctions et versions de ces fonctions qui pourront être téléchargées à partir de ce site par un client. Vous pouvez maintenant déplacer le répertoire de ce site de mise à jour vers un serveur Web auquel les clients pourront accéder. Pour obtenir les instructions de définition d'un site de mise à jour sur le système client et d'installation des applications client enrichi HATS dans un environnement d'exécution, voir Installation de l'application dans un environnement d'exécution.
Vous pouvez exécuter les applications client enrichi HATS dans les environnements Eclipse RCP, Lotus Notes et Lotus Expeditor Client. Les sections ci-après présentent les procédures d'installation d'une applications client enrichi HATS dans chacun de ces environnements.
Pour télécharger et installer votre application client enrichi HATS dans un environnement client enrichi Eclipse, l'environnement client doit contenir la fonction Eclipse EMF Service Data Objects (SDO) et doit être configuré de sorte à accéder au site de mise à jour qui contient l'application. Par défaut, étant donné que l'installation et la mise à jour automatiques sont désactivées, l'utilisateur ou l'administrateur doit installer manuellement les nouvelles fonctions ou mises à jour à l'aide des fonctions standard Eclipse Software Update. Pour ce faire, exécutez les étapes suivantes sur le système client.
Pour plus d'informations sur l'environnement Eclipse RCP, voir http://www.eclipse.org/home/categories/rcp.php.
Dans l'environnement Lotus Notes, les applications fournies en tant que fonctions et modules d'extension sont installées à l'aide d'un objet fenêtre. Par la suite, celui-ci peut être publié dans un catalogue d'objets fenêtre et mis ainsi à la disposition des autres utilisateurs. Pour plus d'informations sur les objets fenêtre, voir la section Widgets and Live Text dans le centre de documentation Lotus Notes à l'adresse http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.notes85.help.doc/wid_app_overview_c.html .
Pour installer une application client enrichi HATS dans un environnement Lotus Notes, procédez comme suit au niveau du système client :


Le panneau de barre de navigation My Widgets se présentera comme suit :

Vous pouvez exécuter votre application en sélectionnant Ouvrir > Host Access. Votre application HATS est répertoriée dans la vue Applications. Pour lancer votre application, cliquez deux fois sur son nom ou cliquez avec le bouton droit et sélectionnez Ouvrir.
Pour désinstaller l'application HATS, cliquez avec le bouton droit sur votre objet fenêtre (par exemple, Objet fenêtre pour l'application des accès HATS) et sélectionnez Supprimer. Redémarrez Lotus Notes lorsque vous y êtes invité.
Dans l'environnement Lotus Expeditor Client, la gestion et le déploiement de l'application peuvent être contrôlés par plusieurs éléments :
Pour Lotus Expeditor Client, les fonctions suivantes doivent être ajoutées à l'installation par défaut :
Dans Lotus Expeditor Client, sélectionnez Fichier > Application > Installer > Rechercher des nouvelles fonctions à installer > Ajouter un emplacement de dossier. Naviguez jusqu'au dossier suivant dans les fichiers du produit Lotus Expeditor Client : desktop\updates\platform, puis sélectionnez Terminer. Développez updates/platform et Development. Cochez Lotus Expeditor Desktop Development Utilities. Développez aussi Runtime Components, puis cochez Service Data Objects (SDO) Components. Cliquez ensuite sur Suivant pour continuer dans l'assistant.
Dans Lotus Expeditor Client version 6.2.0 ou suivante, pour installer la fonction Core JVM - J2SE, dans Lotus Expeditor Client sélectionnez Fichier > Application > Installer > Rechercher des nouvelles fonctions à installer > Ajouter un emplacement de dossier. Naviguez jusqu'à l'emplacement du site Desktop Runtime Environment, à savoir le répertoire update.site.dre.client, puis sélectionnez OK. Acceptez le nom de site par défaut, puis sélectionnez OK et Terminer. Développez le site et Composants d'exécution. Cochez Core JVM Feature - J2SE. Sélectionnez Suivant, puis fermez l'assistant.
Pour plus d'informations, reportez-vous à la section Assembling and Deploying Lotus Expeditor Applications dans le centre de documentation Lotus Expeditor, à l'adresse http://publib.boulder.ibm.com/infocenter/ledoc/v6r1/index.jsp.
Pour installer une application client enrichi HATS dans un environnement Lotus Expeditor Client, vous devez configurer le client de telle sorte qu'il puisse accéder au site de mise à jour contenant l'application. Pour ce faire, exécutez les étapes suivantes sur le système client.
L'environnement de client enrichi permet une mise à jour automatique des applications installées. Des préférences vous permettent de contrôler la fréquence à laquelle le serveur recherche les mises à jour. Une fois que vous avez téléchargé une mise à jour d'une application, le client enrichi télécharge et installe cette mise à jour. Un contrôle de version est effectué pour s'assurer que seules les nouvelles mises à jour sont téléchargées et installées. Dans la plupart des cas, l'utilisateur doit redémarrer l'environnement pour activer l'application mise à jour. Pour plus d'informations, voir la documentation Eclipse RCP, Lotus Notes ou Lotus Expeditor, selon le cas.
Avant de mettre à jour un module d'extension déjà installé, vous devez mettre à jour sa version car c'est à partir de cette dernière qu'Eclipse détermine si un module d'extension a été modifié. Par exemple, si vous ajoutez une personnalisation d'écran ou modifiez une macro dans votre projet, vous devez mettre à jour le numéro de version du module d'extension avant de le réexporter.
Pour mettre à jour la version de votre module d'extension, dans l'éditeur paramètres de votre projet, dans l'onglet Présentation, cliquez sur le lien d'ouverture du manifeste du module d'extension. Dans l'onglet Présentation, sous Informations générales, mettez à jour la version. Une version Eclipse se présente sous la forme majeure.mineure.service. Lorsque vous apportez une modification mineure au projet, mettez à jour le segment service de la version. par exemple, avant d'exporter pour la deuxième fois votre module d'extension, définissez son numéro de version sur 1.0.1.
Comme l'assistant des paramètres de licence met à jour le projet d'extension d'exécution, (com.ibm.hats.rcp.runtime.extension), vous devez mettre à jour la version de ce module d'extension après avoir exécuté cet assistant. Pour ce faire, dans la vue Navigateur, ouvrez le fichier plugin.xml situé à la racine du projet. Dans l'onglet Présentation, sous Informations générales, mettez à jour la version.
Par ailleurs, comme les fonctions sont constituées de modules d'extension (et qu'elles possèdent également des versions), vous devez mettre à jour la version de votre fonction à chaque fois que vous mettez à jour la version de l'un des modules d'extension inclus. Pour ce faire, passez dans la vue Navigateur et ouvrez le fichier feature.xml située dans votre projet de fonction. Par défaut, le nom du projet de fonction est hostaccess. Dans l'onglet Présentation, sous Informations générales, mettez à jour la version. De plus, vérifiez également que la fonction répertorie correctement les nouvelles versions des modules d'exécution en cliquant sur le bouton Versions dans l'onglet Plug-ins et en sélectionnant Copier les versions des manifestes de plug-in et de fragment.
Une fois que la version de la fonction a été mise à jour, devez mettre à jour le fichier site.xml (le cas échéant) afin de vous assurer qu'il mentionne la nouvelle version de la fonction.
Pour les applications client enrichi HATS, les paramètres d'exécution, tels que les paramètres de journalisation et de trace, sont indiqués dans deux fichiers dans le module d'extensionextension d'exécution (com.ibm.hats.rcp.runtime.extension) :
Pour plus d'informations sur les différents modes de test, voir Modes de test des projets client enrichi dans le Guide d'initiation HATS.
Dans HATS Toolkit, vous pouvez éditer ces fichiers afin de modifier des paramètres, tels que les paramètres de trace et de niveau de trace. Les fichiers se trouvent à la racine du projet de module d'extension d'exécution. Sachez que les modifications apportées au fichier runtime.properties dans HATS Toolkit sont conservées et appliquées lors du déploiement de l'application dans un environnement d'exécution. Dans l'environnement d'exécution, le fichier runtime.properties se trouve dans le répertoire du module d'extension d'exécution, par exemple <eclipse_install_dir>/eclipse/plugins/com.ibm.hats.rcp.runtime.extension_1.0.0. Le fichier runtime-debug.properties est ignoré dans l'environnement d'exécution. Pour plus d'informations sur les paramètres de journalisation et de trace contenus dans ces fichiers, voir Annexe A. Fichiers des propriétés d'exécution.
Pour savoir comment l'utilisateur peut configurer les paramètres de journalisation et de trace et collecter des données de résolution d'incidents dans l'environnement d'exécution, voir Préférences.
Il n'y a qu'un seul projet de module d'extension d'exécution dans l'espace de travail et qu'une seule version du module d'extension dans l'environnement d'exécution. Toutefois, dans chaque environnement d'exécution client enrichi HATS, les paramètres de journalisation et de trace sont identiques pour toutes les applications client enrichi HATS.
Les paramètres de configuration de la licence sont également stockés dans le fichier runtime.properties du module d'extension d'exécution (com.ibm.hats.rcp.runtime.extension). Le suivi des licences est effectué au niveau de l'environnement client enrichi et non au niveau de l'application client enrichi HATS individuelle. Des messages d'avertissement s'affichent dans le journal si l'utilisateur dépasse le nombre de licences achetées. Pour plus d'informations sur la spécification des paramètres de licence, voir Activation de l'exécution HATS et de la configuration de la licence dans HATS - Guide d'initiation
La vue Applications affiche à l'intention de l'utilisateur toutes les applications client enrichi HATS actives installées dans l'environnement d'exécution. La vue est triée sur les noms d'application affichés. Par défaut, cette vue s'affiche lorsqu'un utilisateur ouvre pour la première fois la perspective Host Access. L'utilisateur démarre une nouvelle instance d'une application HATS en cliquant deux fois sur l'application dans la vue Applications ou en cliquant avec le bouton droit sur le nom de l'application, puis en sélectionnant Ouvrir.
Une fois qu'une nouvelle instance de l'application HATS a été lancée, la vue de transformation correspondante s'affiche. Pour plus d'informations, voir Vue Transformation. Par défaut, le nom de la nouvelle vue transformation ouverte est celui de l'application. Si plusieurs instances de l'application sont démarrées, le nom de la vue transformation combine le nom de l'application plus un nombre indiquant le numéro de l'instance dans la session. Par exemple, le titre de la seconde instance de l'application nommée Saisie des commande sera Saisie des commandes : 2.
Par défaut, un utilisateur est autorisé à lancer plusieurs instances de la même application. Vous pouvez modifier le fichier plugin.xml afin d'interdire le lancement de plusieurs instances. En outre, vous pouvez décider de ne pas afficher la vue Applications et de choisir à la place les vues qui seront proposées à l'utilisateur. Cette procédure permet également de limiter le nombre d'instances d'une application. Pour plus d'informations, voir HATS Rich Client Platform Programmer's Guide.
Si l'application est exécutée dans l'environnement de test local et que vous avez choisi de voir le terminal d'affichage, une fenêtre de terminal d'affichage sera également affichée une fois la connexion établie avec le système. La fenêtre sera refermée à la fin de la session ou si le client est arrêté.
Un menu contextuel est fourni pour permettre à l'utilisateur d'exécuter des actions sur une ou plusieurs applications de la vue. Sélectionnez un ou plusieurs noms d'application, puis cliquez avec le bouton droit de la souris pour afficher le menu. Les options suivantes sont disponibles :
Si vous autorisez les modifications, cette page permet à l'utilisateur de modifier les paramètres de connexion. Cette fonction est équivalente à celle de la fonction HATS pour les applications Web, qui permet à un utilisateur de modifier les paramètres de connexion au moyen de l'URL lorsque l'utilisateur accède pour la première fois à l'application. l'utilisateur peut par exemple être amené à modifier les paramètres de connexion s'il doit modifier le nom de LU ou l'ID d'un poste de travail.
Pour procéder à la modification, l'utilisateur doit cliquer sur le bouton Ajouter, sélectionner un paramètre dans la liste déroulante pour la zone Nom et spécifier une valeur dans la zone Valeur. Aucune validation n'est effectuée dans la boîte de dialogue pour indiquer à l'utilisateur si le nom du paramètre de connexion fourni peut être modifié. Par défaut, le paramètre peut être modifié lorsqu'il est ajouté à l'origine. Cette possibilité peut être désactivée en désélectionnant la case en regard du nom du paramètre.
Si un utilisateur modifie un paramètre de connexion, les paramètres sont enregistrés dans l'espace de travail local. Les valeurs de paramètre remplacées sont utilisées lorsqu'une instance de la session est démarrée.
Pour obtenir des informations sur le lancement par programme d'une instance d'application client enrichi par le biais de remplacement de paramètres de connexion, voir HATS Rich Client Platform Programmer's Guide.
Si vous autorisez les modifications, cette page permet à l'utilisateur de modifier les variables globales. Cette fonction est équivalente à celle de la fonction HATS pour les applications Web, qui permet à un utilisateur de modifier les variables globales au moyen de l'URL lorsque l'utilisateur accède pour la première fois à l'application.
Cette possibilité permet d'utiliser dans l'application des données variables spécifiques à l'utilisateur. Par exemple, vous pouvez enregistrer une macro invitant l'utilisateur à fournir un nom et un mot de passe parmi les valeurs de variables globales. L'utilisateur peut fournir ces valeurs dans la page de modification des variables. Ces valeurs sont alors utilisées lorsque la macro est exécutée lorsque l'écran de connexion est reconnu.
Pour procéder à un remplacement, l'utilisateur doit cliquer sur le bouton Ajouter, sélectionner un nom de variable dans la liste déroulante pour la zone Nom, spécifier une valeur dans la zone Valeur et indiquer si la variable globale est partagée. Aucune validation n'est effectuée dans la boîte de dialogue pour indiquer à l'utilisateur si le nom de variable globale fourni peut être modifié. Par défaut, le paramètre peut être modifié lorsqu'il est ajouté à l'origine. Cette possibilité peut être désactivée en désélectionnant la case en regard du nom de la variable.
Lorsque l'utilisateur remplace une variable globale, les paramètres sont enregistrés dans le répertoire de données de l'environnement. Les valeurs des variables globales modifiées sont utilisées lorsqu'une instance de session est lancée.
Pour obtenir des informations sur le lancement par programme d'une instance d'application client enrichi par le biais de remplacements de variable globale, voir le manuel HATS Rich Client Platform Programmer's Guide.
Dans l'environnement client enrichi, l'utilisateur a la possibilité d'imprimer la transformation d'écran en cours en sélectionnantImprimer dans le menu Fichier. Par défaut, Eclipse affiche la boîte de dialogue d'impression qui permet à l'utilisateur de sélectionner l'imprimante et de configurer certaines options. Lorsque l'utilisateur clique sur OK, la zone de transformation de la vue transformation est envoyée à l'imprimante sélectionnée.
La vue transformation est la principale zone de transformation dans l'environnement client enrichi. Chaque projet de client enrichi HATS est associé à une vue transformation. La vue est enregistrée dans le fichier plugin.xml du projet au moment de la création du projet. Elle est composée de quatre zones :
La barre d'outils de la vue transformation contient les boutons correspondant aux actions applicables au niveau de l'application, ainsi que les boutons fournis par l'objet fenêtre Barre d'outils lors du rendu d'écran. Par défaut, la barre d'outils est affichée et les légendes des boutons ne comportent que du texte. Vous pouvez modifier ces paramètres dans les paramètres du projet. Pour plus d'informations, voir Barre d'outils plateforme client enrichi uniquement .
La barre d'outils est divisée en deux sections. La partie droite de la barre d'outils correspond au bloc de touches application dans une application Web HATS et contient les boutons du bloc de touches application. Pour savoir comment configurer l'affichage des boutons, voir Bloc de touches application. La partie gauche affiche les boutons fournis par l'objet fenêtre Barre d'outils. Pour plus d'informations, voir Barre d'outils plateforme client enrichi uniquement .
Une info-bulle fournissant une description de la fonction du bouton est disponible pour tous les boutons du bloc de touches application. Vous pouvez définir le texte de l'info-bulle pour les boutons que vous ajoutez à l'aide de l'objet fenêtre Barre d'outils.
Au-dessus des boutons du bloc de touches application dans la barre d'outils, à côté des icônes de réduction et d'agrandissement, se trouve une icône Menu. Cliquez sur cette icône pour afficher un menu proposant les options suivantes :
La zone de modèle et de transformation est la partie principale de la vue transformation, dans laquelle s'affichent toutes les transformations d'écran. C'est également là que s'affichent les messages d'erreur, les messages de déconnexion, ainsi que les panneaux du gestionnaire de macro.
Le bloc de touches hôte affiche les touches hôte que vous choisissez d'afficher dans les paramètres du projet. Pour savoir comment configurer le bloc de touches hôte, voir Bloc de touches hôte. Par défaut, le bloc de touches hôte n'est pas affiché.
La zone d'informations opérateur affiche des informations relatives à l'état de la session que vous configurez dans les paramètres du projet. Pour savoir comment configurer la zone d'informations opérateur, voir Zone d'informations opérateur.
La connexion avec le système hôte est interrompue lorsque la vue est fermée. Cette situation se produit lorsque l'utilisateur ferme explicitement la vue ou l'environnement client enrichi. A la fermeture, les actions configurées en tant qu'événements de déconnexion et d'arrêt sont exécutées.
Après avoir créé ou modifié une connexion hôte, vous pouvez spécifier que l'utilisateur doit être invité à entrer un ID de poste de travail pour la connexion à un hôte 5250. Pour plus d'informations, voir Création d'une connexion. Si vous configurez une invite d'entrée de l'ID du poste de travail, une boîte de dialogue invite l'utilisateur à saisir cet ID lorsqu'il établit la connexion avec l'hôte pour la première fois. L'utilisateur peut alors saisir l'ID du poste de travail dans la zone ID poste de travail.
Une case à cocher permet de demander la mémorisation de l'ID du poste de travail pour éviter de le saisir à nouveau par la suite. Si cette case est cochée, il est possible de restaurer ultérieurement l'affichage de la boîte de dialogue d'invite en désactivant la modification du paramètre de connexion workstationID dans les propriétés de l'application. Pour plus d'informations, voir Paramètres de connexion.
Après avoir créé ou modifié une connexion hôte, vous pouvez spécifier que l'utilisateur doit être invité à entrer un nom de LU pour la connexion à un hôte 3270E. Pour plus d'informations, voir Création d'une connexion. Si vous configurez une invite d'entrée du nom de LU, une boîte de dialogue invite l'utilisateur à saisir ce nom lorsqu'il établit la connexion avec l'hôte pour la première fois. L'utilisateur doit alors indiquer le nom de LU dans la zone Nom de LU.
Une case à cocher permet de demander la mémorisation du nom de LU pour éviter de le saisir à nouveau par la suite. Si cette case est cochée, il est possible de restaurer ultérieurement l'affichage de la boîte de dialogue d'invite en désactivant la modification du paramètre de connexion LUName dans les propriétés de l'application. Pour plus d'informations, voir Paramètres de connexion.
Par défaut, les utilisateurs peuvent accéder aux préférences en sélectionnant Fichier > Préférences > Host Access dans la barre de menus de la plateforme d'exécution. Les pages affichées sont enregistrées dans le module d'extension d'exécution. Si vous ne voulez pas offrir ces fonctions à l'utilisateur, vous pouvez supprimer les déclarations applicables du fichier plugin.xml du module d'extension d'exécution. Pour plus d'informations sur cette procédure, voir la description de l'ID du point d'extension org.eclipse.ui.preferencePages dans la section Module d'extension d'exécution HATS du manuel HATS Rich Client Platform Programmer's Guide. Les paramètres de préférences suivants peuvent être sélectionnés :
Les préférences d'impression suivantes peuvent être définies par l'utilisateur pour les applications prenant en charge l'impression 3270 :
Un message indique à l'utilisateur que le travail d'impression a démarré.
Le message, le travail d'impression {0} est terminé., s'affiche. {0} correspond au nom du travail d'impression.
Le message, Le travail d'impression {0} a rencontré une erreur, s'affiche. {0} correspond au nom du travail d'impression.
Les préférences de résolution d'incidents ci-dessous peuvent être définies par l'utilisateur. Pour plus d'informations sur les paramètres de journalisation et de trace, voir Administration des applications client enrichi HATS.
Le fichier de trace est enregistré dans le dossier des simulations hôte dans l'environnement client enrichi. Par exemple, dans l'environnement plateforme client enrichi sous Windows, il est enregistré dans le <répertoire d'installation d'Eclipse>\plugins\<version_NomApplication>\profiles\hostsimulations\. Dans l'environnement Lotus Notes sous Windows, il est enregistré dans <répertoire d'installation Lotus Notes >\Data\workspace\applications\eclipse\plugins\<NomApplication_version>\profiles\hostsimulations\. Dans l'environnement Lotus Expeditor Client sous Windows, il est enregistré dans <répertoire d'installation Lotus Expeditor Client>\shared\eclipse\plugins\<NomApplication_version>\profiles\hostsimulations\. Dans l'environnement Lotus Expeditor Client sous Linux, il est enregistré dans /opt/IBM/Lotus/Expeditor/shared/eclipse/plugins/<ApplicationName_version>/profiles/hostsimulations/.
Les noms des fichiers de trace suivent le modèle suivant : NomApplication_NomConnexion_Date(aaaammjj)_Heure(hhmmss)_Numéro, par exemple, MonApplication_principal_20060101_134543_1.
Lorsque vous utilisez des applications client enrichi HATS, tenez compte des considérations et des restrictions suivantes :
Il s'agit d'un problème connu décrit dans Bug 100144: Need a pattern for cleaning up font/image/color resources à l'adresse https://bugs.eclipse.org/bugs/show_bug.cgi?id=100144. A cause de ce problème, vous devez ajouter manuellement la logique de nettoyage si vous ajoutez une police, une image ou des ressources de couleur aux modèles et transformations client enrichi HATS. Il est inutile d'ajouter la logique de nettoyage si vous ajoutez une couleur système, qui est allouée par le système.
Par exemple, si vous ajoutez une nouvelle ressource de couleur à l'aide de Visual Editor et que le code suivant est généré :
sideBarArea.setBackground(new Color(Display.getCurrent(), 221, 228, 255));
vous devez ajouter manuellement les lignes de code suivantes pour nettoyer la couleur lorsque l'objet fenêtre est éliminé :
sideBarArea.addDisposeListener(new DisposeListener(){
public void widgetDisposed(DisposeEvent e){
Color background = sideBarArea.getBackground();
if (background != null && !background.isDisposed()) {
background.dispose();
}
}
});
Si vous utilisez la classe ColorManager fournie par HATS, il n'est pas nécessaire de nettoyer les ressources de couleur. Vous devez cependant écrire le code en utilisant l'éditeur Java plutôt que l'éditeur de propriétés fourni par Visual Editor. Voici un exemple de code exemple utilisant ColorManager :
sideBarArea.setBackground(com.ibm.hats.rcp.ui.misc.ColorManager.
getInstance(Display.getCurrent()).getColor(221, 228, 255));
Autre exemple, si vous ajoutez manuellement une image à un modèle à l'aide de Visual Editor, le code d'ajout d'image et de nettoyage de la ressource image pourrait se présenter ainsi :
label = new Label(bannerArea, SWT.RIGHT);
gridData = new GridData(SWT.END, SWT.CENTER, true, true);
label.setImage(new Image(Display.getCurrent(),
getClass().getResourceAsStream("/images/myimage.gif")));
label.setLayoutData(gridData);
label.addDisposeListener(new DisposeListener() {
public void widgetDisposed(DisposeEvent e){
Image image = label.getImage();
if (image != null && !image.isDisposed()) {
image.dispose();
}
}
});