Struts提供的和Form相关的标签

梦段桥 · 发表于 2007-2-1 22:27

学习Struts提供的和Form相关的标签
继续学习Struts提供的HTML标签库。by Budi Kurniawan
在本文系列的第一部分中我讲述了如何使用Struts提供的HTML标签库来配置一个Struts应用程序。我还介绍了该标签库中的一类标签：独立使用的标签。在第二部分中我将继续介绍第二类标签：与form相关的标签。与form相关的标签包括<form>标签本身以及所有必须包含在其中的标签。比如，<text>和<password>标签就是和form相关的标签，因为如果不把它们放到一个form中它们就没有意义。
<form>标签
<form>标签用于生成一个HTML form。使用该标签时必须遵循许多规则。
首先，<form>标签中必须包含一个action属性，它是这个标签中唯一必需的属性。如果不具备该属性则JSP页面会抛出一个异常。之后你必须给这个action属性指定一个有效值。一个有效值是指应用程序的Struts配置文件中<action-mappings>元素里的任何一个<action>子元素的访问路径。而且相应的<action>元素中必须有一个name属性，它的值是form bean的名称。例如，如果你有这样一个<form>标签：
<html:form action=\"/login\" >
那么你的Struts配置文件的<action-mappings>元素中必须有一个如下显示为粗体的<action>元素：
<action-mappings>
<action path=\"/login\"
type=\"com.javapro.struts.LoginAction\"
name=\"loginForm\"
scope=\"request\"
input=\"/login.jsp\">
<forward name=\"success\" path=\"/mainMenu.jsp\"/>
</action>
</action-mappings>
这就是说一个form标签是和form bean相关联的。
另一个要遵循的规则是：任何包含在<form>中用来接收用户输入的标签（<text>、<password>、<hidden>、<textarea>、<radio>、<checkbox>、<select>）必须在相关的form bean中有一个指定的属性值。比如，如果你有一个属性值被指定为“username”的<text>标签，那么相关的form bean中也必须有一个名为“username”的属性。输入<text>标签中的值会被用于生成form bean的userName属性。
除了上面所讲的属性之外，<form>标签还有一些不是必须但加上更好的“次要”的属性。比如，你可以用focus属性来生成JavaScript，它会“定焦”（focus）到该form所包含的一个元素上。使用focus属性时你需要给它指定元素的名称。比如，以下代码是定焦在第二个Text元素上的：
<body>
<html:form action=\"/login\" focus=\"password\">
User Name: <html:text property=\"userName\"/>
<br>

assword: <html:text property=\"password\"/>
<br><html:submit/>
</html:form>
</body>
该段代码会被转换成：
<body>
<form name=\"loginForm\" method=\"post\" action=\"/myStrutsApp6/login.do\">
User Name: <input type=\"text\" name=\"userName\" value=\"\">
<br>

assword: <input type=\"text\" name=\"password\" value=\"\">
<br><input type=\"submit\" value=\"Submit\">
</form>
<script language=\"JavaScript\" type=\"text/javascript\">

</script>
</body>
注意，<form>标签中method属性的缺省值是POST。另外，有没有看到这个标签库是如何建立JavaScript来定焦到password元素上的? 这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程，它会帮你自动生成。
在运行前面的例子时还要注意，你必须有一个包含userName和password属性的相关form。你可以参考本文第三部分中的Login程序。
<text>标签
<text>标签用于生成一个文本的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个<form>标签中时才有效。
例如：<html:text property=\"userName\"/>
会被转换成：<input type=\"text\" name=\"userName\" value=\"\">
<password>标签
<password>标签用于生成一个口令字（type password）的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个<form>标签中时才有效。该标签中的一个很重要的属性是“redisplay”，它用于重新显示以前输入到这个区域中的值。该属性的缺省值为true。然而，为了使password不能被重新显示，你或许希望将该属性的值设为false。
例如： <html:password property=\"password\" redisplay=\"false\"/>
会被转换成: <input type=\"password\" name=\"password\" value=\"\">
<hidden>标签
<hidden>标签用于生成一个隐藏文本的输入区域。它必须包含和相关form bean中的相同属性对应的“property”属性。该标签只有在嵌入到一个<form>标签中时才有效：
例如： <html:hidden property=\"userName\"/>
会被转换成: <input type=\"hidden\" name=\"userName\" value=\"\">
<textarea>标签
<textarea>标签用于生成一个文本区元素（text area element）。它必须包含和相关form bean中的相同属性对应的“property”属性。
比如： <html:textarea property=\"details\" cols=\"80\"ｒows=\"20\" value=\"Enter details here\"/>
会被转换成：<textarea name=\"details\" cols=\"80\" rows=\"20\">Enter details here</textarea>
<radio>标签
<radio>标签用于显示一个单选按钮（radio button）。它必须包含“value”属性。比如这段代码：
<html:radio property=\"title\" value=\"1\"/>Mr.
<html:radio property=\"title\" value=\"2\"/>Ms.
<html:radio property=\"title\" value=\"3\"/>Dr.
会被转换成这样的HTML：
<input type=\"radio\" name=\"title\" value=\"1\">Mr.
<input type=\"radio\" name=\"title\" value=\"2\">Ms.
<input type=\"radio\" name=\"title\" value=\"3\">Dr.
<checkbox>标签
<checkbox>标签用于显示checkbox类型的输入区域。比如：
<html:checkbox property= \"notify\"/>

lease send me notification
会被转换成：<input type=\"checkbox\" name=\"notify\" value=\"on\">

lease send me notification
<submit>标签
<submit>标签用于生成提交类型（type submit）的输入区域。比如：
<html:submit value=\"Login\"/>
会被转换成：<input type=\"submit\" value=\"Login\">
<reset>标签
<reset>标签用于生成重置类型（type reset）的输入区域。比如：
<html:reset/>
会被转换成：
<input type=\"reset\" value=\"Reset\">
<option>标签
<option>标签用于显示select box中的一个选项。参照下面的<select>标签。
<select>标签
<select>标签用于显示一个包含零个或更多选项的HTML选择元素。它必须被嵌入一个<form>标签中才有效。下面这个例子将说明如何使用该标签：
<html:select property=\"color\" size=\"3\">
<html

ption value=\"r\">red</html

ption>
<html

ption value=\"g\">green</html

ption>
<html

ption value=\"b\">blue</html

ption>
</html:select>
会被转换成：
<select name=\"color\" size=\"3\"><option
value=\"r\">red</option>
<option value=\"g\">green</option>
<option value=\"b\">blue</option>
</select>
在本文系列的第二部分，你学到了一些更重要的和form相关的标签。在使用这些标签之前，你必须依照一些规则以便正确地运用它们。第三部分将讲述如何在真正的程序中使用这些标签。

Bean标记库：
使用该标记前首先要在jsp的页面导入相应的标记定义，例如
<%@ taglib uri=\"/WEB-INF/struts-bean.tld\" prefix=\"bean\" %>。
使用的方法如<bean:*** id=””/>。
下面对该标记库做一介绍：
　　１．　cookie ：属性有id,name , multiple,value，id是对cookie在该页面中的唯一标识，在页面其它地方可以通过id进行引用。相当于用cookie直接引用。Name是相应的cookie名称。Multiple可以赋予任意值，如果该值被定义将会返回相应给定值数量的cookie数组，如果该值没有被定义Value在这里是一个默认值，当我们这里的调用的cookie不存在时，其值为我们这里的value值。
　　２．define：相当于jsp标记<jsp:useBean>，属性有id、name、property、scope、toScope、type、value。Id和cookie中的id起到了同样的作用；name是在相应的scope中唯一bean标识；scope将会在相应的范围内进行相应的查找；toScope如果在scope中找不见相应的bean，将会在toScope中建立相应的bean；type是该类完全类路径和类。
例如：
<bean:define id=\"submitForm\" scope=\"session\" name=\"submitForm\"
type=\"struts.test.SubmitActionForm\"/>
<%=submitForm.getName()%>

例如：
<jsp:useBean id=\"test1\" scope=\"page\"
class=\"org.apache.struts.webapp.exercise.TestBean\"/>
<bean:define id=\"test1_string\" name=\"test1\" property=\"stringProperty\"/>
<bean:define id=\"test1_value\" value=\"ABCDE\"/>
<%= test1_string %>
<%= test1_value %>

　　　３．header：通过该标记可以访问相应页面请求的头的信息，具体属性有id、multiple、name、value。具体的含义和cookie的类似。
例如：<%java.util.Enumeration names = ((HttpServletRequest) request).getHeaderNames();%>
<%while (names.hasMoreElements()) {
String name = (String) names.nextElement();
%>
<bean:header id=\"head\" name=\"<%= name %>\"/>
<tr>
<td><%= name %></td>
<td><%= head %></td>
</tr>
<%}%>
　　　　４．Include：属性有id、name、forward、anchor、href、transacttion、page。属性的说明参考相应apache的网站。
例如：<bean:include id=\"index\" page=\"/index.jsp\"/>
<%=index%>
message: 不常用，这里忽略。
page:不常用，这里忽略。
Parameter:属性有id、name、value、multiple。用来输出客户端的请求参数和值。
例如：<bean:parameter id=\"param1\" name=\"param1\"/>
<bean:parameter id=\"param3\" name=\"param3\" value=\"UNKNOWN VALUE\"/>
<%=param1%><br>
<%=param3%>
resource:属性有id、name、input。如果input属性被定义为任意值，导入的资源将会返回一个InputStream对象。如果不被定义的话，资源将会以字符串的方式返回。
例如：<bean:resource id=\"webxml\" name=\"/WEB-INF/web.xml\"/>
<bean:write name=\"webxml\" filter=\"true\"/>
size:用来对Cellection 或者Map类型的数据进行元素个数统计。属性有：id、collection、name、property、scope。
例如：<%
java.util.ArrayList data = new java.util.ArrayList();
data.add(\"First\");
data.add(\"Second\");
data.add(\"Third\");
data.add(\"Fourth\");
data.add(\"Fifth\");
pageContext.setAttribute(\"list\", data, PageContext.PAGE_SCOPE);
%>
<bean:size id=\"dataSize\" collection=\"<%= data %>\"/>

<jsp:useBean id=\"list\" scope=\"page\" class=\"java.util.ArrayList\"/>
<bean:size id=\"listSize\" name=\"list\"/>
struts: 不常用，这里忽略。
Write: 属性有bundle、filter、format、formatKey、ignore、local、name、property、scope。具体用法请参阅相关网站。
Html标记库：
使用该标记库首先要在相应的页面中引入标记库定义文件，如：
<%@ taglib uri=\"/WEB-INF/struts-html.tld\" prefix=\"html\" %>。其实该标记库的大多数标记可以用html的标记来实现。这里值对其无法用html实现的几个标记进行介绍。
Error: 属性有：bundle、name、property、local。如果以上属性都不定义，将会从对属性文件中的所有error.***错误信息显示出来。Bundle，邦定的错误信息管理器，如果没有定义，将默认是由action创建的应用程序级错误管理器。Name和property用来配合从相应的页面中调用错误信息管理bean来显示错误信息。Local是一个错误信息本地化处理器，默认会用是和本地的方式处理本地化。
属性资源文件中应该包含如下相应的信息，对错误信息的现实进行格式化：
errors.header 所有错误信息前面显示的内容，可以进行html修饰
errors.footer 所有错误信息后面的显示内容，可以进行html修饰
errors.prefix 每条错误信息前面的显示信息，可以进行html修饰
errors.suffix 每条错误信息后面的显示信息，可以进行html修饰
message: 属性有bundle、footer、header、id、local、message、property、name.具体的用法请参阅相关网站。
Logic标记库：使用该标记库首先要在相应的页面中引入标记库定义文件，如：<%@ taglib uri=\"/WEB-INF/struts-logic.tld\" prefix=\"logic\" %>，具体的标记有：
Empty: 属性有name、property、scope。
Equal: 属性有cookie、header、name、parameter、property、scope、value。其中cookie和header、parameter是独立使用的。Name和property、scope结合使用，是相对系统中的bean的。如果是系统中某一个简单的参数，可以用name和scope结合就可以了。
Forward: 属性只有name。
GreaterEqual: 属性和equal一样。
GreaterThan：属性和equal一样。
LessEqual: 属性和equal一样。
LessThan: 属性和equal一样。
NotEmpty: 属性和empty一样。
Match: 属性和equal一样。
NotMatch：属性和equal一样。
NotEqual: 属性和equal一样。
NotPresent: 属性有coolie、header、name、property、parameter、scope、role、user。
Present:和notPresent一样。
MessageNotPresent:属性有message、name、property。
MessagePresent: 和messageNotPresent一样。
Iterate：属性有collection、id、indexId、scope、name、property、length、offset、type。

帐号		自动登录	找回密码
密码			成为会员