Struts标签库详解(二)
<form>标签系列
使用<form>标签时必须遵循一些规则：
1.
标签中必须包含一个
action
属性，它是这个标签中唯一必需的属性。如果不具备该属性则
JSP
页面会抛出一个异常。之后你必须给这个
action
属性指定一个有效值。一个有效值是指应用程序的
Struts
配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个
name
属性，它的值是
form bean
的名称。
|
<html:form action=\"/login\" > 如果你有上述一个标签 ，那么你的 Struts 配置文件的元素中必须有一个如下显示为粗体的元素： <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 相关联的。 |
2.
3.
任何包含在
<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 属性时你需要给它指定元素的名称。
|
<body> <html:form action=\"/login\" focus=\"password\"> User Name: <html:text property=\"userName\"/> <br>Password: <html:text property=\"password\"/> <br><html:submit/> </html:form> </body> 代码解析后： <body> <form name=\"loginForm\" method=\"post\" action=\"/myStrutsApp/login.do\"> User Name: <input type=\"text\" name=\"userName\" value=\"\"> <br>Password: <input type=\"text\" name=\"password\" value=\"\"> <br><input type=\"submit\" value=\"Submit\"> </form> <script language=\"JavaScript\" type=\"text/javascript\"> <!-- if (document.forms[\"loginForm\"].elements[\"password\"].type != \"hidden\") document.forms[\"loginForm\"].elements[\"password\"].focus() // --> </script> </body> |
有没有看到这个标签库是如何建立
JavaScript
来定焦到
password
元素上的
?
这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程，它会帮你自动生成。
还可以看到， <form> 标签中 method 属性的缺省值是 POST 。
<text> 标签、 <hidden> 标签、 <textarea> 标签、 <radio> 标签、 <checkbox> 标签、 <submit> 标签、 <reset> 标签：
都有一个 property 属性，最后会被转换成 HTML 中的 name 属性，当然还有 name 和 value 属性。
<password> 标签
还可以看到， <form> 标签中 method 属性的缺省值是 POST 。
<text> 标签、 <hidden> 标签、 <textarea> 标签、 <radio> 标签、 <checkbox> 标签、 <submit> 标签、 <reset> 标签：
都有一个 property 属性，最后会被转换成 HTML 中的 name 属性，当然还有 name 和 value 属性。
<password> 标签
|
<html:password property=\"password\" redisplay=\"false\"/>
|
该标签中的一个很重要的属性是
"redisplay"
，它用于重新显示以前输入到这个区域中的值。该属性的缺省值为
true
。然而，为了使
password
不能被重新显示，你或许希望将该属性的值设为
false
。
<select> 标签和 <option> 标签：
<select> 标签和 <option> 标签：
|
<html:select property=\"color\" size=\"3\"> <html:option value=\"r\">red</html:option> <html:option value= \"g\">green</html:option> <html:option value= \"b\">blue</html:option> </html:select> |
遗补
：
1.)<html:link>
标签
forward
属性：链接到一个
global forward
上；
action
属性：链接到一个
action mapping
上；
href 属性：这个链接会转发给控制器，由控制器做决定； page 属性：一个相对的链接。
用 page 属性链接到 action 上：
href 属性：这个链接会转发给控制器，由控制器做决定； page 属性：一个相对的链接。
用 page 属性链接到 action 上：
|
<html:link page="/html-link.do"> Linking with the page attribute. </html:link> |
注意，上面的代码中你不必指定 web 的关联。相反的，如果你使用 href 属性，你就必须像下面所示指出 web 的关联 ( 这里的关联就是 struts-exercise) ：
|
<html:link href="/struts-exercise-taglib/html-link.do"> Using Href </html:link> |
很明显，当你在相同的 web 应用程序中做链接是，它比 page 属性更加好。你也能用 href 在不同的服务器上创建链接：
|
<html:link href="http://otherserver/strutsTut/html-link.do"> Using Href </html:link> |
另一种链接到 html-link.do 的方法是用 action 属性：
|
<html:link action="/html-link"> Using Action attribute </html:link> |
你也可以以硬编码的方式使用参数：
|
<html:link page="/htmllink.do?doubleProp=3.3&longProp=32"> Double and long via hard coded changes </html:link> |
或者使用 paramId, paramName, and paramProperty 属性：
|
<html:link page="/html-link.do" paramId="booleanProperty" paramName="testbean" paramProperty="nested.booleanProperty"> Boolean via paramId, paramName, and paramValue </html:link> |
解析后的代码：
|
<a href="/struts-exercise-taglib/html-link.do?booleanProperty=false"> Boolean via paramId, paramName, and paramValue </a> |
另外，还能使用带 name 属性的 Map 来实现传递多个参数：
|
<% java.util.HashMap newValues = new java.util.HashMap(); newValues.put("floatProperty", new Float(444.0)); newValues.put("intProperty", new Integer(555)); newValues.put("stringArray", new String[] { "Value 1", "Value 2", "Value 3" }); pageContext.setAttribute("newValues", newValues); %> ... <html:link action="/html-link" name="newValues"> Float, int, and stringArray via name (Map) </html:link> |
你也能够链接到 Map 类型的 action 上，上面的代码解析后的结果：
|
<html:messages property="property2" message="true" id="msg" header="messages.header" footer="messages.footer"> <tr><td><%= pageContext.getAttribute("msg") %></td></tr> </html:messages> |
2.) select
和
option
标签
<html:select> 的属性： property －与 ActionForm 中的某个属性对应； size －显示 option 的数目； multiple －默认为 fales ，表示不能多选，当设定为 true 时， property 对应的 ActionForm 的属性必须为数组。
<html:select property="name" size=6 multiple="true">
<html:option> 的属性： key 、 local 、 bundle －指定 Resource Bundle 中的内容。
例如 <html:option value="color1">Orange</html:option>
<html:option value="color1" bundle="htmlselect.Colors" key="htmlselect.red"/>
它和配置文件中的 <message-resources> 元素的 key 属性匹配 --> <message-resource parmeter="HtmlSelectColors" key="htmlselect.Colors"/>
<message-resource> 中配置的资源文件为 HtmlSelectColors.properties ，相关内容为 htmlselect.red=RED
<html:options> 标签，提供了一组 <option> 元素，在 <html:select> 元素中可以包含多个 <html:options> 元素。非常灵活，可以取得集合或数组中的值。
例 1 <html:options collection="coll" property="value" labelProperty="label" /> 这指在 coll 的集合中存放了 options ， value 指实际能被提交的值， label 是显示给用户的值。
例 2 <html:options property="value" labelProperty="label" /> collection 属性不被指定时，将使用表单相关的 form bean ， form bean 中 value 属性存放 option value ， label 属性值显示给用户。
例 3 <html:options name="valueBean" property="values" labelName="labelsBean" labelProperty="labels" /> 这个意思是 value 值存放在名为 valueBean 的 bean 的 vlaues 属性中，它是一个 collection ； label 值也是同样的意思。
<html:optionsCollection> 标签，和 <html:options> 的用法很相似。
例如 <html:select property="custId"><html:optionsCollection property="customers" label="name" value="custId" /></html:select>
这个标签和 org.apache.structs.util.LabelValueBean 结合的很好，如果把 label 和 value 都放到这个对象中，可以很简单的这样应用：
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>
<html:select> 的属性： property －与 ActionForm 中的某个属性对应； size －显示 option 的数目； multiple －默认为 fales ，表示不能多选，当设定为 true 时， property 对应的 ActionForm 的属性必须为数组。
<html:select property="name" size=6 multiple="true">
<html:option> 的属性： key 、 local 、 bundle －指定 Resource Bundle 中的内容。
例如 <html:option value="color1">Orange</html:option>
<html:option value="color1" bundle="htmlselect.Colors" key="htmlselect.red"/>
它和配置文件中的 <message-resources> 元素的 key 属性匹配 --> <message-resource parmeter="HtmlSelectColors" key="htmlselect.Colors"/>
<message-resource> 中配置的资源文件为 HtmlSelectColors.properties ，相关内容为 htmlselect.red=RED
<html:options> 标签，提供了一组 <option> 元素，在 <html:select> 元素中可以包含多个 <html:options> 元素。非常灵活，可以取得集合或数组中的值。
例 1 <html:options collection="coll" property="value" labelProperty="label" /> 这指在 coll 的集合中存放了 options ， value 指实际能被提交的值， label 是显示给用户的值。
例 2 <html:options property="value" labelProperty="label" /> collection 属性不被指定时，将使用表单相关的 form bean ， form bean 中 value 属性存放 option value ， label 属性值显示给用户。
例 3 <html:options name="valueBean" property="values" labelName="labelsBean" labelProperty="labels" /> 这个意思是 value 值存放在名为 valueBean 的 bean 的 vlaues 属性中，它是一个 collection ； label 值也是同样的意思。
<html:optionsCollection> 标签，和 <html:options> 的用法很相似。
例如 <html:select property="custId"><html:optionsCollection property="customers" label="name" value="custId" /></html:select>
这个标签和 org.apache.structs.util.LabelValueBean 结合的很好，如果把 label 和 value 都放到这个对象中，可以很简单的这样应用：
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>