Seiten und Verlinkung zwischen Seiten

Vererbung von Seiten

Wicket-Seiten können vererbt werden.
Das HTML-Markup wird dabei mittels <wicket:child> und <wicket:extend> sowie <wicket:head> ineinander eingesetzt.
Ideal für Wiederverwendung eines gemeinsamen Seitenrahmens: Die abgeleitete Klasse befüllt den durch die Basisklasse vorgegebenen Rahmen mit Inhalten.
Achtung: Basis-Seiten sollten Konstruktoren analog WebPage deklarieren, damit Unterklassen diese Konstruktoren aufrufen können.

wicket:child / wicket:extend

Inhalte in <wicket:head> werden im <head>-Bereich der Basisseite ergänzt.
Inhalte in <wicket:extend> werden in den <wicket:child>-Bereich der Basisseite eingesetzt.

Statische Verlinkung auf Seiten: BookmarkablePageLink

Mit BookmarkablePageLink kann statisch auf Seiten verlinkt werden:
```
add(new BookmarkablePageLink("someLink", SomePage.class));
```
BookmarkablePageLink generiert statische URLs, auf die Lesezeichen gesetzt werden können:
```
http://localhost:8080/?wicket:bookmarkablePage=:de.ralfebert.SomePage
```

Mit ExternalLink kann auf externe Seiten verlinkt werden:

add(new ExternalLink("searchLink", "http://www.google.de/"));

Automatische Verlinkung mit wicket:link

<a href="...">-Links innerhalb eines <wicket:link>-Blocks werden von Wicket automatisch mit den entsprechenden Seiten verlinkt:

<wicket:link>
    <a href="SomePage.html">Some page</a>
    <a href="../SomeOtherPage.html">Some other page</a>
</wicket:link>

Ergebnis:

<a href="?wicket:bookmarkablePage=:de.someproject.somepkg.SomePage">Some page</a>
<a href="?wicket:bookmarkablePage=:de.someproject.SomeOtherPage">Some other page</a>

Auf Seiten-Instanzen verlinken: Link

Seiten-Objekte können bei Bedarf erzeugt und als ResponsePage gesetzt werden. Dies ist vor allem sinnvoll, wenn die Seite abhängig vom Request initialisiert werden muss:

add(new Link("someLink") {
    @Override
    public void onClick() {
        // Weiterleitung zu SomePage
        setResponsePage(new SomePage());
    }
});

Dies führt zu dynamischen Links, die nur für die jeweilige Session gültig sind und daher nicht per Lesezeichen gespeichert werden können, z.B.:
```
http://localhost:8080/?wicket:interface=:1::::
```

Mit PageParameters auf Seiten verlinken

Seiten mit Parametern (z.B. ID des zu editierenden Datensatzes bei einer Editierseite) können mit PageParameters verlinkt werden:

PageParameters params = new PageParameters();
params.put("id", 5);
add(new BookmarkablePageLink("someLink", SomeEditPage.class, params));

Die Übergabe der Parameter erfolgt im Konstruktor der Seite:

public SomeEditPage(PageParameters parameters) {
    super(parameters);
    int id = parameters.getInt("id");
}

Dies führt ebenfalls zu Bookmark-fähigen URLs:

http://localhost:8080/?wicket:bookmarkablePage=:de.ralfebert.SomeEditPage&id=5

Abarbeitung eines Requests

HTTP Requests für die Web-Anwendung werden von WicketFilter entgegengenommen.
Der HTTP Request wird dekodiert.
Das Ziel der Anfrage wird bestimmt, ggf. wird eine Seite erzeugt oder eine bereits in der Session vorhandene Seite geholt.
Zu verarbeitende Events werden an das Seitenobjekt bzw. deren Komponenten zugestellt.
Die Seite wird unter Verwendung des Seiten- und Komponenten-Markups gerendert und in den HTTP-Response geschrieben.

Umgang mit Generics

Die meisten Wicket-Komponenten haben ein generisches Argument für den Modelltyp (z.B. Link<T>).
Fehlt die Typangabe, warnt der Java Compiler (unchecked operation bzw. raw type used).
Wird kein Modelltyp benötigt, kann <Object> oder <Void> verwendet werden.
Alternativ können die Warnungen mit der Annotation @SuppressWarnings("unchecked") lokal unterdrückt werden.
Alternativ können die Warnungen in den Projekteinstellungen unter Java Compiler > Errors/Warnings > Generic types > Unchecked generic type operation sowie Usage of a raw type deaktiviert werden.

Weitere Informationen

Consistent layout using markup inheritance: http://www.javalobby.org/java/forums/t69357.html
Wicket’s XHTML tags: http://cwiki.apache.org/WICKET/wickets-xhtml-tags.html

Gregor Kaczor, 26. Januar, 01:33 Uhr

Hallo Ralf,

wie lassen sich externe Links in einer ListView als HTML-Links abbilden und nicht als JavaScript?

Viele Grüße

Gregor

Über Ihre Kommentare und Hinweise freue ich mich sehr: