Es wird das Struts <html:options> Element erläutert und anhand von kleinen Beispielen der Umgang veranschaulicht.

Transkript

1 Struts Code Peaces <html:options> Element Es wird das Struts <html:options> Element erläutert und anhand von kleinen Beispielen der Umgang veranschaulicht. Allgemeines Autor: Sascha Wolski Sebastian Hennebrüder Tutorials für Struts, EJB, xdoclet und eclipse. Datum: 15. Februar 2005 Das <html:options> Element Das <html:options> Element ist Bestandteil eines <html:select> Elements und kann auch nur innerhalb dieses genutzt werden. Zur Laufzeit wird ein HTML <option> Element gerendert. Das <html:options> Element wird genutzt um Listen von Daten in einer HTML Selectbox auszugeben. Es können beliebig viele <html:options> Elemente innerhalb des <html:select> Elements verwendet werden. Folgendes Beispiel zeigt den Quelltext der JSP Datei: <html:options collection="customers" property="id" labelproperty="name" /> Folgender HTML Quelltext wird zur Laufzeit von Struts ausgegeben: <select name="selecteditem"> <option value="1">marie</option> <option value="2">klaus</option> </select> Attribute des <html:options> Elements Die wichtigsten Attribute werden kurz erläutert. Die vollständige Liste aller Attribute findet man in der API zu der HTML Tag Bibliothek von Struts. Name collection labelname labelproperty name property Beschreibung Name einer Collection (in einem Scope). Diese Collection enthält andere Beans. Name des Bean (in einem Scope) das eine Collection von Anzeigetexten (Labels) enthält die dem Benutzer angezeigt werden. Eigenschat des Beans oder des Beans das mit labelname angeben wird, das die Anzeigetexte (Labels), die dem Benutzer angezeigt werden, enthält. Name eines Beans (in einem Scope) das eine Collection von Werten enthält. Eigenschaft eines Form-Beans oder dem Bean, welches durch das name Attribut angeben wird, was eine Collection von Werten enthält. Diese Werte werden beim Abschicken des Formulars übertragen, wenn das Element ausgewählt wurde. Verwenden des <html:options> Elements Erstelle ein neues Struts Projekt um die Verwendung des <html:options> Elements zu veranschaulichen.

2 Erstellen einer Objektklasse Erstelle eine neue Java-Klasse Customer im Package de.laliluna.tutorial.options.object. Diese Klasse repräsentiert einen Kunden (Customer). Erstelle zwei Eigenschaften, id vom Typ int und name vom Typ String und erstelle für jede Eigenschaft eine Getter- und Setter-Methode. Definiere noch einen Konstruktor, der es erlaubt die beiden Eigenschaften beim Initialisieren der Klasse zu setzen. Die Objektklasse sieht wie folgt aus. public class Customer { private int id; private String name; public Customer(){ public Customer(int id, String name){ this.id = id; this.name = name; public int getid() { return id; public void setid(int id) { this.id = id; public String getname() { return name; public void setname(string name) { this.name = name; Erstellen eines neuen FormBeans Erstelle eine ActionForm Klasse ExampleForm im Package de.laliluna.tutorial.options.form. Definiere eine Eigenschaft vom Typ String die dem <html:select> Element zugewiesen wird. Diese Eigenschaft beinhaltet später den ausgewählten Wert aus der HTML Selectbox. Erstelle im Anschluss zwei Eigenschaften vom Typ Collection. Die Eigenschaft customervalues beinhaltet die Werte der Kunden. Die Eigenschaft customerlabels beinhaltet die Anzeigetexte für die Kunden. Erstelle für jede Eigenschaft einige Dummy-Daten. Folgender Quelltext zeigt die ActionForm Klasse: public class ExampleForm extends ActionForm { private String selecteditem; private Collection customerlabels; private Collection customervalues; public String getselecteditem() { return selecteditem; public void setselecteditem(string selecteditem) { this.selecteditem = selecteditem; public Collection getcustomerlabels() {

3 // define some dummy labels customerlabels = new ArrayList(); customerlabels.add("marie"); customerlabels.add("klaus"); customerlabels.add("peter"); return customerlabels; public void setcustomerlabels(collection customerlabels) { this.customerlabels = customerlabels; public Collection getcustomervalues() { // define some dummy names customervalues = new ArrayList(); customervalues.add("1"); customervalues.add("2"); customervalues.add("3"); return customervalues; public void setcustomervalues(collection customervalues) { this.customervalues = customervalues; Erstellen einer neues Action Klasse Lege eine neue Action Klasse ExampleAction im Package de.laliluna.tutorial.options.action an. Wir stellen einige Dummy-Daten als Collection bereit, die wir später für die Ausgabe benötigen. public class ExampleAction extends Action { public ActionForward execute( ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) { ExampleForm exampleform = (ExampleForm) form; //define a dummy collection Collection customers = new ArrayList(); customers.add(new Customer(1, "Marie")); customers.add(new Customer(2, "Klaus")); customers.add(new Customer(3, "Peter")); //set the collection in the request request.setattribute("customers", customers); return mapping.findforward("success"); Erstellen der struts-config.xml Öffne im Anschluss daran die struts-config.xml und definiere das FormBean und das ActionMapping. <struts-config> <form-beans> <form-bean name="exampleform" type="de.laliluna.tutorial.options.form.exampleform" /> </form-beans> <action-mappings> <action name="exampleform"

4 path="/example" scope="request" type="de.laliluna.tutorial.options.action.exampleaction"> <forward name="success" path="/form/example.jsp" /> </action> </action-mappings> </struts-config> Erstellen der JSP Datei Erstelle im Verzeichnis /WebRoot/form/ eine JSP Datei example.jsp. Öffne die JSP Datei example.jsp und füge folgenden Quelltext hinzu. page language="java"%> taglib uri=" prefix="bean"%> taglib uri=" prefix="html"%> taglib uri=" prefix="logic"%> <html> <head> <title>example.jsp</title> </head> <body> <html:form action="/example">... sample code... </html:form> </body> </html> Füge innerhalb des <html:form> Elements das erste Beispiel ein. Beispiel 1 Das Attribut property des <html:select> Elements weist auf unsere Eigenschaft selecteditem im Form-Bean, die nachdem Abschicken des Formulars den ausgewählten Wert beinhaltet. In diesem Bespiel wird das Attribut collection genutzt, was auf die in der Action Klasse im Request abgelegte Collection von Kunden (Customers) weisst. Das Attribut property gibt den Wert, der beim Abschicken des Formulars übertragen wird an. In diesem Fall die Eigenschaft id der Customer Klasse. labelproperty wird genutzt um den Anzeigetext (Label) des HTML <option> Elements zu setzen und bezieht auf die Eigenschaft name der Customer Klasse. <h4>use collection attribute of the <html:options> Tag</h4> <html:options collection="customers" property="id" labelproperty="name" /> <html:submit/> Beispiel 2 Im zweiten Beispiel wird ohne das collection Attribut gearbeitet. Wir weisen mit dem Attribut property direkt auf die Collection customervalues in unserem Form-Bean. Mit labelproperty beziehen wir uns auch hier auf eine Collection customerlabels innerhalb unseres Form-Beans, welche die Anzeigetexte (Labels) für die HTML <option> Elemente beinhaltet. <h4>use property attribute of the <html:options> Tag</h4> <html:options property="customervalues" labelproperty="customerlabels" />

5 <html:submit/> Das Projekt kann jetzt getestet werden. Rufe das Projekt über folgende URL auf.