LFO's

Voilà, je viens de "commiter" ma version du support Continuum dans Netbeans (4201) à laquelle j'ai ajouté un petit tutoriel pour l'illustrer (4202). Il manque encore la possibilité d'ajouter un projet. Mais ça viendra !

C'est pas le plus beau code que j'ai écrit et encore moins le plus compliqué. Mais, j'avoue que c'est assez enthousiasmant d'apporter sa petite brique à l'édifice open-source. Surtout à l'heure où l'open-source se professionalise à tout va.

Ca méritait un petit post.

Toujours dans mes nouvelles activités, de relookage de l'intégration de Continuum dans Netbeans, je commence à obtenir un résultat assez sympathique.

Oh zut ! Mon test unitaire de HelloWorldApp ne passe pas.

TODO : correct the helloworld.AppTest.

Je suis en train de porter vers Netbeans une application web développée par des Eclipsiens avec pour process de build des scripts ants.

Une première approche consista à créer une webapp à partir du script ant existant. Temps du portage 10 minutes.
Génial, rien à redire !!

Maintenant, j'aimerais faire mieux car les temps de déploiement et de relance Tomcat sont couteux de cette manière.
Je tombe donc sur cette article : http://www.netbeans.org/kb/articles/porting-webapps.html qui ma foi est très bien mais trop simple pour mes besoins. Mon soucis majeur est induit par XDoclet qui génère mes taglibs et mon web.xml dynamiquement alors que Netbeans en à besoin de manière statique à la création du projet. J'ai aussi le fait que l'application tourne actuellement avec Tomcat4 qui n'est pas "bundled" avec Netbeans 5.5 (seulement à partir de la 5.0 de Tomcat) . Nul doute que je vais venir à bout de mes problèmes et ce n'est d'ailleurs pas l'objet de ce "post", mais en est l'introduction.

Donc voilà, dans l'article préalablement cité je tombe sur ces 2 phrases :

There is a school of thought that says that the code should be written with such clarity that documentation inside the method is

not required. While I may agree with this viewpoint as an ideal, ... 

Il en conclut donc :

I add “fix internal documentation” to my to-do list.

Oui un code se suffisant à lui même est un idéal et je suis de cette école, même peut être le pire élève. Et, Je devrais donc plutôt mettre dans ma TODO list : "Refactor and Clarify code".

Mais plus je vieillis plus je deviens prudent et moins je prends de risque. Donc sans aucun test unitaire pour me protéger d'éventuels régressions, pour ce coup là, je n'ai pas mis, "Refactor code" dans ma TODO list.

Nous sommes des idéalistes mais l'age fait de nous des réalistes.

Quelqu'un peut il me dire quelle est la plus value des commentaires dans ce code :

/**
 Toto.java
 Contient le code de Toto.  
 @author c'est moi qui l'ai fait.
**/
public class Toto {

    /** Le Tutu. */
    private Tutu tutu;
    /** La Tata. */
    private Tata tata;

    /**
     * Construit un nouveau {@link Toto}.
     * @param request La Tata pour laquelle on travaille.
     */
    public Toto(Tata tata) {
       // la Tata local
       Tata lTata = tata;
       // On va mettre à jour la {@link Tata}.
       setTata(lTata);
       // On initialise le {@link Tutu} à null.
       tutu = null;
    }
    
    /**
     * Met à jour la {@link Tata}
     * @param request La {@link Tata} pour laquelle on travaille. (noter le gros copier/coller !)
     */
    public void setTata(Tata tata) {
        this.tata = tata;
    }

    /**
     * renvoit la {@link Tata}
     * @return le {@link Tata}
     **/
    public Tata getTata() {
        return tata;
    }
}


Franchement s'il vous plait arréter, ça ne sert à rien mis à part perdre du temps. Mettez un commentaire seulement si vous avez quelque chose d'intelligent à dire et que vous n'arrivez pas à l'exprimer par le code.</p>

Exercices :

•      Exercice 1 : Avec votre IDE préféré ou sans, déplacez le code de Tata dans un autre package.

•      Exercice 2 : idem pour le Tutu.

•      Exercice 3 : Déterminez à quoi peut servir le Tutu dans Toto, sachant que quelqu'un à bien préciser dans le constructeur qu'il fallait l'initialiser à null ?

Enfin, une version stable du plugin Mevenide pour Maven2 et Netbeans5.

Plus de renseignement sur l'excellent site de documentation : http://mevenide.codehaus.org/m2-site