Configuration
de JBuilder
Configuration de JBuilder pour compiler un channel uPortal
- Soit <uportal_home>
le répertoire où se situe l'arborescence de la distribution
quick start de uportal
- Aller dans tools -> Configure librairies
et créer un nouvelle librairie (nommée jasig
par exemple)
- Ajouter à cette librairie tous les jars se trouvant dans <uportal_home>\uPortal_rel-2-1\lib
- Créer un nouveau projet (type classe)
- Les sources du projet doivent pointer vers <uportal_home>\uPortal_rel-2-1\source
- L'output path (génération des classes) doit pointer vers <uportal_home>/Tomcat_4-1-12/webapps/uPortal/WEB-INF/classes
- Dans les propriétés du projet, ajouter en librairie required,
la librairie que l'on vient de créer (jasig)
- Pour les nouveaux packages, l'arborescence suivante à été
retenue : fr.univ.nancy2.uportal.channels
- Les fichiers xsl et ssl doivent être positionnés dans <uportal_home>\Tomcat_4-1-12\webapps\uPortal\WEB-INF\classes\arborescence_package
Configuration de JBuilder Entreprise pour débugger
le portail
Attention, il ne s'agit pas forcément
de la méthode la plus orthodoxe ;-)
- Aller dans Tools -> Configure Servers
et s'assurer que Tomcat 4.1 est bien la.
- Aller dans Tools -> IDE Options ->
Web et cocher Do not use Web
View (le browser interne de jbuilder ne fonctionne pas bien
avec uPortal)
- Une fois son projet ouvert, aller dans le menu Wizards
-> Ant et ajouter le fichier build.xml se situal sous <uportal_home>.
Ceci a pour effet d'ajouter build.xml dans l'explorateur du projet. On peut
ainsi lancer tomcatstart depuis
l'explorateur (même si ce n'est pas ce que nous ferons). On l'utilisera
plutot pour tomcatstop.
- Créer ensuite une configuration d'exécution avec le menu Run
-> Configurations. Ajouter une configuration par défaut nommée
UPortal avec les caractéristiques suivantes :
- Build Target
: tomcatstart
- Onglet Run : Type =
server / Tomcat 4.1
- Dans l'explorateur du projet (sur la gauche par défaut), faire un
clic droit sur <Default WebApp>
et choisir Properties. Choisir
la directory <uportal_home>/Tomcat_4-1-12/webapps/uPortal
comme root directory
Debuggage avec JBuilder Entreprise
- lancer hsql manuellement
dans une fenêtre dos
- Poser un point d'arrêt dans une classe du portail
- lancer une première fois uportal avec les options de build.xml
disponibles dans l'explorateur du projet
- Ce premier lancement ne se termine jamais
sous jbuilder mais il est nécessaire!
- attendre que la ligne " [java] INFO: Jk
running ID=0 time=32/47 config=J:\Java\esup\uportal\uPortal_2-1-quick-start\Tomcat_4-1-12\conf\jk2.properties
" apparaisse puis annuler le build en cours
- une première instance de uPortal doit alors tourner sur le port 8080
- lancer ensuite le debuggage à proprement parler (maj
+ F9)
- Attendre cette fois ci la fin normal du build (jusqu'à INFO:
Starting Coyote HTTP/1.1 on port 8083)
- une deuxième instance de uPortal doit alors démarrer sur le
port 8083
- utiliser uPortal sur le port 8083 dans son navigateur préféré.
JBuilder s'arrêtera alors tout seul sur les points d'arrêt et
passera en mode debug
- penser à paramétrer un
time-out très généreux sur les channels!
- Quand on a terminé, se rappeler
qu'une instance d'uPortal tourne sur le port 8080 et donc penser à
faire un tomcatstop dans l'explorateur.
