Struts 2 UI 标签教程

来源：互联网发布：派尔玻璃优化排版软件编辑：程序博客网时间：2024/05/16 10:05

Struts 2 UI 标签例题

Struts 2 UI 标签简单易用。你不需要编写HTML代码，UI标签会根据你选择的主题自动生成。默认情况是XHTML主题，XHTML主题使用表格来布置元素。

在这个例子中，你将看到如何用Struts 2 UI标签生成一个注册页面。你也将学习如何预填充表单域，设置默认值和在jsp页面得到返回值。

代码如下：

<%@ page language="java" contentType="text/html; charset=ISO-8859-1"pageEncoding="ISO-8859-1"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><%@taglib uri="/struts-tags" prefix="s"%><html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Register Page</title></head><body><s:form action="Register"><s:textfield name="userName" label="User Name" /><s:password name="password" label="Password" /><s:radio name="gender" label="Gender" list="{'Male','Female'}" /><s:select name="country" list="countryList" listKey="countryId"listValue="countryName" headerKey="0" headerValue="Country"label="Select a country" /><s:textarea name="about" label="About You" /><s:checkboxlist list="communityList" name="community" label="Community" /><s:checkbox name="mailingList"label="Would you like to join our mailing list?" /><s:submit /></s:form></body></html>

如果你查看这个页面的源代码，你可以看到基于XHTML主题生成的HTML代码。

Struts 2 值栈(ValueStack)

现在让我们来理解UI标签是如何工作的。值栈(ValueStack)是存储处理请求关联数据的地方。所以表单的所有属性都被存储在值栈(ValueStack)上。UI标签的name属性和值栈(ValueStack)的属性链接。

我们还需要理解UI标签的另外一个重要的属性value。如果你想给特定领域设定一些默认值，那么你需要给value属性设定值。

下面是一个将textfield的默认值设置为"Eswar"的例子：

<s:textfield name="userName" label="User Name" value="Eswar"/>

在这里我们直接在jsp页面赋值，如果你想通过动作(action)赋值，你可以设置一个像defaultName的属性并将它的值设置为需要的名称。我们可以这么写：

<s:textfield name="userName" label="User Name" value="defaultName"/>

这个defaultName属性存储在值栈(ValueStack)上，所以它的值将被赋给textfield。如果你认为你不需要单独属性，你可以设置userName属性并给它赋上需要的值。在这个例子中，我们并不需要给value属性赋值，给community赋值的时候就是采用这种方式。

在UI标签的label属性里赋值，在生成HTML的时候它被用来给label赋值。

现在我们来看看下面的代码。在框架中index.jsp将被首先调用。

index.jsp ~~~~~~~~~ <META HTTP-EQUIV="Refresh" CONTENT="0;URL=populateRegister.action">

在这里，根据在struts.xml文件中设置的映射，将请求转发到populateRegister URL，RegisterAction类的populate()方法将被调用。这里的映射方法是Struts 2的特性，动态方法调用。struts.xml内容如下：

<!DOCTYPE struts PUBLIC"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN""http://struts.apache.org/dtds/struts-2.0.dtd"><struts> <package name="default" extends="struts-default"> <action name="*Register" method="{1}" class="vaannila.RegisterAction"> <result name="populate">/register.jsp</result> <result name="input">/register.jsp</result> <result name="success">/success.jsp</result> </action> </package></struts>

注册动作类包含表单的属性和相应的getter和setter方法。它还包含execute()和populate()方法。在populate方法中，首先为了表单域填充和设置默认值。RegisterAction类的内容如下：

package vaannila;import java.util.ArrayList;import com.opensymphony.xwork2.ActionSupport;public class RegisterAction extends ActionSupport {private String userName;private String password;private String gender;private String about;private String country;private ArrayList<Country> countryList;private String[] community;private ArrayList<String> communityList;private Boolean mailingList;public String populate() {countryList = new ArrayList<Country>();countryList.add(new Country(1, "India"));countryList.add(new Country(2, "USA"));countryList.add(new Country(3, "France"));communityList = new ArrayList<String>();communityList.add("Java");communityList.add(".Net");communityList.add("SOA");community = new String[]{"Java",".Net"};mailingList = true;return "populate";}public String execute() {return SUCCESS;}public String getUserName() {return userName;}public void setUserName(String userName) {this.userName = userName;}public String getPassword() {return password;}public void setPassword(String password) {this.password = password;}public String getGender() {return gender;}public void setGender(String gender) {this.gender = gender;}public String getAbout() {return about;}public void setAbout(String about) {this.about = about;}public String getCountry() {return country;}public void setCountry(String country) {this.country = country;}public ArrayList<Country> getCountryList() {return countryList;}public void setCountryList(ArrayList<Country> countryList) {this.countryList = countryList;}public String[] getCommunity() {return community;}public void setCommunity(String[] community) {this.community = community;}public ArrayList<String> getCommunityList() {return communityList;}public void setCommunityList(ArrayList<String> communityList) {this.communityList = communityList;}public Boolean getMailingList() {return mailingList;}public void setMailingList(Boolean mailingList) {this.mailingList = mailingList;}}

Textfield和Password标签

让我们来详细的看看UI标签。textfield标签用来创建一个文本域，password标签用来创建一个密码域。

<s:textfield name="userName" label="User Name" /><s:password name="password" label="Password" />

Radio标签

使用radio标签创建radio按钮。radio标签的list属性用来指定option的值。list属性的值可以是Collection，Map，Array或Iterator。这里我们使用的Array。

<s:radio name="gender" label="Gender" list="{'Male','Female'}" />

Select标签

使用select标签显示国家的下拉菜单。这里使用RegisterAction类的countryList属性为option赋值。countryList是值为Country类型的ArrayList类型。Country类型包含countryId和countryName两个属性。countryName是显示在前端的值，countryId是后端的值。这里countryName作为键，countryId作为值。在select标签里通过listKey和listValue属性来设置。初始键和值，可以用headerKey和headerValue属性来设置。

<s:select name="country" list="countryList" listKey="countryId" listValue="countryName" headerKey="0" headerValue="Country" label="Select a country" />

Textarea标签

textarea标签用来创建一个textarea。

<s:textarea name="about" label="About You" />

Checkboxlist标签

checkboxlist标签和select标签有些类似，不同的是它显示的是复选框并不是下拉框。它返回值是一个字符串数组。

<s:checkboxlist list="communityList" name="community" label="Community" />

Checkbox标签

checkbox标签返回一个布尔类型值，也就是说选中的话返回真值，相反返回假值。

<s:checkbox name="mailingList" label="Would you like to join our mailing list?" />

Submit标签

submit标签用来创建提交按钮。

<s:submit />

现在让我们输入每一项并提交表单。在RegisterAction类中的execute()方法将被调用并且画面将被转到success.jpg画面。

success.jsp ----------- <%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><%@taglib uri="/struts-tags" prefix="s"%><html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Details Page</title></head><body>User Name: <s:property value="userName" /> Gender: <s:property value="gender" /> Country: <s:property value="country" /> About You: <s:property value="about" /> Community: <s:property value="community" /> Mailing List: <s:property value="mailingList" /></body></html>

下面是演示画面：

展示提示信息画面：

源代码：下载

源代码 + lib：下载