Génération de classes AS3 depuis Java pour Flex

Posted on 02. juil, 2009 by admin.

Une des tâches les plus ingrate mais nécessaire lorsqu’on écrit une application Flex/Java communiquant en RemoteObject, c’est d’écrire les classes AS3 correspondant aux classes Java.
Cela est nécessaire pour que le mécanisme de mapping automatique de Flex fonctionne, mais c’est fastidieux et nécessite une synchronisation permanente.
Heureusement, il existe un certain nombre d’outil de génération automatique. J’en ai découvert un récemment (merci Adrien) qui m’a semblé particulièrement intéressant.

Je vous propose de vous le présenter rapidement (d’après le doc d’installation fournie).

Installation

Récupérer la doc ici ainsi que les jars nécessaires : plugin et annotations .

Jar du plugin:
Ajouter le jar du plugin dans le répertoire plugins de votre Eclipse.

Jar des annotations:
Créer un projet Flex/Java en comme d’habitude, puis faites un clic-droit sur le projet pour ouvrir ses propriétés. Sélectionnez l’élément “Java Build Path” sur la gauche pour pouvoir ajouter le .jar (utilisez le bouton “Add External Jar…”)

Configuration

Nous allons maintenant donnez quelques informations à cet utilitaire pour qu’il sache où générer les classes AS3.

Encore dans cette boîte de dialogue, allez dans Java Compiler->Annotation Processing->Factory Path, pour y cocher la case “Enable project specific settings” puis cliquez sur le bouton Apply.

Toujours dans cette même boîte de dialogue, revenez sur le menu parent (Annotation Processing) pour y ajouter une nouvelle option pour cette annotation.
Cliquez sur le bouton New…
Dans le champ key entrez l’information suivante:
-Acom.faratasystems.dto2fx.output
Dans le champ value entrez indiquez le chemin du répertoire source de où devront être générés vos classes AS3.

Note: C’est ce qu’indique la doc de configuration pour une application Java classique. Pour une application Web, j’ai du ajouter (glisser/déposer) le jar d’annotation dans le répertoire WebContent/WEB-INF/lib pour qu’il soit pris en compte.

Ouf! c’est fini pour la configuration, on va pouvoir coder.

Utilisation de l’outil

Dans le répertoire des sources Java, créer un package vo, puis dedans une classe User avec les propriétés username et password.
Générez les getters/setters.

Au dessus de la classe, ajoutez l’annotation @FXClass ou @FXClass(”<package.classe.flex.NomClasseAS3>”). Sauvegardez pour lancez la compilation et la génération des classes AS3.

package vo;
import com.farata.dto2fx.annotations.FXClass;
//pour générer une classe AS3 du même nom, dans le même package
//il suffit de mettre @FXClass
@FXClass("dto.UserVO")
public class User 
{
	protected String _username;
	protected String _password;
 
	public String getUsername() {
		return _username;
	}
	public void setUsername(String username) {
		_username = username;
	}
	public String getPassword() {
		return _password;
	}
	public void setPassword(String password) {
		_password = password;
	}
}

Faites un refresh du projet pour voir apparaître les classes dans le répertoire des sources flex.

Deux classes AS3 sont générées pour chaque classe Java : _ClasseAS3.as et ClasseAS3.as (qui hérite de _ClasseAS3.as)
Ne modifier sous aucun prétexte la classe _ClasseAS3. Le générateur de code l’écrase à chaque modification de la classe Java.
Par contre vous pouvez modifier la classe ClasseAS3.as

Il existe une annotation @FXIgnore que l’on peut positionner sur les méthodes Java afin qu’elles ne soient pas générées.
Par exemple, un @FXIgnore sur un setter, entrainera la génération d’un accesseur get (et uniquement) côté AS3, pour protéger la classe AS3 contre l’écriture.

Conclusion

Cet utilitaire de génération de classe AS3 m’a paru très pratique car bien intégré à Eclipse. Du coup, une fois sa configuration effectuée, il travaille pour nous de façon quasi transparente.

Dites-moi ce que vous en pensez et si vous connaissez d’autres outils de génération intéressant.

Continue Reading

Flex3 (plug-in) et Tomcat 6 avec Europa pour Mac

Posted on 03. jan, 2008 by olivier.

Afin de pouvoir travailler tranquillement, installons proprement et professionnellement Flex 3

Préambule : On peut installer Flex 2 et Flex 3 en même temps sur la même machine. Il faut toutefois faire
attention à 2 points :

• Il ne faut pas installer le plugin de Flex 3 dans le même Eclipse que celui de Flex 2 ;
• On ne peut pas mettre un projet Flex 2 et un projet Flex 3 dans le même Workspace.

Cette installation permet de travailler directement avec l’eclipse standard qu’on a l’habitude d’utiliser (attention version 3.3 au moins) et donc de profiter de nos plugins préférés. Pour cette installation nous utilisons donc FlexBuilder 3 sous forme de plugin et non pas Flexbuilder 3 avec son Eclipse
packagé (version appelée standalone par Adobe).

Afin de pouvoir tester des applications Flex dans le monde Java, je vais aussi installer Tomcat
et tout ce qu’il faut pour développer dans Tomcat avec Eclipse et FlexBuilder.

Dernière chose, nous avons essayé de prendre les dernières versions pour tous les environnements

Eclipse 3.3 EE, nom de code Europa (contient les Webtools)

Note : pour ceux qui ont déjà un eclipse standard (pas EE) sur leur machine, il est préférable d’installer les WebTools pour réaliser des projets Flex Java (voir l’installation sur eclipse.org)

Url de téléchargement : IDE éclipse J2EE

Installation : L’installeur d’éclipse est en fait un zip. Installer, c’est donc dézipper.
Je vous propose de dézipper dans /Applications. J’ai renommé le répertoire principal d’eclipse en Europa pour ne pas confondre
avec mes versions précédentes.
J’ai de plus changé le fichier eclipse.ini. Faites-en d’abord une sauvegarde et remplacez son contenu par :

-vmargs
-Xms128m
-Xmx512m
-XX:MaxPermSize=256m
-XX:PermSize=64m
-Djava.net.preferIPv4Stack=true

Ce sont les paramètres de l’installation standalone de FB3. Sans eux, la création de projets de type J2EE plante… Si vous
avez la chance d’avoir 2 Go de RAM, vous pouvez pousser -Xmx512m à -Xmx1024m.

Remarques : prenez bien la version EE (Enterprise Edition) qui contient en particulier les Webtools
qui permettent de gérer Tomcat en développement.

Flexbuilder 3 plugin

Url de téléchargement : Flex Builder 3 Plugin

Installation :

• Vous remarquerez que l’installeur propose le choix d’une langue au début. Bon ya que l’anglais pour l’instant mais peut-être
  une version française bientôt disponible ?
• Acceptez la licence : 60 jours de démo…
• J’ai installé le plugin dans l’endoit par défaut : /Applications.

(Note : Contrairement à de nombreux plugins Eclipse, FlexBuilder installe d’abord tous ses fichiers dans un
répertoire à lui et dans un deuxième temps l’installeur fait le lien entre éclipse et son répertoire
d’installation)

• Le répertoire où vous avez installé éclipse précédemment. Moi c’est /Applications/Europa (cf point 2-)
• J’ai installé les players proposés mais pas les extensions pour Coldfusion ni le plugin JSEclipse

Laissez mijoter quelques minutes et voilà, c’est prêt

Remarques : Pour tester rapidement si tout fonctionne, lancez /Applications/Europa/Eclipse.app (Je l’ai mis dans mon dock). Sélectionnez un Workspace (un répertoire de travail où vous mettrez les ressources
des projets). Mon expérience m’a conduit à créer un répertoires WorkSpaces dans lequel je mets tous mes WorkSpace.

Ici j’ai par exemple créé un répertoire WEuropaTest dans WorkSpaces.
Après la page de bienvenue, vous arrivez normalement dans la perspective J2EE (perspective par défaut d’Europa EE)

Ajouter la perspective Flex (Menu Window/OpenPerspective/Other… = Flex development). Dans cette perspective, créez un nouveau projet Flex
(Menu File/New/Flex Project - Project Name : Test - Finish). Ajoutez un Label à l’application. Testez (Dans Flex Navigator, click droit sur Test.mxml -
Run as/Flex Application). Bienvenue dans Flex 3 !

Tomcat 6

Note : Si vous avez déjà un Tomcat 5.5 d’installé vous pouvez l’utiliser

Url de téléchargement : serveur tomcat (prendre la version core .zip)

Installation : dézipper l’archive, et glisser le répertoire créé (apache-tomcat-6.0.14) là où vous le souhaiter (/Applications pour moi)

remarque : pour tester rapidement que Tomcat se lance bien, revenez dans Eclipse, basculez dans la perspective J2EE.

En bas dans la vue Server créer un serveur :

• click droit New/Server
• choisissez Apache/Tomcat v6.0 puis Next
• cliquez browse pour récupérer la racine de notre serveur Tomcat (/Applications/apache-tomcat-6.0.14)
• cliquez sur Next puis Finish.

Voilà, il reste plus qu’à le lancer : bouton vert…

Vous êtes fin prêt pour créer votre première JavaFlexApp

-Yann

Continue Reading

Subversion (plug-in Eclipse)

Posted on 02. jan, 2008 by olivier.

Vous allez voir, c’est assez simple.

Installation

Dans Eclipse, utilisons la fonctionnalité d’installation de plug-in : Menu Help/Software Updates/Find and install

1. Choisissons “Search for new features to install” puis Next
2. Ajoutons un nouveau site : “New remote Site…”
3. Ajoutons Subclipse à l’adresse : http://subclipse.tigris.org/update_1.2.x
4. Puis OK et Finish

C’est le seul endroit un peu délicat : il ne faut sélectionner que le Subclipse plugin (sinon il y aura un problème de dépendance)

Puis Next

Acceptons la licence puis Next et enfin Finish

Subclipse n’est pas signé donc il faut confirmer l’install : “Install All”

Il est suggéré de redémarrer ; redémarrons !

Voilà, c’est prêt

Continue Reading

Flex3 (standalone) et Tomcat 6 pour Windows

Posted on 02. jan, 2008 by olivier.

Préambule : On peut installer Flex 2 et Flex 3 en même temps sur la même machine. Il faut toutefois faire attention à 1 point : Ne pas mettre un projet Flex 2 et un projet Flex 3 dans le même Workspace.

Nous allons mettre en place la version 3 du 28/02/08. Il est nécessaire de désinstaller les versions 3 précédentes (beta 1, beta 2 ou beta 3) avant de mettre cette version finale.

Bien que j’ai l’habitude de travailler avec Eclipse directement et d’y ajouter les plugins, la nouvelle version 3 de FlexBuilder en standalone (qui intègre directement Eclipse) permet d’ajouter les plugins qui nous intéressent (contrairement à la version précédente). C’est donc une installation tout à fait utilisable dans “la vraie vie Flex”.

En revanche, la version packagée d’Eclipse n’intègre pas directement les WebTools, nécessaires pour faire du développement Web Java et du BlazeDS par exemple. Nous ferons donc la petite manipulation pour l’intégrer.

Afin de pouvoir tester notre installation, nous allons aussi installer Tomcat.

Dernière chose, nous avons essayé de prendre les dernières versions pour tous
les environnements au moment de la rédaction de l’article

1- Installons FlexBuilder 3 standalone

Url de téléchargement : flex builder 3 version standalone

Installation :

1. Vous remarquerez que l’installeur propose le choix d’une langue au début. Bon ya que l’anglais pour l’instant mais peut-être une version française bientôt disponible ?
2. Acceptez la licence : 60 jours de démo…
3. J’ai installé l’application dans l’endroit par défaut : c:Program FilesAdobeFlex Builder 3
4. J’ai installé les players proposés mais pas les extensions pour Coldfusion ni le plugin JSEclipse
5. “Install” et laissez mijoter quelques minutes. Voilà ! C’est prêt

Installation réussie!

Pour tester rapidement si tout fonctionne, lancez l’application (démarrer->Tous les programmes->Adobe->Adobe Flex Builder 3). Vous êtes normalement invités à utiliser la licence d’essai (trial)…

Par défaut votre espace de travail, le WorkSpace d’eclipse (un répertoire où vous mettrez les ressources des projets), se trouve avec FlexBuilder 3 dans C:Documents and SettingsPropriétaireMy DocumentsFlex Builder 3.

Après la page de bienvenue, vous arrivez normalement dans la perspective Flex Dev (perspective par défaut de Flex Builder). Dans cette perspective, créez un nouveau projet Flex (Menu File/New/Flex Project - Project Name : Test - Finish). Ajoutez un Label à l’application. Testez (Dans Flex Navigator, click droit sur Test.mxml -
Run as/Flex Application). Bienvenue dans Flex 3 !

2- Ajoutons les WebTools

1. Menu Help/Software Updates/Find and install
2. Choisissons Search for new features to install
3. Cochons Europa Discovery Site puis Finish
4. Choisissons un site mirroir
5. Nous avons alors une liste de fonctionnalités à installer
6. Cochons la dernière : Web and JEE Development
7. Ce module dépend d’autres modules, d’où la croix rouge…
8. Cliquons sur Select Required… et oh! magie, toutes les dépendances sont résolues
9. Cliquons sur Next, acceptons les licences, acceptons les modules optionnels (Next) puis cliquons sur finish

Il est suggéré de redémarrer ; nous allons redémarrer après une petite manipulation…

En effet, la mise en place des WebTools nécessite un petit nettoyage des workspaces utilisés avant l’installation du plugin. C’est assez simple à faire, il faut relancer eclipse avec l’option -clean dans un fichier de paramétrage de l’outil.

Arrêtons donc FlexBuilder 3.

Dans notepad, ouvrons le fichier de configuration FlexBuilder.ini qui se trouve dans le répertoire C:Program FilesAdobeFlex Builder 3.
Ajoutons sur la première ligne (et pas sur une autre) l’option -clean (avec un retour à la ligne). Exemple :

-clean
-vmargs
-XstartOnFirstThread
-Xms128m
-Xmx512m
-XX:MaxPermSize=256m
-XX:PermSize=64m

Relançons Flex Builder ; vous devriez noter que c’est un peu plus long (2 ou 3s…)

Voilà, c’est propre. Nous pouvons retirer le -clean du fichier ini. Notez que vous pouvez le laisser. Le démarrage sera juste plus long, mais vos workspace seront toujours propres. A vous de voir.

Pour tester rapidement, amenons la perspective Java EE dans notre espace de travail (Menu Window/Perspective/Other ; Prenons Java EE) ; Bien, bien. Pour faire quelque chose de sérieux, installons Tomcat.

3- Tomcat 6

Url de téléchargement : serveur Tomcat (prendre la version version core .zip)

Une fois le répertoire dézippé (apache-tomcat-6.0.16 chez moi), déplaçons-le sous C:Program Files. Voilà, c’est installé.
Vous pouvez, de la même manière installer une version 5.5 de Tomcat si vous préférez. Les 2 peuvent d’ailleurs cohabiter (attention toutefois au port 8080 de lancement qui est le même pour les 2 par défaut)

Pour tester rapidement que Tomcat se lance bien, revenez dans Eclipse, vous devez normalement être dans la perspective Java EE (sinon allez-y).

En bas, dans l’onglet de la vue Server créer un serveur :

1. Clic droit dans la fenêtre puis New/Server
2. Choisissez Apache/Tomcat v6.0 Server puis Next
3. Cliquez sur browse pour récupérer la racine de notre serveur Tomcat (C:Program Filesapache-tomcat-6.0.14)
4. Cliquez sur Finish.

Voilà, il reste plus qu’à le lancer : cliquez sur bouton vert à droite de la vue Server …

Le serveur ronronne

Vous êtes fin prêt pour créer votre première JavaFlexApp

-Yann

Continue Reading

Flex3 (plug-in) et Tomcat 6 avec Europa pour Windows

Posted on 27. déc, 2007 by olivier.

Afin de pouvoir travailler tranquillement, installons proprement et professionnellement Flex 3.

Préambule : On peut installer Flex 2 et Flex 3 en même temps sur la même machine. Il faut toutefois faire attention à 2 points :

• Il ne faut pas installer le plugin de Flex 3 dans le même Eclipse que celui de Flex 2 ;
• On ne peut pas mettre un projet Flex 2 et un projet Flex 3 dans le même Workspace.

J’ai l’habitude de travailler avec Eclipse directement et d’y ajouter les plugins. Cela me permet de savoir quel est l’Eclipse que j’ai installé et d’y mettre les plugins que je veux.

Je ferai donc une installation de FlexBuilder 3 sous forme de plugin et non pas flexbuilder avec Eclipse
packagé (version appelée standalone par Adobe).

Afin de pouvoir exécuter des applications Flex dans le monde Java, je vais aussi installer Tomcat et tout ce qu’il faut pour développer dans Tomcat avec Eclipse et FlexBuilder.

Dernière chose, nous avons essayé de prendre les dernières versions pour tous les environnements

JDK 6

Url de téléchargement : environnement java

Installation : J’ai dit oui à toutes les valeurs par défaut.

Remarques : le JRE devrait être OK si vous préférez. Ca devrait aussi passer avec Java 5 (1.5.X) mais je n’ai pas testé.

Eclipse 3.3 EE, nom de code Europa (contient les Webtools)

Url de téléchargement : IDE éclipse J2EE

Installation : L’installeur d’éclipse est en fait un zip. Installer, c’est donc dézipper.
Je vous propose de dézipper dans Program Files. J’ai renommé le répertoire principal Europa pour ne pas confondre avec mes versions précédentes d’eclipse.
J’ai de plus changé le fichier eclipse.ini. Faites-en d’abord une sauvegarde et remplacez son contenu par :

-vmargs
-Xms128m
-Xmx512m
-XX:MaxPermSize=256m
-XX:PermSize=64m
-Djava.net.preferIPv4Stack=true

Ce sont les paramètres de l’installation standalone de FB3. Sans eux, la création de projets de type J2EE plante… Si vous avez la chance d’avoir 2 Go de RAM, vous pouvez pousser -Xmx512m à -Xmx1024m.

Remarques : prenez bien la version EE (Enterprise Edition) qui contient en particulier les Webtools qui permettent de gérer Tomcat en développement.

flexbuilder 3 plugin

Url de téléchargement : flex builder plugin (Prendre l’installeur “Eclipse Plugin”)

Installation :

• Vous remarquerez que l’installeur propose le choix d’une langue au début. Bon ya que l’anglais pour l’instant mais peut-être une version française bientôt disponible ?
• Acceptez la licence : 30 jours de démo…
• J’ai installé le plugin dans l’endoit par défaut : C:Progam FilesAdobe.

(Note : Contrairement à de nombreux plugins Eclipse, FlexBuilder installe d’abord tous ses fichiers dans un répertoire à lui et dans un deuxième temps l’installeur fait le lien entre Eclipse et son répertoire d’installation)

• Le répertoire où vous avez installé eclipse précédemment. Moi c’est C:Program FilesEuropa (cf point 2-)
• J’ai installé les players proposés mais pas les extensions pour Coldfusion ni le plugin JSEclipse

Laissez mijoter quelques minutes et voilà, c’est prêt

Remarques : Pour tester rapidement si tout fonctionne, lancez C:Program FilesEuropaeclipse.exe. J’en ai fait un raccourci sur le bureau. Sélectionnez un Workspace (un répertoire de travail où vous mettrez les ressources des projets). Mon expérience m’a conduit à créer un répertoires WorkSpaces dans lequel je mets tous mes WorkSpace.

Ici j’ai par exemple créé un répertoire WEuropaTest dans WorkSpaces.
Après la page de bienvenue, vous arrivez normalement dans la perspective J2EE (perspective par défaut d’Europa EE)

Ajouter la perspective Flex (Menu Window/OpenPerspective/Other… = Flex development). Dans cette perspective, créez un nouveau projet Flex
(Menu File/New/Flex Project - Project Name : Test - Finish). Ajoutez un Label à l’application. Testez (Dans Flex Navigator, click droit sur Test.mxml - Run as/Flex Application). Bienvenue dans Flex 3 !

Tomcat 6

Note : Si vous avez déjà un Tomcat 5.5 d’installé vous pouvez l’utiliser ; Il n’est pas possible d’installer 2 versions de Tomcat
(chez moi, il y a un problème de service)

Url de téléchargement : serveur tomcat (prendre la versin core .zip)

Installation :

• Acceptez la licence
• Installation des modules standards : Start Menu Items et Documentation
• Installation dans Program Files
• port 8080 ; admin/votreMotDePasse
• j’ai choisi le répertoire du jdk1.6 sous Program Files/Java (même s’il demande un 1.5)
• A la fin de l’installation, décochez le lancement de Tomcat (nous le lancerons à notre convenance dans Eclipse) ;

Assurez-vous d’ailleurs qu’il ne se lance pas automatiquement sous forme de service.

remarque : pour tester rapidement que Tomcat se lance bien, revenez dans Eclipse, basculez dans la perspective J2EE.

En bas dans la vue Server créer un serveur :

• click droit/new/Server
• choisissez Apache/Tomcat v6.0 puis next
• Faites un browse pour récupérer la racine de notre serveur Tomcat
• (Program Files/Apache…/Tomcat6.0)
• Next puis finish.

Voilà, il ne reste plus qu’à le lancer : bouton vert…

Vous êtes fin prêt pour créer votre première JavaFlexApp

-Yann

Continue Reading