Struts应用开发完全手册(html标签).doc

Struts应用开发完全手册Struts中HTML标签库中的大部分标签都与普通的HTML元素相对应，并且它们实现的功能与对应的HTML元素相同甚至更为强大。建议读者在Struts应用中使用Struts标签，因为这些标签与Struts中的其他组件是紧密相连的，使用这样的标签在编写程序时会带来很大的帮助。如：使用标签定义一个页面表单，Struts会将表单中的数据通过反射机制自动映射到与该表单对应的ActionForm Bean中。本章讲解的重要标签如下。 表单元素标签 下拉列表框标签 检查框标签 文件上传标签 与标签7.1 HTML标签库的使用在使用HTML标签库中的标签之前，要保证在当前应用的/WEB-INF/lib文件夹下存在struts.jar文件。该文件中包含了处理Struts中所有标签的类文件，然后再进行如下配置。（1）在应用程序下的/WEB-INF/文件夹下新建tld文件夹。（2）将Struts中的HTML标签库文件struts-html.tld复制到tld文件夹下。（3）在web.xml文件中进行如下配置。struts-html/WEB-INF/tld/struts-html.tld将struts-html.tld文件的路径定义为一个名称，以便在JSP文件中引用该名称来定义一个前缀，并通过该前缀来调用HTML标签库中的标签。（4）在要使用标签的JSP文件中，通过指令定义一个前缀来引用HTML标签库。7.2 页面初始化标签7.2.1 标签该标签对应HTML中的元素。标签中的lang属性设置为“true”时，标签会先在当前会话中查找Locale对象，并根据该Locale对象输出网页使用的语言。如果不存在session会话或者当前会话中没有Locale对象，则根据客户端的HTTP请求头中的accept-language属性值来输出网页使用的语言。若HTTP请求头中不存在accept-language属性，此时标签会根据默认的Locale来输出网页使用的语言。在Struts 1.2版本中，标签通过增加的lang属性来实现与Struts以前版本中locale属性相同的功能。但是在不存在session会话的情况下，使用locale属性的标签会创建一个session会话，用来保存来自HTTP请求中的Locale对象。该种方法要求应用必须支持session，已逐渐被lang属性取代。说明如下。 在程序中可通过内置对象request的getHeader(accept-language)方法查看请求头中包含的语言种类，这些语言可在浏览器菜单的“工具”/“因特网选项”命令下单击【语言】按钮出现的“语言首选项”对话框中进行添加或删除。当清空该对话框内的所有语言种类后，来自客户端的HTTP请求头中将不存在accept-language属性。 默认的Locale对象是在JVM启动时查询操作系统而设置的。例如：应用程序中某一JSP页面包含如下代码。Hello world!若客户端浏览器使用中文语言，则上述的JSP代码将被解析为如下HTML代码。Hello world!若客户端浏览器使用英语(美国)语言，则上述的JSP代码将被解析为如下HTML代码。Hello world!7.2.2 标签该标签对应HTML中的元素。标签中的server属性可以改变当前请求链接中服务器的名称；target属性指定打开目标页面的窗口或框架。若当前应用为Logon，其根目录下的index.jsp文件包含如下代码。 链接到XXX网站则标签会生成如下HTML元素。加上server和target属性的标签，则会生成如下HTML元素。此时页面中超链接的URL为“7:8080/Logon/default.jsp”，单击“链接到XXX网站”链接后会在新的窗口中显示响应信息。7.3 创建页面链接的标签7.3.1 通过标签链接到页面中的指定位置这种功能在很多地方是很实用的，它可以通过单击超链接将浏览器的当前显示定位到事先被标记的位置。比如在一篇篇幅较长的文章结尾处设置该功能，就可以快速回到文章的开始或其他位置。标签的linkName属性指定一个标记名称，即锚点。如将一篇文章的标题进行如下标记（假设当前应用为Blog，当前页面为MyBlog.jsp）。此处为文章标题的内容anchor属性指定要添加到当前链接中的锚点。如在一篇文章的结尾处编写如下 代码。回到顶部href属性值为，指定了链接的目标页面为当前页面MyBlog.jsp，还可以链接到其他页面中指定的锚点处。上述代码会生成如下HTML元素。回到顶部单击“回到顶部”链接后生成如下请求。http:/localhost:8080/Blog/MyBlog.jsp#top此时浏览器的当前显示就被定位到了文章的标题处。7.3.2 使用标签创建页面链接使用标签创建的超链接有以下4种方式。（1）action属性指定匹配Struts配置文件中,元素的path属性值的URI地址。（2）forward属性指定匹配Struts配置文件中,元素中定义的某个元素的name属性值的URI地址。（3）href属性指定URL链接地址。（4）page属性指定相对于当前应用的URI地址。下面分别通过几个示例向大家讲解使用forward属性、href属性和page属性创建超链接的方法。1通过forward属性创建全局转发链接标签的forward属性，对应Struts配置文件中的元素中的子元素的name属性值。如在Struts配置文件中进行如下配置。 在JSP文件中使用标签创建一个链接：显示错误信息！上述代码会生成如下HTML元素（假设当前应用为Logon）。显示错误信息！说明：如果在Struts配置文件中元素没有与标签的forward属性值匹配的子元素，即使在某个元素中有与之匹配的子元素，在运行时都会抛出异常。2通过href属性创建链接当href属性值以“/”开头时，链接地址为：协议+主机+端口+href属性值；当href属性值是一个完整的URL时，如，链接地址为href属性值；否则链接地址为当前地址+href属性值。假设当前应用为Logon，其根目录存在link.jsp和welcome.jsp文件，其中link.jsp文件包含以下代码：Welcome则上述代码生成的链接地址为“http:/localhost:8080/Logon/welcome.jsp”。若将href属性值改为“/welcome.jsp”，则生成的链接地址为“http:/localhost:8080/welcome.jsp”。3通过page属性创建链接通过page属性创建相对于当前应用的链接地址。page属性值应以“/”开头，通过该属性创建的链接地址为：当前应用程序路径+page属性值。假设当前应用为Logon，其根目录存在link.jsp和welcome.jsp文件，其中link.jsp文件包含以下代码：Welcome则上述代码生成的链接地址为“http:/localhost:8080/Logon/welcom.jsp”。若将page属性值改为“welcome.jsp”，则生成的链接地址为“http:/localhost:8080/Logonwelcome.jsp”。7.3.3 使用标签创建的链接传递参数下面为两种不同的实现方法。1将参数直接写入链接地址中该方法与利用HTML中元素创建的链接进行传递参数的方法相同。如：Welcome上述代码生成的HTML元素如下。Welcome2通过标签中的属性传递参数使用中的属性传递参数分为两种情况。（1）通过请求链接传递单个参数。如：Welcome上述代码实现的是将session范围中指定对象中的某个属性值赋予一个指定的参数，该参数会被写入链接地址中进行传递。其中的paramId属性用来指定一个添加到当前请求中的一个参数名；paramName属性指定一个对象，该对象的值将作为paramId属性指定参数的值；当paramName属性指定的对象为JavaBean时，则通过paramProperty属性来指定该JavaBean中的某个属性，Struts会调用该属性的getter()方法来获取值，并将该值作为参数的值。paramScope属性指定了查找paramName属性指定对象的范围，如果忽略了该属性，将按照页面、request请求、session会话和应用程序的顺序查找，并返回第一个匹配的对象。请看下面的两个例子（假设当前应用为Logon）。例1：某JSP文件中包含以下关键代码。将该变量作为参数通过链接进行传递。显示性别！上述代码生成如下HTML元素。显示性别！例2：假设userinfo为一个JavaBean实例对象，userinfo中存在username和userpwd两个属性，并且username=yxq，userpwd=123，将该JavaBean存入session范围中：session.setAttribute (userBean,userinfo)。将userinfo中的username属性值作为参数通过链接进行传递。显示用户名！上述代码生成如下HTML元素。显示用户名！（2）通过请求链接传递多个参数。通过标签传递多个参数时，需使用name属性来指定包含多个请求参数的Hashtable对象（或HashMap对象），Hashtable对象中的“关键字”与“值”分别代表请求中的“参数名称”与“参数值”。如：登录其中name属性指定了一个Hashtable对象的引用名userinfo,在该Hashtable对象中存储了用户名和密码。实现代码如下。scope属性指定了查找name属性指定对象的范围。如果忽略了该属性，将按照页面、request请求、session会话和应用程序上下文的顺序查找，并返回第一个匹配的对象。上述的标签会生成如下HTML元素（若当前应用程序名为office）。说明：“&”字符实体代表特殊字符“&”。标签可以输出一个由forward、href或page属性指定的URL，并且同样可以像标签那样向URL中写入参数。但该标签并不为指定的URL创建一个HTML中的元素，它可以应用到如下的代码中。 rewrite标签的应用 link type=text/css rel=stylesheet href=7.4 表单与基本表单元素标签7.4.1 表单标签该标签对应HTML中元素，用来创建一个表单。该标签必须包含action属性，否则会抛出异常。表单被提交后，ActionServlet会在struts-config.xml配置文件中找到相应的元素。该元素的path属性与标签的action属性匹配；并且标签会与该元素中name属性所指定的ActionForm Bean关联,以便自动填充表单中的元素。请看下面示例（假设当前应用程序为Logon）。若某JSP文件中包含以下代码： 则在struts-config.xml文件中需进行如下配置。 说明：标签中的focus属性用来设置当页面被加载时焦点的位置。该属性的值必须是当前表单中某个元素的property属性值。嵌入到表单中的表单元素标签（如：）在表单被提交后，会生成以property属性值为参数名、用户输入的内容为参数值的请求。如上面的代码在提交表单后生成如下请求（假设当前应用程序为Logon；name的输入值为“yxq”；password的输入值为“123”）。http:/localhost:8080/Logon/logon.do?name=yxq&password=1237.4.2 文本域输入标签该标签对应HTML中的元素，标签被嵌套在标签中成为表单元素。标签中的name属性指定了填充该元素的Bean，该Bean必须存在JSP的某个范围内（页面、request请求、session会话和应用程序）。若任何范围内不存在该Bean，就会抛出“Cannot find bean in any scope”异常。当忽略name属性时，则使用当前与标签关联的ActionForm Bean进行填充。至于使用Bean中的哪个属性值来填充该元素，是由标签中的property属性指定的，它是标签中必须存在的属性。如用来填充标签的Bean的关键代码如下。public class UserBean private String username=yxq; public void setName(string username) this.username=username; public String getName() return this.username; 说明：通常情况下要求将Bean中的属性名与表单元素标签中property属性值相同。实际上可以设为其他名字（如上面的代码），但必须要确保有与property属性值匹配的getXXX()和setXXX()方法，否则将抛出“No getter method for property name of bean org.apache.struts.taglib.html.BEAN”异常。建议读者在通常情况下将所有的表单元素标签使用与标签关联的ActionForm Bean进行填充。标签中的value属性指定了填充该元素的一个常量值，它可以是一个运行时刻表达式。该属性优先于Bean填充当前元素。7.4.3 密码输入标签该标签对应HTML中的元素，用于生成一个密码输入的组件。标签被嵌套在标签中成为表单的元素。标签必须包含property属性；name属性指定了填充该元素的Bean；redisplay属性值设为“false”时表示不会重新显示上次输入的内容，默认值为“true”。7.4.4 多行多列文本输入标签该标签对应HTML中的元素，用于生成多行多列的文本输入组件。标签被嵌套在标签中成为表单的元素。标签必须包含property属性；name属性指定了填充该元素的Bean；属性rows指定了要显示的行数，cols属性指定了要显示的列数。该标签用法与标签相似。7.4.5 隐藏的文本域输入标签该标签对应HTML中的元素，通常嵌入到标签中成为表单元素。标签用来存储隐藏的信息并可以在请求中传递该值。该标签必须包含property属性；name属性指定了填充该元素的Bean；write属性的默认值为“false”，将该属性值设为“true”时可以将隐藏的值输出到页面进行显示。用法与标签相似。7.4.6 提交按钮标签和复位按钮标签标签对应HTML中的元素，用于生成提交表单的按钮。该标签通常嵌入到标签中。value属性指定了按钮的标签，如：也可用如下代码生成提交按钮。Logon在标签中加入property属性后，当表单被提交后会生成一个在原来的基础上加入参数名(标签的property属性值)=值(标签的value属性值)的请求。当与标签关联的ActionForm中存在与property属性值匹配的setXXX()和getXXX()方法时，可以在Action类中实现不同提交按钮提交同一个表单进行不同的操作。标签对应HTML中的元素，用于生成表单的复位按钮。该标签的使用方法比较简单，这里不再具体介绍。下面通过一个范例向大家介绍如何实现不同提交按钮提交同一表单。范例07-01 不同提交按钮提交同一表单范例位置：mr07fl01录像位置：mr07lx01本范例主要向大家讲解如何通过不同的提交按钮提交同一个表单来实现不同的操作。如图7.1所示，在“输入X值”文本框中输入数字后，分别单击【计算表达式1】和【计算表达式2】提交按钮提交同一个表单，程序会根据用户的选择显示出相应的结果。 图7.1 多个提交按钮提交同一个表单 图7.1为运行index.jsp页面后进行不同操作的结果。图中包含两个标签、一个标签和两个标签。所以在与index.jsp页面表单对应的ActionForm中，应存在与表单元素对应的属性。值得注意的是：其中的两个标签对应ActionForm Bean中的同一个属性，而它们的value属性值要确保不相同。（1）先来配置struts-config.xml文件，其关键代码如下。 元素指定了解决Struts中汉字乱码问题的FormToChinese类。读者可参看本书中的20.6.6章节的相关介绍。（2）创建index.jsp文件，其关键代码如下。 多个提交按钮提交同一个表单 表达式1： + X = ? 表达式2： + X = ? 输入X值： 计算结果 %- 如果用户单击过提交按钮，则显示与标签间的内容 -% /如果表单验证通过 您进行了操作！ 结果： + = 在上面的代码中用到了Bean标签库和Logic标签库中的标签。其中标签用来判断是否存在指定的消息；标签用来判断是否不存在指定的消息；标签判断数据是否不相等；标签判断数据是否相等；标签用来输出指定的数据。Bean标签库与Logic标签库的详细讲解请参看本书第8章与第9章。（3）创建MoreSubForm类。该ActionForm Bean中的属性要对应index.jsp页面中表单的元素。其关键代码如下。package com.moresubmit.actionform;import javax.servlet.http.HttpServletRequest;import org.apache.struts.action.*;public class MoreSubForm extends ActionForm private String src; /用户输入的值 private int src_1; /对应标签 private int src_2; /对应标签 private int src1_2; /该属性存储了计算结果 private String doadd; /该属性对应标签 public ActionErrors validate(ActionMapping mapping, HttpServletRequest request) ActionErrors errors=new ActionErrors(); try Integer.parseInt(src); catch(Exception e) errors.add(notnum,new ActionMessage(not.num); return errors; /省略了属性的setXXX()与getXXX()方法validate()方法当表单中的数据填充与该表单关联的ActionForm Bean后被执行。该方法主要对用户输入的表单数据进行验证，返回一个ActionErrors类对象。若返回的ActionErrors对象为null或者ActionErrors中不包含任何ActionMessage或ActionError对象，则数据验证通过；否则验证失败，流程转向struts-config.xml文件中元素的input属性指定的页面。只有将相应的元素中validate的属性值设为“true”时，validate()方法才会被调用。（4）创建MoreSubAction类，该类处理用户的请求。具体代码如下。package com.moresubmit.action;import javax.servlet.http.*;import org.apache.struts.action.*;import com.moresubmit.actionform.*;public class MoreSubAction extends Action public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) HttpSession session=request.getSession(); MoreSubForm moresubform=(MoreSubForm)form; String src=moresubform.getSrc(); int one=moresubform.getSrc_1(); int two=moresubform.getSrc_2(); String subname=moresubform.getDoadd(); /获取用户触发的提交按钮的名称 if(subname.equals(计算表达式1) moresubform.setSrc1_2(one+Integer.parseInt(src); else if(subname.equals(计算表达式2) moresubform.setSrc1_2(two+Integer.parseInt(src); /将ActionFormBean存储到session会话中，这样Struts中的其他标签才可以对该ActionFormBean进行操作 session.setAttribute(moresubform,moresubform); return mapping.findForward(success); 7.4.7 取消请求标签将生成如下的HTML元素。单击该按钮后同样会提交表单，并且请求中会增加一个名为“org.apache.struts.taglib. html.CANCEL”的请求参数，此时Struts将不会调用ActionForm的validate()方法。Action类可通过调用自身的isCancelled(HttpServletRequest)方法获取的boolean型值来判断用户是否触发了取消事件，如果该值为“true”就表示取消事件发生，之后调用在Action类的execute()方法中编写的处理取消事件的相关代码。例如：用户按下了提交按钮进行文件上传的操作，在等待服务器回复响应的过程中，单击“取消”按钮触发取消事件，Action类捕获该事件后执行编写的清除操作来取消服务器执行的请求。7.5 下拉列表框标签7.5.1 标签该标签对应HTML中的元素，用于创建下拉列表框。标签嵌入到标签后成为表单的元素。该标签必须包含property属性。与该标签关联的ActionForm Bean中要存在与property属性值匹配的setXXX()和getXXX()方法。当页面被加载时，getXXX()方法返回的值决定了哪个列表项被选中；当选中列表中的某个列表项提交表单后，Struts通过setXXX()方法将ActionForm Bean中对应的属性设置为被选中列表项的值。该标签的其他重要属性如下。size：属性指定显示在页面中可见的列表项数目。multiple：属性表示是否支持同时选择多项。忽略该属性时表示单项选择，此时与该标签关联的ActionForm Bean中与property属性对应的属性类型为String型。将该属性设置成任意字符串时表示多项选择，此时ActionForm Bean中的对应的属性类型为字符串数组。请看下面的两个示例。示例1：忽略multiple属性的下拉列表（地区选择列表）。实现该下拉列表的代码如下。所在地区： 北京 吉林 上海 深圳说明：标签用来生成下拉列表的一个列表项，在下一章节中有详细的介绍。对应的ActionForm Bean的关键代码如下。private String shengfen;public void setShengfen(String shengfen)this.shengfen=shengfen;public String getShengfen()return this.shengfen;如果选中“吉林”列表项，则shengfen属性的值为“JL”。运行结果如图7.2所示。示例2：多选下拉列表框（个人爱好多选列表）。实现该多选下拉列表的代码如下。个人爱好： 上网 游泳 购物 乒乓球对应的ActionForm Bean的关键代码如下。private String likes;public void setLikes(String likes)this.likes=likes;publ