Per poter iniziare il download dei sorgenti su eclipse e' importante avere un file di estensione .psf. (Team Project Source) che si trova soltanto per la versione 3.2 e 4.0 dentro la directory /build dei sorgenti scaricabili da http://www.jboss.org/downloads/index. Il .psf serve a unire diversi moduli CVS in un unico progetto. Questo perchè il progetto JBoss è composto da moltissimi moduli (per esempio jboss_hibernate, jboss_cache, jboss_tomcat) che devono essere uniti per poter formare una distribuzione. Per non farvi perdere tempo a fare il download completo della distribuzione vi condivido gli ultimi due .psf, aggiornati al 29/10/2004, uno per la versione 3.2 e uno per la 4.0. E' possibile pero', con il passare del tempo che questi files diventino precari ed è quindi necessario riprenderseli. Per chi invece li utilizza adesso non ci sarà bisogno di nessun altro download visto che vengono usati solo la prima volta. Per mantenere la versione aggiornata ,vedremo in seguito che è sufficiente un update dalla perspective CVS di eclipse.

Nella sezione Attachments List è possibile fare il downlaod di esempi di psf (momentaneamente non disponibili)

<?xml version="1.0" encoding="UTF-8"?>

<psf version="2.0">

     <provider id="org.eclipse.team.cvs.core.cvsnature">

           <project reference="1.0,

:pserver:cvs.sourceforge.net:/cvsroot/jboss,build/jboss,build,Branch_3_2"/>

           <project reference="1.0,:pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss-cache,cache,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jbossmx,cluster,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss-common,common,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jbosscx,connector,Branch_3_2"/>

           <project reference="1.0,

:pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss-console,console,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,contrib/iiop,iiop,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss-j2ee,j2ee,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,contrib/jboss.net,jboss.net,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jmx,jmx,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jmx-remoting,jmx-remoting,Branch_3_2"/>

           <project reference="1.0,

:pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss-management,management,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jbossmq,messaging,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jnp,naming,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss-remoting,remoting,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jbosssx,security,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss,server,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss-system,system,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jbosstest,testsuite,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,thirdparty,thirdparty,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss-tomcat,tomcat,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,tools,tools,Branch_3_2"/>

           <project reference="1.0,

:pserver:cvs.sourceforge.net:/cvsroot/jboss,jboss-transaction,transaction,Branch_3_2"/>

           <project reference="1.0,:

pserver:cvs.sourceforge.net:/cvsroot/jboss,contrib/varia,varia,Branch_3_2"/>

     </provider>

</psf>

 

Da notare che le informazioni sul repository cvs dentro il psf devono essere cambiate se non corrispondono alle nostre esigenze. Al momento ci sono due configurazioni per fare il download dei sorgenti da cvs. Una per chi ha l'accesso in scrittura, ovvero per gli sviluppatori certificati dal JbossGroup (extssh:cvs.sourceforge.net:/cvsroot/jboss con relativo account) , e l'altra in sola lettura per chiunque ha voglia di addentrarsi nel codice (pserver:cvs.sourceforge.net:/cvsroot/jboss con account anonymous). Per piu' informazioni a riguardo andate su http://www.jboss.org/developers/sourcecode.

Veniamo ora a Eclipse. Una volta preso il psf della versione interessata , andare su File/Import e selezionare "Team Project Set"

 

Fig. 4 - importazione dei sorgenti descritti nel file psf

selezionare il file e cliccare su Finish
 

 

Fig. 5 Import Team Project Set

Mettere l'utenza e password cvs se si ha, altrimenti si usa :

• USER : anonymous
• PASSWORD :

 
Fig. 6 - User e Password

Marcare "Save Password" altrimenti l'account verrà richiesta per ogni modulo scaricato. A questo punto, con venti minuti circa di dowload avremo tutti i moduli cvs sotto forma di progetti Eclipse

Prima dell'esecuzione o del debugging di Jboss, ci sono delle cose che bisogna fare. Andiamo innanzitutto su Run/Run. Ci apparirà la finestra di configurazione. Selezioniamo sulla sinistra Java Application e in basso a sinistra clicchiamo su New

 

 

Ci sono diverse voci nel menu'. A noi interessano le voci Main, Arguments e Classpath:

• Main

  dall'alto in basso, su Name diamo un nome alla nostra configurazione, su Project andiamo su Browse e selezioniamo il progetto System, su Main Class, andiamo in Search e selezioniamo la classe org.jboss.Main

• Arguments

  dall'alto in basso, alla voce Program Arguments inseriamo -c all . Permette di eseguire l'application server al completo, altrimenti molti moduli non potranno essere visti dal debugger, poi alla voce VM Arguments dobbiamo dare il path della JBOSS_HOME, altrimenti la nostra applicazione andrà subito in errore per mancanza di configurazioni. Scriviamo -Djboss.home.dir=$WORKSPACE/build/output/$RELEASE. Al posto di $WORKSPACE metteremo il path del nostro corrente workspace di Eclipse, e al posto di $RELEASE, metteremo la directory che è stata generata automaticamente da Ant grazie al target release spiegato in precedenza.

• Classpath

  Il classpath è indispensabile perchè, utilizzando Eclipse, abbiamo purtroppo un disallineamento tra i sorgenti situati nei progetti sulla sinistra e i jar dove Jboss è abituato a prendere i files di configurazione (Per intenderci si tratta di tutti quei files che nei sorgenti si trovano sotto il folder resource. Dovremo quindi specificare nel classpath tutti i jar indispensabili per l'avvio, ovvero quelli sotto la directory bin e quelli sotto lib. Selezioniamo User Entries e andiamo su Advanced (Fig. 10).

 

Per mantenere la nostra release aggiornata, è importante di tanto in tanto eseguire un update dal cvs su tutti i progetti. E' sufficiente selezionare tutti i progetti, cliccare su di essi con il tasto destro e andare su Team/Update.

 

Fig. 13 - Update CVS dei sorgenti

Con circa 20-10 minuti (a seconda della velocità della linea internet. Non usate il Modem!!!) avremo una versione aggiornata. L'update comporta un rebuild dei progetti. Questo si puo' fare anche da Project/Build all ma non assicura una corretta compilazione, visto che è possibile che vengano richieste nuove classi configurate con xdoclet. Bisogna quindi utilizzare ant con il sistema descritto precedentemente. Un problema che si verifica spesso , successivamente all'update da cvs, è quando vengono aggiunte nuove librerie su di un progetto. Infatti si possono trovare delle classi che richiedono una nuova libreria o il package di un altro progetto. Questo perchè l'update si occupa soltanto di mantenere il versionamento di files e classi ma non aggiorna la configurazione dei progetti per Eclipse. Infatti succede che , eseguendo la compilazione con ant, va tutto bene mentre al momento del lancio con Eclipse ci sono degli errori. Antnon risente della configurazione del progetto, visto che la sua configurazione è descritta nei files xml anch'essi aggiornati da cvs. La configurazione di eclipse , invece dipende strettamente dal psf che abbiamo usato all'inizio per scaricarci i sorgenti. Le soluzioni per rimediare a questo problema sono due, una piuttosto drastica che è quella di reimportarsi i sorgenti tramite il nuovo psf residente nel progetto Build, rieseguendo le operazioni descritte precedentemente, l'altra è quella di aggiornare i progetti man mano che si verificano questi cambiamenti. Dobbiamo percio' eseguire una ricerca degli errori , andando a vedere direttamente i sorgenti. Questo con Eclipse risulta molto semplice, grazie alla view Problems situata di solito nella parte in basso, oppure seguendo semplicemente i pallini rossi, partendo dal Package Explorer fino ad arrivare al sorgente.

Fig. 14 - La view Problems puo' essere presa andando su Window/Show Viewes/Problems