Um das ListControl-Tag auf einer JSP Seite einzusetzen, muss am Anfang der Seite die entsprechende Tag Library deklariert werden. Anschließend können die Common-Controls mit dem Präfix <ctrl:tagname /> verwendet werden. [Zudem muss die Aufnahme der Tag Bibliotheken im Deployment-Deskriptor, der WEB-INF/web.xml Datei, erfolgen]

<%@ taglib uri="/WEB-INF/tlds/cc-controls.tld" prefix="ctrl" %>

<ctrl:list
    id="userlist1"
    action="sample101/userBrowse"
    name="users"
    title="User List"
    width="500"
    rows="15"
    refreshButton="true"
    createButton="true">

    <ctrl:columndrilldown
        title="Id"
        property="userId"
        width="65"/>

    <ctrl:columntext
        title="Name"
        property="name"
        width="350"/>

    <ctrl:columntext
        title="Role"
        property="role.value"
        width="150"/>

    <ctrl:columnedit
        title="Edit"/>

    <ctrl:columndelete
        title="Delete"/>

</ctrl:list>

Damit sind alle notwendigen Schritte zur Nutzung des ListControls abgeschlossen.

• Der Blättermechanismus muss nicht selbst implementiert werden, da dieser bereits mit dem ListControl zur Verfügung gestellt wird.
• In der JSP-Seite haben wir festgelegt, dass das ListControl maximal 15 Zeilen zeichnen soll. Wenn mehr Zeilen vorhanden sind, werden automatisch die Buttons zum Vor- und Rückwärtsblättern eingeblendet.
• Bei einem Klick auf den Vorwärtsbutton erfolgt ein Serverroundtrip und die Anzeige der nächste Seite. Die Aktualisierung wird dabei von dem Präsentationsframework übernommen. Es muss kein zusätzlicher Code implementiert werden.

zurück   |   weiter