Elements requis

L'exécution du plugin nécessite :
  • Java 1.5 (basé sur Tapestry 5)
  • Maven 2+ (testé avec 2.0.10 et 2.2.1)

Utilisation

Mettre en place tapestry-tldgen prend 2 minutes :

  • Documentez soigneusement vos classes de composants et leurs attributs annotés via @Parameter (déjà fait non ? :))
  • Ouvrez le pom.xml de votre librairie
  • Coller la configuration ci dessous dans la section plugins :
         
        <plugin>
            <groupId>fr.exanpe</groupId>
            <artifactId>tapestry-tldgen</artifactId>
            <version>${set the version here}</version>
            <executions>
                <execution>
                    <goals>
                        <goal>tld-generate</goal>
                    </goals>
                    <phase>process-classes</phase>
                    <configuration>
                        <uri>${set your tld uri here}</uri>
                        <namespace>${set your tld defaut namespace here}</namespace>
                        <rootPackage>${set your root package here}</rootPackage>
                        <encoding>${set your source file encoding here}</encoding>
                    </configuration>
                </execution>
            </executions>
        </plugin>
        
                
  • Lancez un build and récupérez votre tld dans le répertoire target/

Configuration

Clé requis Description
uri oui L'uri de la taglib
rootPackage oui Le package de base utilisé pour scanner le composants. No pas inclure le suffixe "components", seule la racine est requise.
namespace non Le namespace de la taglib. "t" par défaut.
encoding non L'encodage des fichiers java source. Encodage de la plateforme par défaut
outputFile non L'emplacement d'écriture de la tld. Par défaut : ${project.build.directory}/${project.build.finalName}.tld

Exploitation de la tld

Pour exploiter la tld générée, suivre la documentation disponible à l'adresse suivante :
Tapestry 5 et l'editeur JSP pour Eclipse