基础:学习Struts提供的和Form相关标签
在本文系列的第一部分中我讲述了如何使用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>Password: < 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>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>
注重,< 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"
rows="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"/>Please send me notification
会被转换成:< input type="checkbox" name="notify"
value="on">Please 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:option value=
"r">red< /html:option>
< html:option value=
"g">green< /html:option>
< html:option value=
"b">blue< /html:option>
< /html:select>
会被转换成:< select name="color" size="3">< option
value="r">red< /option>
< option value="g">green< /option>
< option value="b">blue< /option>
< /select>
在本文系列的第二部分,你学到了一些更重要的和form相关的标签。在使用这些标签之前,你必须依照一些规则以便正确地运用它们。第三部分将讲述如何在真正的程序中使用这些标签。