08/2008 - KaffeeKlatsch

Verhext!
Einspruch, Euer Ehren..!
Web-Anwendungen sollen dem Anwender unter anderem
auch Schnittstellen bieten, über die Daten eingesehen,
erstellt oder manipuliert werden können. Damit dies
nicht willkürlich geschieht, gibt uns Wicket sogenannte
Validatoren an die Hand. Mit diesen lässt sich z. B. prüfen,
ob ein Anwender in einem Porto-Kalkulator für sein
Paket auch kein negatives Gewicht angegeben hat, oder
ob die Straße, unter der er sich bei uns anmelden will,
auch in der von ihm angegebenen Stadt existiert. Die
beiden genannten Fälle unterscheiden sich grundlegend
dadurch, dass der erste Fall nur ein isoliertes Formularfeld
betrifft, während der zweite ein Formular als Ganzes
bewertet.
Für den ersten Anwendungsfall bietet Wicket einfache
Validatoren, von denen es sowohl vordefinierte Implementierungen
gibt (z. B. den MinimumValidator),
also auch die Option eigene Ableitungen der Klasse
AbstractValidator zu implementieren.
Der zweite Anwendungsfall wird in Wicket durch
Ableitungen von AbstractFormValidator abgedeckt.
Diese Ableitungen müssen in einer überschriebenen
Methode getDependentComponents() deklarieren, welche
Formularfelder validiert werden müssen, um das komplette
Formular als valide einstufen zu können.
Wanderer zwischen den Welten
Eine Problematik, die einem Web-Entwickler hinlänglich
bekannt ist, ist das Verpacken eines komplexen Objekts in
seine String-Repräsentation für ein HTTP-Request, um
es an den Browser zu senden, oder auch das Auspacken,
um die Antworten serverseitig wieder als Objekt weiterverwenden
zu können.
Das Hilfsmittel, das zur Lösung dieses Problems eingesetzt
werden kann, ist ein Konvertierungs-Mechanismus,
über den die Server-seitigen Objekte nach einem
definierten Vorgehen in Strings für den HTTP-Request
umgewandelt und beim Eintreffen der Antwort auch
wieder aus den Strings hergestellt werden.
Um dieses Vorgehen bei Wicket einsetzen zu
können, wird für jede Klasse, die als Datum an ein
Ein-/Ausgabefeld geknüpft ist – z. B. das im letzten
Abschnitt erwähnte Ge wicht eines Päckchens –,
eine Konverter-Klasse geschrieben, die das Interface
org.apache.wicket.util.convert.IConverter implementieren
muss. Zur Konvertierung dienen dabei die beiden
Methoden convertToObject(String, Locale) und
convertToString(Object, Locale) des Interfaces. Ein auf
diese Weise erzeugter Konverter muss nun noch mit der
Klasse verbunden werden, die er zu konvertieren hat. Dies
kann auf zweierlei Arten geschehen. Zum einen kann der
Konverter direkt an die Komponente, welche die zu konvertierende
Klasse in einem Modell beherbergt, geknüpft
werden. Diese geschieht durch Überschreiben der Methode
getConverter(), wie in folgendem Beispiel zu sehen ist.
TextField input = new TextField("gewicht",
new PropertyModel(gewicht.getValue())) {
@Override
public IConverter getConverter(Class type) {
return WeightConverter();
}
};
Der zweite Weg ist, die zu konvertierende Klasse applikationsweit
mit dem Konverter zu verknüpfen. Diese
Einstellung kann beim Implementieren der Applikationsklasse
durch das Überschreiben der Methode new-
ConverterLocator() erreicht werden. Der Converter-
Locator ist eine Map, die für die gesamte Applikation
Key/Value-Paare für Klassen mit zugehörigen Konverter-Instanzen
enthält. Ein Überschreiben der Methode
könnte folgendermaßen aussehen:
protected IconverterLocator newConverterLocator() {
ConverterLocator locator =
new ConverterLocator();
locator.set(Weight.class, new WeightConverter());
return locator;
}
Wicket Links
Verweise zwischen einzelnen Seiten können in Wicket
grundsätzlich auf verschiedene Weisen implementiert
werden. Neben der einfachen Klasse org.apache.wicket.
markup.html.link.Link gibt es noch Implementierungen
für externe Links (ExternalLink), sowie die Klasse
PageLink im gleichen Paket. Diese Implementierung
sorgt automatisch dafür, dass Verweise auf aktuell angezeigte
Seiten inaktiv werden.
Haben Sie beispielsweise ihr Webmail-Postfach geöffnet,
und auf der linken Seite befinden sich Links für
alle Ordner in Ihrem Postfach (Eingang, Ausgang, Spam,
ect.), sorgt der PageLink automatisch dafür, dass Sie
nicht nochmal auf die Ausgangs-Ordner-Schaltfläche
klicken können, wenn Sie aktuell den Ausgangs-Ordner
geöffnet haben.
Viel wichtiger als die oben genannte Implementierung
ist allerdings der BookmarkablePageLink. Reguläre
Wicket-URLs sind recht umfangreich und enthalten auch
Paket- und Klassennamen der aktuell angezeigten Wicket-
Seite. Als Anbieter oder Entwickler möchten wir solche
Seite 8 KaffeeKlatsch Jahrgang 1 / Nr. 8 / August 2008