<html:html>
<html:html>标记可以说是Struts所 有标记中最简单的了。它简单的在页面开始处和结尾处产生一个的标记。在 Struts1.1以前的 版本中，该标记有一个locale属性。如下所示：
<html:html locale=”true”>
该 属性的作用是读取用户session中的locale属 性并显示出来。比如用户使用的是zh-CN，那么，生成的页面代码将如下所示：
<html locale=”zh-CN”>
不过，从Struts1.2开始，该属性被lang所取代。原 因是locale属性当其值为true时， 会读取session中的locale信 息。但是当HttpSession不存在时，它会强制创建一个新的session并将HTTP请求中的locale信息放入session中去。这种方式 时显并不合理，因此，从Struts1.2开始，locale属 性被lang属性所取代
<html:html lang=”true”>
当 使用lang属性后，若没有session对 象时，就根据Http请求中的locale信 息来输出相应的语言信息。
<html:base>
<html:base>用于在网页的head部 分生成一个base标记。它的用法很简单，只需在head部 分加入如下标记就可以了
<html:base/>
当经过Web容器编译后，会生成如下的一段标记。
<base href=”http://localhost:8080/taglib1/html-base.jsp”>
这也就是本网页的实际的URL地 址。请记住，base标记将不会被显式的显示在网页上，只有通过查看生成的 html源代码才可以看得见。其实，base标记的含义 不仅是生成本网页的URL，它更重要的功能是为该页面内的所有其它链接提供相对的位置。例如，在本 网页使用了<html:base>标记后，生成了如上的URL地址。倘若此时需要指定一张图片，只须使用相对的位置链接就可以了。假设在 taglib1的根目录下有一个image目录，里面 有一张叫image.gif的图片，则引用的代码如下所示：
<img src=”image/image.gif”>
这 张图片的实际URL就是：
http://localhost:8080/taglib1/image/image.gif
<html:link>
<html:link>标记是用来生成HTML中 的<a>标记的，它带有多种参数，可以和Struts框 架结合生成多种不 同形式的链接。
1.外部完整URL链接
<html:link>标 记最简单的用法就是直接链到一个外部的完整URL链接，比如用户需要创建一个到新浪网的链接。可以 使用 href属性，代码如下：
<html:link href=”http://www.sina.com.cn”>
新浪网
</html:link>
以上代码经编译后会生成如下html代 码：
<a href=”http://www.sina.com.cn”>新浪网</a>
2.相对URL链接
当需要从同一个应用中的某个网页链接到另一个网页时，可以使用page属性，代码如下：
<html:link page=”/index.jsp”>
首页
</html:link>
当 需要向所链接的页面传输某些参数时，可以将参数直接加在请求的尾部就可以了。例如，下面的代码示例将向测试页面传递一个字符串参数和一个整型参 数：
<html:link page=”/test.do?testString=a+new+string&testInt=10000″>
测试页面
</html:link>
由它生成的页面html代 码如下所示：
<a href=”/taglib1/test.do?testString=a+new+string&testInt=10000″>
测试页面
</a>
下面的链接是一个测试，它向测试页面传递两个参数，一个是testString，它的值为”a new string”， 另一个是testInt，它的值为10000。
3.全局转发URL链接
在Struts的struts-config.xml文 件中定义了<global-forward>全局转发变量，可以通 过<html:link> 来链接到这种全局转发的URL链 接，使用forward属性，示例代码如下所示：
<html:link forward=”index”>
回到主页
</html:link>
生 成的页面html代码如下所示：
<a href=”/taglib1/index.jsp”>
回到主页
</a>
4.带有页面变量的URL链接
在创建链接时常常需要访问一些页面的变量，将它们的值作为参数传递给将 要链到的网页。<html:link>标记也提供了这样的功能。
如果仅需传递单个参数，可以使用paramID与paramName这两个属性。以下为代码示例
<%
String test1 = “testABC”;
request.setAttribute(“stringtest”,test1);
%>
<html:link page=”/test.do” paramId=”testString” paramName=”stringtest”>
测试页面
</html:link>
在 这段程序中，首先定义一个变量为test1它的值为testABC。 然后将它存入request对象中，命名为stringtest。 接着，使 用<html:link>标记的paramName属 性指定欲从内建对象中读取值的变量名，此处也就是stringtest。然后，使用 paramId属性指定传值的目标参数，此处为testString。 点击下面的链接可以通过测试页面查看运行效果：
如果需要传递 的参数有多个，则可使用<html:link>标记的name属性来实现，name属性的值是一个 java.util.HashMap类型的对象名称，它的每一个”键/值”对就代表一对的”参数名/参数值”， 以下为代码示例：
<%
HashMap para_map = new HashMap();
para_map.put(“testString”,”testABC”);
para_map.put(“testInt”,new Integer(10000));
request.setAttribute(“map1″,para_map);
%>
<html:link page=”/test.do” name=”map1″>测试页面</html:link>
在 上面的代码中，首先在页面上声明一个HashMap类型的变量para_map用来存储将要传递的参数，接着，向 para_map中 存入两个对象。然后再将该对象存入页面的request对象中。使用<html:link>标记的name属性 来将参数带 入目标页面中。实际生成的html代码如下所示：
<a href=”/taglib1/test.do?testString=testABC&testInt=10000″>测试页面< /a>
<html:rewrite>
<html:rewrite>标记是用来输出链接中的URI的。 所谓URI就是指一个完整URL地址去掉协 议，主机地址和端口号以后的 部分。它的众多属性都和<html:link>一样，只 是它输出的仅是一个URI字符串，而非链接。示例代码如下：
<html:rewrite page=”/test.do?testString=testABC”/>
它 生成的html如下：
/struts/test.do?testString=testABC
可以看出，它输出的内容只是实际URL中除去协议，主机地址和端口号以后的部分。实际的URL应 为：
http://localhost:8080/taglib1/test.do?testString=testABC
它也可以使用paramId和paramName等属性，如下面的例 子：
<%
String str = “testABC”;
request.setAttribute(“test1″,str);
%>
<html:rewrite page=”/test.do” paramId=”testString” paramName=”test1″ />
实际生成的html代码如下所示：
/struts/test.do?testString=testABC
下面的例子将演示当有多个参数要传递时<html:rewrite>生成的URI样 式。它与<html:link> 一样，都使用name属 性来传递多个参数。
<%
HashMap para_map = new HashMap();
para_map.put(“testString”,”testABC”);
para_map.put(“testInt”,new Integer(10000));
request.setAttribute(“map1″,para_map);
%>
<html:rewrite page=”/test.do” name=”map1″/>
实 际生成的html代码如下所示：
/struts/test.do?testString=testABC&testInt=10000
这里有一点需要注意的，当从网页源代码上看 生成的多参数链接时，在多个参数间连接符并不是简单的& 而是一个&，在html代码中它就代表&。
<html:img>
<html:img>标记是用来显示图片的，它的用法很简单，如下所示：
<html:img page=”/a.jpg”/>
此处值得注意的一点是，在page属 性后图片的路径并没有因为设定了<html:base>而使用了相对路径，而是依然使 用了绝对路 径。如果使用非Struts的<img src=”a.jpg”>标记则可以正确显示图片。
<html:form>
<html:form>标记生成页面表单，这个由Struts标 记生成的表单和普通的HTML表单略有不同。普通的表单用法如下所示：
<form method=”post” action=”/loginServlet”>
<input type=”text” name=”username”>
<input type=”text” name=”username”>
</form>
可以看到，在普通的form标 记后的action属性的值是一个Servlet（当 然也可以是一个JSP文件），而使用 了<html:form> 标记后，代码则变成了下面的样子：
<html:form action=”/test.do”>
其 中action属性后跟的是一个在struts-config.xml文 件中定义的Action，而这个Action也 必定要对应一个 ActionForm才能完成其应有的功能。所以，对每个<html:form>标记来说，都该对应一个ActionForm。 而这个 ActionForm中的属性值也将和网页上的<html:form>表 单中的各个表单项相对应。这些表单相将会是类似 于<html:text>的一些表单 元素。下面有一段示例代码：
<html:form action=”/test.do”>
输入字 符串testString：<html:text property=”testString”/>
提 交：<html:submit property=”submit”/>
</html:form>
这 段代码将在页面上显示一个文本框和一个提交按钮，当用户在文本框中输入一个字符串后并点击按钮，将会触发test这 个Action。在初始化这个 JSP页面 时，JSP引擎在初始化<html:form>标 记时将会初始化test这个Action所 对应的ActionForm，当用户提 交表单时，表单项中的testString刚好对应ActionForm中的 这一项(只需名称相同)。
此处值得注意的一点是，在<html:form>表 单中的各个表单项一定要在ActionForm可以找到一个对应的项，这样才能在提 交的时候进行赋值，否则，Struts将会报一个错，显示无法找到某表单项在ActionForm的对应get方法
<html:text>
<html:text>标记比较简单，是用来在页面上生成一个文本框，该标记通常被用在一个<html:form>中。以 下是一段示例代码：
<html:form action=”/test.do”>
输入字 符串testString：<html:text property=”testString”/>
输入整数 testInt：<html:text property=”testInt”/>
<html:submit property=”submit” value=”submit”/>
</html:form>
通常，<html:text property=”testString”/>语句将生成以下的html代 码：
<input type=”text” name=”testString”>
可以看到，<html:text>标记的property属 性指定了文本框的名称，如果它位于<html:form>表单 内部，那么， property的值若刚好与ActionForm中 的一项对应时，该文本框内的值就将被赋给该ActionForm中的该项。以test这个 Action所对应的ActionForm为例，它其中就有这么一段代码刚好与上面的<html:text>相 对应：
private String testString = null;
public void setTestString(String testString){
this.testString = testString;
}
public String getTestString(){
return testString;
}
从 上面的代码可以看出用户在提交表单后，Struts会自动将property=”testString”的<html:text>文 本框的值赋给 ActionForm中的testString字段。
<html:password>
<html:password>用来在页面上产生一个密码框。所谓密码框其实就是一个文本框，只 不过对它的任何输入都将显示为”*”。 它的用法和<html:text>差 不多，property属性用来表示它的名称。
<html:form action=”/test.do”>
<html:password property=”testString”/>
<html:submit property=”submit” value=”查看测试页面”/>
</html:form>
上面的代码中将一个<html:password>标 记放在一个表单中，这也是必须的，否则Struts框架会报错。以下是上面代码的 运行效果，无论用户输入什么，都只会显示”*”。点击提交钮后，会在测试页面看到用户输入的内容。
<html:textarea>标 记和&html:textarea基本相同，只不过它会产生一个更大的文本输入域。同样 的， 它也需要存在于一个<html:form>表单中，下面是示例代码：
<html:form action=”/test.do”>
<html:textarea property=”testString” rows=”8″/>
<html:submit property=”submit” value=”查看 测试页面”/>
</html:form>
<html:hidden>
<html:hidden>标记用于在网页上生成一个隐藏的字段。众所周知，网页上总有一些信息不 希望被用户看到，但在提交的时候却需 要传递到服务器上以帮助业务逻辑进行处理。在传统的html中， 隐藏字段是用下面的方式表示的：
<input type=”hidden” name=”testString” value=”hiddenString”>
<html:hidden>标 记不需要被限定在一个表单的内部来使用，以下的例子还是将它放在一个表单的内部。当用户点击 “查 看测试页面”的按钮时，会看到测试页面中testString被 赋与了”hiddenString”的值。
在<html:hidden>标记中有一个write属 性，可以决定在页面上是否显示出这个隐藏的值，如下面的代码：
<html:hidden property=”testString” value=”hiddenString” write=”true”/>
运行效果如下所示，虽然只有短短的一个字符串，但可以看出标记还是把testString的value打印出来了。
hiddenString
<html:submit>
<html:submit>标记生成一个提交按钮，用于提交表单。它的用法很简单，如下所示：
<html:submit property=”submit” value=”提 交“/>
它 会生成如下的html代码
<input type=”submit” name=”submit” value=”提交“>
另 外，<html:submit>标记还可以写成如下的形式,它也将生成同样的html代码。
<html:submit> 提交</html:submit>
<html:reset>
<html:reset>标记生成一个复位按钮，用于复位表单内的各项元素。代码如下：
<html:form action=”/test.do”>
<html:text property=”testString”/>
<html:submit property=”submit” value=”Submit”/>
<html:reset property=”reset” value=”reset”/>
</html:form>
<html:radio>
<html:radio> 标记生成一个单选框，示例代码如下：
<html:form action=”/test.do”>
<html:radio property=”testRadio” value=”testvalue1″/>
</html:form>
它有一个value属性，用来指定当选中该单选框时ActionForm中对应的属性 的值。下面是另一种单选框的用法：
<html:form action=”/test.do”>
<html:radio property=”testRadio” value=”value1″>Choice1
<html:radio property=”testRadio” value=”value2″>Choice2
<html:radio property=”testRadio” value=”value3″>Choice3
</html:form>
在上面的代码 中，单选框一共有三个，这三个单选框组成一个单选框组，只能选取其中一个。无论选中哪一个，它的值在提交表单后都 将赋给ActionForm中相对应的属性，如果三个单选框一个都没有选 中，那么该属性的值将为一个空串。
运行效果如下所示：
<html:errors>
在Struts 1.1中该标签的使用方法
<html:errors> 标签用来在网页上输出错误消息。以下是一段实际运行效果，当用户选中下面的选 择框后并提交表单时，页面上就会显示错误消息，而当用户不选中直接点击时，会出现不同的错误消息。
这里使用到的代码如下所示：
<html:form action=”/testerr.do”>
选择框：<html:checkbox property=”checkbox1″/>
<html:submit/>
</html:form>
<html:errors bundle=”error”/>
错误信息是通 过什么方式添加的呢，<html:errors>标记又是通过什么方式将错误信息显示出来的呢？在前面的章节中曾提到过ActionForm中的 validate()方法，它的作用是检验用户的输入，当用户的输入不符合某种条件时，就返回一个 ActionErrors对象，倘若返回的对象不为空，Struts框架就会将请求发回页面。此时，倘若页面上有相应的显示错误的标记，就会将在 validate()方法中所添加的错误显示出来。
另外，除了在 ActionForm的validate()方法中可以添加ActionErrors外，在Action中也可 以添加。通过查看struts- config.xml文件可以知 道，与这个表单相关联的ActionForm和Action分别是ErrBean和ErrAction。以下先看看 ErrBean的 代码：
public class ErrBean extends ActionForm{
private boolean checkbox1;
public boolean isCheckbox1() {
return checkbox1;
}
public void setCheckbox1(boolean checkbox1) {
this.checkbox1 = checkbox1;
}
public void reset(ActionMapping mapping, HttpServletRequest request){
this.setCheckbox1(false);
}
public ActionErrors validate(ActionMapping mapping, HttpServletRequest request){
ActionErrors errors = new ActionErrors();
if (checkbox1){
errors.add(ActionMessages.GLOBAL_MESSAGE,new ActionError(“html.errors.error1″));
errors.add(“checkbox1″,new ActionError(“html.errors.error2″));
}
return errors;
}
}
在<html:checkbox> 标记一节已经说过，用于在ActionForm中表示一个选择框的类型通常使用boolean型。此处在ErrBean中就声明了一个boolean型的变量checkbox1用于表示页面上的选择框。当用户在页面上点击了该选择框时，选择框的值被设置为true。然后用户点击提交按钮，此时，Struts框架从struts-config.xml文件中得知这个提交的ActionForm的validate属性为true，因此需要 调用 ErrBean的validate()方法进行验证。
在ErrBean的 validate()方法中，首先初始化一个ActionErrors对象，然后判断checkbox1是 否被选中。若选中，则向 ActionErrors 对象中添加两个ActionError。添加ActionError时采用的是ActionErrors的add()方法。该方法有两个参数，第一个参数是所添加ActionError 的key，然后是ActionError的值。这样做的原因是因为在ActionErrors内部保存了一个HashMap，以 此来将所有的 ActionError保存。其中，添加第一个ActionError的代码如下：
errors.add(ActionMessages.GLOBAL_MESSAGE,new ActionError(“html.errors.error1″));
这里的 ActionMessages.GLOBAL_MESSAGE的值是“org.apache.struts.action.GLOBAL_MESSAGE”，它是一个常量，表示全局消息。对于每一个key来说，都可以存入多个ActionError。这是因为ActionErrors的内置的HashMap中并不是仅仅存入一个简单的ActionError 对象，而是存入一个List对象，再将多个ActionError对象存入该List中。ActionError的构造函数中的参数是资源文件中的key 值，将来在页面上就将显 示该key值对应的value。下面是 添加第二个ActionError的代码：
errors.add(“checkbox1″,new ActionError(“html.errors.error2″));
这个 ActionError的key值为checkbox1，它表示和特定的表单元素相关的错误信息。在页面中的<html:errors>标签中使用 property属性来指定。
通过上面的代码可以看到，用户在提交表单时由ActionForm产生了错误信息，然后转交回页面。此时，就该由页面上的<html:errors> 来显示相应的错误信息了。这时，考虑另一种情形，如果页面上用户输入的信息并 无错误，通过了ActionForm的validate()方法的检查，但在 Action中 经由业务逻辑处理后，返回了一些错误信息。此时，仍然需要将ActionErrors对象存储进request对象中。但Action中并无 validate方法了，该怎么办呢？Action类的saveErrors()方法解决了这一困难。看看 下面ErrAction的execute()方法的代码：
public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception {
ActionErrors errors = new ActionErrors();
errors.add(ActionMessages.GLOBAL_MESSAGE,new ActionError(“html.errors.error3″));
saveErrors(request,errors);
return mapping.findForward(“input”);
}
在Action类中提供了一个saveErrors()方法，可以将ActionErrors对象存入request中。通过这个方法<html:errors> 标签可以在request中找到它并将其显示在网页上。
前面已经看到了页面上显示的代码，下面就来讲解 一下<html:errors>标记的具体用法。
<html;errors> 标记可以放在网页上的任何位置，它有以下三个比较重要的属性：
name属性：它指定了存放在request或session属性中的错误对象的值。我们知道，在request或session中，对象的存储一般都以键/值对的方式来进行。ActionErrors对象在request或session中的key默认为Globals.ERROR_KEY。
property属性：用于指定与ActionError对应的key值，如前面例 中的checkbox1。
bundle属性：用于指定资源文件，即显示ActionErrors信息时去哪个资源文件中读取相应的消息文本。例如在taglib1中，struts- config.xml 文件中有这样一句代码：
<message-resources parameter=”message” key=”error”/>
则在页面的<html:errors>标签中使用下面的方式来引用这个资源文件
<html:errors bundle=”error”/>
以下是几个代码示例：
<html:errors bundle=”error”/>
上面的代码表示显示所有的错误信息。
<html:errors property=”org.apache.struts.action.GLOBAL_MESSAGE” bundle=”error”/>
上面的代码 表示显示所有的全局消息，也就是在向ActionErrors中添加ActionError对象时，选用 ActionMessages.GLOBAL_MESSAGE 做为该ActionError的key的对象。
在Struts 1.2中该标签的使用方法
到目前为止，所有有关<html:errors>标签的讨论都是基于Struts 1.1的核心。但在2005年Apache正式推出Struts 1.2后， 有许多东西已经被改变。其中很重要的一个改动就是与<html:errors>标记相关的改动，主要就是已经不再推荐使用 ActionError类和ActionErrors类，因此，如果要将现有的 使用到与<html:errors>标记相关的 代码从 Struts 1.1下移至Struts 1.2下，需要作以下改动。
1. 将代码中使用到ActionError类的地方换为ActionMessage类。
2. 将除了在ActionForm的validate()方法以外使用到ActionErrors类的地方都替换为ActionMessages。
这样做的主 要原因是，ActionError是ActionMessage的子类，而ActionErrors是ActionMessages的 子类。开发者认为一个错误消息也是消息的一种，并没有必要专门将其分开存放。只需要使用Globals.MESSAGE_KEY,Globals.ERROR_KEY来进行区分就分。
例如，在 ErrAction中，若要使其支持Struts1.2， 则可将代码改为如下形式：
public ActionForward execute(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) throws Exception {
ActionMessages messages = new ActionMessages();
messages.add(ActionMessages.GLOBAL_MESSAGE,new ActionMessage(“html.errors.error3″));
saveErrors(request,messages);
return mapping.findForward(“input”);
}
}
}
近期评论