建立一个Login表单
这是一个Login表单的简单示例,这个示例显示了通过Struts来处理表单比通过HTML和标准的JSP来处理表单轻松很多。请参看下面这个叫logon.jsp的页面(基于Struts包括的MailReader例子):
<%@ page language="java" %>
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
<html:html>
<head>
<title>
<bean:message key="logon.title"/>
</title>
</head>
<body bgcolor="white">
<html:errors/>
<html:form action="/logon" focus="username">
<table border="0" width="100%">
<tr>
<th class="right">
<bean:message key="prompt.username"/>
</th>
<td class="left">
<html:text property="username" size="16"/>
</td>
</tr>
<tr>
<th class="right">
<bean:message key="prompt.password"/>
</th>
<td class="left">
<html:password property="password" size="16"/>
</td>
</tr>
<tr>
<td class="right">
<html:submit>
<bean:message key="button.submit"/>
</html:submit>
</td>
<td class="right">
<html:reset>
<bean:message key="button.reset"/>
</html:reset>
</td>
</tr>
</table>
</html:form>
</body>
</html:html>
这个例子中,以下的这些元素代表了Struts处理表单的特征:
taglib告诉JSP页面编译器到什么地方去找到Struts标记库的标记库描述文件。在这个例子中,我们使用bean作为struts-bean标记库的标记的前缀;html作为struts-html标记库的标记的前缀,当然,也可以使用其他需要的前缀。这个页面使用了多个message标记来在MessageResources对象中查找国际化的消息字符串,这个对象包括了此应用中所有的资源。为了这个页面能正常工作,在这个资源对象中必须定义下面的消息键:logon.title -logon页面的标题prompt.username - 一个“用户名”字符串prompt.password - 一个“密码”字符串button.submit - 提交按钮上的文字button.reset - 重设按钮上的文字当用户登录的时候,应用在用户的会话中存储一个Locale对象,这个Locale对象将会被用来选择适合语言的消息。这使得实现用户选择语言的功能很容易——只需要简单的改变存储的Locale对象,则所有的消息都会自动的变换语言了。errors标记显示商业逻辑组件产生的任何错误消息,或者如果没有错误的话,什么也不显示。这个标记会在后面描述。form标记基于给定的属性实现了HTML的<form>,它把所有在这个表单内的域与一个ActionForm的bean [org.apache.struts.action.ActionForm]联系起来。这个标记在Struts配置文件中查找/logon对应的Action。在配置文件中,logon的对应告诉这个标记,在会话中存储的表单bean使用的名称为logonForm。Struts开发者从Struts类ActionForm继承实现这个bean的Java代码。这个bean被用来初始化名字与类中属性相对应的表单域。如果适合的bean没有找到,一个新bean将会自动的建立起来,并使用从action对应中指定的Java类名。这个表单bean也能在标记中通过name和type属性来指定,但是通常,所有的东西都通过Struts配置文件来指定。text标记实现了HTML中的<input>的text类型。在这个例子中,浏览器中显示的字符数量也被指定好了。当这个页面执行时,对应的bean中的username属性的当前值会被显示(也就是getUsername返回的值)。password标记也是类似的,不同之处在于浏览器会显示星号,因为用户录入的是密码。submit和rest标记在表单的底部产生对应的按钮。每个按钮上显示的文字通过message标记来显示,所以这些文字都是国际化的。处理带文件上传的表单也很容易。显然地,当你建立一个带文件上传的表单时,你就是在建立一个至少含有一个输入类型为“file”的表单。建立这样表单的第一步是使用struts-html类库去建立表示页面:
<%@page language="java">
<%@taglib
uri="/WEB-INF/struts-html.tld"
prefix="html">
<html:form action="uploadAction.do" enctype="multipart/form-data">
Please Input Text: <html:text property="myText">
Please Input The File You Wish to Upload: <html:file property="myFile">
<html:submit />
</html:form>
下一步是建立你的ActionForm:
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.upload.FormFile;
public class UploadForm extends ActionForm {
protected String myText;
protected FormFile myFile;
public void setMyText(String text) {
myText = text;
}
public String getMyText() {
return myText;
}
public void setMyFile(FormFile file) {
myFile = file;
}
public FormFile getMyFile() {
return myFile;
}
}
查阅FormFile的Javadocs去了解它在文件上传时处理文件的方法,查阅ActionServlet和ActionMapping的Javadocs去了解你可以指定不同的参数去控制文件怎样被上传。在你的Action类的execute方法中,你可以调用((UploadForm)form).getMyFile()去得到FormFile对象并对它做你想做的事情。