vendredi, octobre 30, 2009

Liens pratiques de la semaine

Vous trouverez ici une sélection de liens pratiques autour des technologies Java qui m'ont particulièrement intéressées ces dernières semaines.

Eclipse
  • Eclipse e4 1.0 Millestone 1 est sortie. La grande nouveauté est l'introduction d'un débugger JavaScript via l'utilisation de Mozilla Rhino. Page des nouveautés et page de téléchargement.
  • Un exemple de Lars Vogel qui montre comment utiliser l'API d'accès aux dépendances de plugin.
  • Angelo Zerr continue ses articles sur la création d'une application Eclipse RCP qui communique avec un serveur OSGi basé sur Spring DM. Quatre nouveaux billets sont disponibles billet 3, billet 4, billet 5 et billet 6. Merci à Angelo pour ces ressources de très bonnes qualités.
Java
  • La société Jetbrains fournit en Open Source son environnement de développement IntelliJ IDEA. J'ai testé cette version et malheureusement les choses qui m'intéressent ne sont pas incluses dans la version Open Source, il faut passer par la version payante ...

J'ai besoin de ... cacher ou afficher des commandes en fonction de la perspective courante

Actuellement je suis en train de rédiger un support de cours autour de la nouvelle API Commands et le moins que l'on puisse dire : enfin ...

Avant, pour enrichir un menu, une barre d'outils ou un menu contextuel, il fallait passer par l'API Actions. C'était assez galère et la plupart du temps tout se faisait de manière "programmatique". L'API Commands permet d'étendre les menus et les barres d'outils de manière déclarative en se focalisant principalement sur la déclaration via la construction d'extensions. Il se peut qu'il y ait encore des classes à créer mais cela s'est sensiblement réduit.

Ce billet présente un exemple d'utilisation de cette nouvelle API. L'exemple consiste à cacher des commandes selon la perspective active. Les points pédagogiques de ce billet sont
  • Réutiliser des commandes définies par la plateforme Eclipse
  • Utiliser des Command Core Expressions
  • Ajouter une commande au menu d'une application Eclipse de manière déclarative
  • Ajouter une commande au menu et à la barre d'outils d'une vue de manière déclarative
Réutilisation de commandes prédéfinis

J'utiliserai des commandes et des handlers prédéfinis par la plateforme Eclipse. Ces commandes se focalisent essentiellement sur la manipulation de perspectives. Vous trouverez ci-dessous les commandes que je souhaite employer et leurs identifiants respectifs :
  • org.eclipse.ui.window.closeAllPerspectives : ferme toutes les perspectives
  • org.eclipse.ui.window.closePerspective : ferme la perspective courante
  • org.eclipse.ui.window.nextPerspective : active la perspective suivante
  • org.eclipse.ui.window.previousPerspective : active la perspective précédente
  • org.eclipse.ui.window.savePerspective : sauvegarder la perspective courante
  • org.eclipse.ui.window.customizePerspective : modifier la perspective courante
  • org.eclipse.ui.perspectives.showPerspective : affiche une perspective
Création d'éléments menuContribution

La création d'un élément menuContribution va nous permettre d'enrichir une barre de menu, une barre d'outils, une barre de menu d'une vue, une barre d'outils d'une vue ou d'un menu contextuel.

Dans ce billet, j'ai m'attarder à enrichir une barre de menu principale et celle d'une vue puis une barre d'outils d'une vue.

Il faut créer une extension basée sur le point d'extension org.eclipse.ui.menus comme indiqué sur la figure ci-dessous.


Ajoutez ensuite un élément menuContribution et créez un sous élément de type menu. Puis, au niveau de l'élément menuContribution modifiez l'attribut locationURI avec la valeur menu:org.eclipse.ui.main.menu, ceci permettra d'enrichir le menu principal de l'application Eclipse.


Au niveau de l'attribut de l'élément menu, modifiez l'attribut label qui est le nom du menu affiché dans la barre de menu principal par la valeur Perspective Commands.


J'ajoute ensuite à l'élément menu plusieurs sous éléments de type command. De cette façon, je regroupe dans le menu Perspective Commands cinq commandes prédéfinies par la plateforme Eclipse. Pour chaque élément command, je modifie l'attribut commandId qui désigne l'identifiant de la commande. Pour éviter toutes erreurs, j'utilise le bouton Browse et je recherche l'identifiant de la commande qui m'intéresse. Sur la capture d'écran ci-dessous, je présente l'élément command (sous élément de menu) associé à la commande org.eclipse.ui.window.closeAllPerspectives.


Concernant l'enrichissement de la barre d'outils d'une vue le procédé reste le même. Ajoutez un élément menuContribution puis un sous élément command. Dans l'attribut locationURI indiquez cette fois toolbar:eclipse.workbench.commandsperspectiveexample.commandsviewsampleid dont le suffixe désigne l'identifiant de la vue cible.


Pour l'élément command, je renseigne l'attribut commandId par la valeur org.eclipse.ui.window.customizePerspective qui permet d'appeler la commande en charge de modifier le contenu d'une perspective.

Finalement pour l'enrichissement de la barre de menu de la vue, procédez de la même façon. Par contre la valeur de l'attribut locationURI est menu:eclipse.workbench.commandsperspectiveexample.commandsviewsampleid et la valeur de l'attribut commandId est org.eclipse.ui.perspectives.showPerspective.

Avant de continuer, testons le résultat attendu. Vous devriez obtenir ceci :


Création d'une restriction visibleWhen

Attardons-nous maintenant à ajouter une restriction de type visibleWhen sur un élément du menu que nous avons créé (notamment nous désirons cacher l'élément Fermer toutes les perspectives).

La restriction visibleWhen appliquée à un élément menuContribution consiste à cacher un élément graphique (élément de menu ou de barre d'outils) lorsque l'expression associée à la restriction est évaluée comme fausse.

L'expression que nous allons exprimer consiste à afficher la-dite commande si la perspective active est égale à MyEmptyPerspective. Cette dernière est une perspective que nous allons créer.

Pour commencer, sélectionnez la commande Fermer toutes les perspectives.


Ajoutez un sous élément visibleWhen


Ajoutez un sous élément with et précisez dans l'attribut variable la valeur activeWorkbenchWindow.activePerspective. Ceci permet de récupérer le contenu de cette variable.


Enfin ajoutez un sous élément equals et précisez dans l'attribut value la valeur MyEmptyPerspective.


Lors du test, la commande Fermer toutes les perspectives localisée dans le menu PerspectiveCommands ne doit pas être affichée. Par contre, si vous créez une nouvelle perspective (en utilisant la commande Save Perspective As ...) et en l'appelant MyEmptyPerspective puis en l'activant cette commande devrait être disponible.

Le mot de la fin ...

L'API Commands facilite l'enrichissement de la barre de menu, barre d'outils, etc. Dans un prochain billet, je vous montrerai comment utiliser et créer un Property Tester.

Le code source de cet exemple est disponible ici.

lundi, octobre 12, 2009

Atelier Construction Plug-in avec la plateforme Eclipse sur Developpez.com

Les leçons tirées de l'atelier Construction Plug-in avec la plateforme Eclipse sont disponibles sous le format Developpez.com.

Pour l'instant, la première et la deuxième leçons sont uniquement disponibles. Les autres viendront quand j'aurai effectué le passage dans le format.

Leçon 1 : Construction d'un Plug-in
Leçon 2 : Perspectives

mercredi, octobre 07, 2009

Atelier Construction Plug-in avec la plateforme Eclipse : leçon 2 / Perspectives

Je continue la diffusion des supports concernant l'atelier Construction Plug-in avec la plateforme Eclipse (précédent billet).

Vous trouverez donc dans ce billet, les supports de la leçon 2.
Les autres leçons devraient être disponibles très prochainement.

Liens pratiques de la semaine

Vous trouverez ici une sélection de liens pratiques autour des technologies Java qui m'ont particulièrement intéressées ces dernières semaines.

Eclipse
  • Angelo Zerr se lance dans une nouvelle série de billets consacrée à la création d'une application Eclipse RCP qui communique avec un serveur OSGi basé sur Spring DM. L'idée derrière le développement de cette application est de monter en compétence sur les technologies utilisées. A ce jour, deux billets sont disponibles : billet 1 et billet 2.
  • Eclipse 3.6 Helios M2 est sortie (page de téléchargement et page présentant les nouveautés).
  • Une nouvelle version pour Galileo est disponible 3.5.1. Elle apporte son lot de correctifs.
Java
  • Un projet Open Source a pour ambition de traduire l'intégralité du livre Maven: The Definitive Guide fournit par Sonatype. Vous pouvez participer à la traduction via le site du projet (source Xebia).
  • Deux tutoriels fournis par IBM consacrés à la construction de Web Services en limitant l'utilisation de Wizards, cela a comme avantage de pouvoir comprendre les étapes nécessaires au développement d'un Web Service (tutoriel 1 et tutoriel 2).