Programmer avec les Domino JSP Tags

Article Précédent: Programmer en JSP sous Domino

Dans le précédent article, nous avons exécuté notre première page JSP. Nous en avons profité pour apprendre les rudiments du Java avec Domino. Et nous avons constaté que c'est assez complexe et qu'on ne pourra sans doute pas confier cette tâche à Lolo le webmaster de la boîte (ben oui, Lolo sorti de Photoshop et de FrontPage ... ).

Dans le présent article nous allons voir qu'il existe une méthode en apparence beaucoup plus simple : les JSP Custom Tag Libraries pour Domino. Je dis "en apparence" parce que ça demande quand même un peu d'habitude. C'est comme le tiramisu, les premières fois c'est aussi indigeste que du mortier et puis après ça s'améliore (sauf ceux de ma tante Sophie qui ressemblent de plus en plus à du mortier. Les tiramisu, pas ma tante, bien sur!).

Table des matières:

1. Comprendre les Customs Tag Libraries
2. Comment utiliser les Custom Tags Libraries

1. Comprendre les Customs Tag Libraries

Les Custom Tag Libraries sont des bibliothèques de tags qui facilitent la tâche du développeur de JSP en simplifiant la structure et la syntaxe du code. Lorsque je parle de tag, je pense aux balises comme <b> et </b> par exemple.

Les Custom Tags ne sont pas une exclusivité de Domino. On en trouve dans d'autres applications parce qu'il s'agit d'une spécification du JSP.

Avec les Custom Tag Libraries on est capable de résumer des séquences complexes de code Java en un couple de balises beaucoup plus simple. Je vais prendre un exemple pour être plus clair :

<domino:view dbname="myDatabase.nsf" viewname="All">
  <domino:viewloop>
    </p>
      Titre : <domino:viewitem name="Title"/>
    </p>
  </domino:viewloop>
</domino:view>

J'ai fait figurer les custom tags en gras. Si on se contente de lire ces tags, on comprend intuitivement ce qui se passe : on sélectionne une vue, on la parcourt et on affiche le champ titre de chaque document dans un paragraphe HTML (balise p). Chaque tag possède un terminateur ce qui permet de bien distinguer les blocs d'instructions.

Avouez-le, c'est quand même plus lisible qu'en pur Java non?

2. Comment utiliser les Custom Tags Libraries

Si vous avez bien suivi la procédure d'installation de Tomcat, vous avez copié des fichiers d'extension tld dans le répertoire /simple/WEB-INF/tlds où simple est le nom du répertoire de test que nous avons créé. Vous devez copier ces fichiers dans chacun de vos répertoires JSP.

Il s'agit de fichiers XML qui contiennent la description des balises : domtags.tld qui décrit les balises relatives aux objets Domino et domutils.tld qui décrit des balises génériques comme if ou switch.

Comme rien ne vaut un bon exemple (qui a parlé de Cameron Diaz?), nous allons examiner le code de la page qui retourne le même résultat que celui de notre précédent article :

Comme vous pouvez le noter, l'en-tête de la page a changé : on y a ajouté les déclarations des deux bibliothèques de balises.

Pour le reste, on effectue un parcours de vue somme toute très classique.

Pour en savoir plus sur la syntaxe et la liste des tags disponibles, je vous recommande l'utilisation de l'aide en ligne de Designer qui contient une description de chaque tag.