Zur Installation Ihrer ersten Tapestry-Anwendung laden Sie das Archiv helloworld.war herunter und importieren Sie es in die IDE Ihrer Wahl. Nun lassen Sie uns die Struktur der importierten Anwendung anschauen. Zunächst betrachten wir die Datei web.xml im Verzeichnis WebContent/WEB-INF:
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><display-name>Tapestry 5 Buch</display-name><context-param><param-name>tapestry.app-package</param-name><param-value>de.t5book</param-value></context-param><filter><filter-name>app</filter-name><filter-class>org.apache.tapestry5.TapestryFilter</filter-class></filter><filter-mapping><filter-name>app</filter-name><url-pattern>/*</url-pattern></filter-mapping></web-app>
Zwei Aspekte sind nennenswert: zum einen der Name des Tapestry-Filters, zum anderen der Context-Parameter tapestry.app-package. Der Tapestry-Filter ist eine Implementierung des Interface javax.servlet.Filter, die zur Behandlung von Anfragen an Tapestry-Anwedungen zuständig ist. Der Context-Parameter tapestry.app-package gibt das Wurzelpaket Ihrer Anwendung an und ist die einzige Stelle in Tapestry, die mittels XML konfiguriert wird. Ausgehend von diesem Wurzelpaket sucht Tapestry nach Seiten und Komponenten in vordefinierten Unterpaketen.
Ihre erste Tapestry-Anwendung
Eine Tapestry-Anwendung besteht aus einer Menge von Seiten, Komponenten und Diensten. Jede Seite kann mehrere Komponenten enthalten. Komponenten können ihrerseits aus weiteren Komponenten zusammengebaut werden. Nach der vordefinierten Namenskonvention sucht Tapestry nach Klassen von Seiten im Unterpaket pages. In diesem Beispiel ist de.t5book als Wurzelpaket der Anwendung konfiguriert. Also sucht Tapestry im Paket de.t5book.pages nach Klassen von Seiten. Klassen von Komponenten werden im Paket de.t5book.components erwartet.
Jede Seite oder Komponente wird durch eine Java-Klasse und ein optionales Template repräsentiert. Schauen wir uns dazu die Seite Index an. Es handelt sich um eine einfache Java-Klasse mit einer Getter-Methode. Beachten Sie, dass diese Seite ein reines POJO (Plain Old Java Object) ist. Im Gegensatz zu beinahe allen Java-Webframeworks werden Sie von Tapestry nicht gezwungen, die Klassen der Seiten oder der Komponenten von vorgeschriebenen Superklassen abzuleiten oder bestimmte Interfaces zu implementieren:
public class Index {public String getHello() {return "Hello, World!";}}
Wie bereits erwähnt, kann jede Seite und Komponente ein optionales Template enthalten. Das Matching zwischen einer Klasse und dem zugehörigen Template erfolgt über die Namen der beiden Dateien. Also sucht Tapestry für die Seite Index nach einer Datei Index.tml. Die Endung .tml steht für die Tapestry Markup Language (TML). Im Prinzip ist die Tapestry Markup Language eine Erweiterung von XHTML. Wie jede XHTML-Datei muss ein Tapestry Template ein Wurzelelement enthalten. In diesem Wurzelelement ist der Tapestry-Namensraum zu sehen, der zu Identifikation von Elementen benutzt wird, die im Tapestry-Schema definiert sind:
<html xmlns:t="http://tapestry.apache.org/schema/tapestry_5_1_0.xsd"><head><title>Tapestry 5 Buch</title></head><body>${hello}</body></html>
Der Ausdruck $ {hello} wird als Expansion bezeichnet. Expansions sind eine Tapestry-spezifische Erweiterung von XHTML. Sie können als Platzhalter innerhalb von Templates verstanden werden, die zur Laufzeit mit Werten von Variablen belegt werden. In diesem Beispiel greift die Expansion auf die Methode getHello() der Klasse Index zu. Also wird die Expansion mit dem Rückgabewert dieser Methode, nämlich „Hello World!“, zur Laufzeit belegt. Nun starten Sie die Anwendung und rufen Sie den URL http://localhost:8080/hello-world/index in Ihrem Browser auf. Es sollte die Startseite der Anwendung erscheinen.
