Struts HTML标签

<html:html>标签

属性的作用：

lang： 值为true时，就根据存储在HttpSession中的Locale对象来输出网     页使用的语言。如果不存在session或session中没有Locale对象，     就以Http请求头中的Accept－language属性来设置输出语言。如果     请求头中没有Accept－language，就使用默认的Locale来输出语言

    示例：

<html:html lang="true"/>

<html:form>标签：生成HTML<form action="">元素

属性的作用：

method：表单提交的方法

action：指定表单提交后，处理该请求的Action组件名称

示例：

<html:form method="POST" action="/index.do">

<html:text>标签：生成一个HTML<input type="text"/>

属性的作用：

property：与ActionFormBean中的属性名相对应，表单提交时会value属     性中的值赋给相应的ActionFormBean中的属性。(REQUIRED)

value：   指定文本框的默认值。

name：ActionForm的名称，或其他javabean的名称，用来给该控件提供    数据。如果没有指定，那么将使用form标签中相应的ActionForm     Bean

示例：

<html:text property="name"/>

<html:password>标签：生成一个HTML<input type="password"/>

属性的作用：

property：与ActionFormBean中的属性名相对应，表单提交时会将value      属性中的值赋给相应的ActionFormBean中的属性(REQUIRED)

value：   指定密码文本框的默认值。

name：ActionForm的名称，或其他javabean的名称，用来给该控件提供    数据。如果没有指定，那么将使用form标签中相应的ActionForm     Bean

redisplay：取值为true或false。在密码框中填入内容后，从新刷新(请求)     该页面是否仍保留已经填写过的密码。推荐选择false

示例：

<html:password redisplay="false" property="password"/>

<html:radio>标签：生成一HTML <input type="radio"/>

属性的作用：

property：与ActionFormBean中的属性名相对应，表单提交时会将value      属性的中值赋给相应的ActionFormBean中的属性(REQUIRED)

value：   指定单选按钮的默认值。(REQUIRED)

name： ActionForm的名称，或其他javabean的名称，用来给该控件提     供数据。如果没有指定，那么将使用form标签中相应的      ActionForm Bean

bundle： 指定特定的Resource Bundle，它与struts-config.xml中

    <message-resources key=""/>元素中的key中的值对应

示例：

<html:radio value="boy" property="sex">boy</html:radio>

<html:radio value="girl" property="sex">girl</html:radio>

<html:radio>使用了同一个property，表示它们是一个组，只能从其中任选一个。其对应的ActionForm Bean中的属性为sex，sex中的值为被选中的 单选按钮中的值，如果没有一个单选按钮被选中，那么sex中的值为null

<html:multibox>标签：生成一个HTML <input type="checkbox"/>

属性的作用：

property：与ActionFormBean中的属性名相对应，表单提交时会将value属     性中的值赋给相应的ActionFormBean中的属性。(REQUIRED)

value：   指定复选框的默认值。

name： ActionForm的名称，或其他javabean的名称，用来给该控件提     供数据。如果没有指定，那么将使用form标签中相应的       ActionForm Bean

bundle： 指定特定的Resource Bundle，它与struts-config.xml中

    <message-resources key=""/>元素中的key中的值对应

示例：

<html:multibox property="favorite" value="movie" />

<html:multibox property="favorite" value="Video Game" />

<html:multibox property="favorite" value="BasketBall" />

相对应的ActionBean Form中的属性及相应的getter与setter方法如下：

private String favorite[]=new String[0];

public void setFavorite(String favorite[])

{

   this.favorite = favorite;

}

public String[] getFavorite()

{

   return favorite;

}

表单提交时(如果全部选中)，会将value属性中的值保存至数组中，那么 favorite数组中的内 容为{"movie","Video Game","BasketBall"}。如果 "Video Game" 没有被选中，那么提交后favorite数组中的内容为：

{"movie","BasketBall"}

<html:select>标签：生成一个HTML<select multiple="">

语法格式：

<html:select property="country" multiple=“”size=“” >

<html:option value="Canda"/>

<html:option value="China" />

<html:option value="American" />

</html:select>

属性的作用：

property：与ActionFormBean中的属性名相对应，表单提交时会将value属     性中的值赋给相应的ActionFormBean中的属性。(REQUIRED)

multiple： 指定是否多选，如果设置为true，就表示多选列表，支持多项选     择；如果设置为false，则表示下拉列表，支持单项选择。默认为     false。

   name： ActionForm的名称，或其他javabean的名称，用来给该控件提     供数据。如果没有指定，那么将使用form标签中相应的       ActionForm Bean

size：   指定每次在网页上可以显示的选项的数目

示例：

<html:select property="country" multiple="false">

其所对应ActioFrom Bean中的 String country; 属性

<html:select property="skill" multiple="true" size="3">

其所对应ActioFrom Bean中的属性及getter和setter方法如下：

private String skill[];

public String[] getSkill()

{

   return skill;

}

public void setSkill(String[] skill)

{

   this.skill = skill;

}

<html:select>不单独使用，要指定<html:select>中选项的值必须使用 <html:option> 作为其子元素。下面介绍<html:option>的用法

<html:option>属性的作用：

value： 指定该组件在网页中显示的内容

bundle：指定特定的Resource Bundle，它与struts-config.xml中

<message-resources key=""/>元素中的key中的值对应

key：   <message-resources>元素中配置的Resource Bundle文件中消    息key相对应

示例：

1、直接赋值

<html:option value="SQLServer"/>

2、采用Resource Bundle文件绑定

struts-config.xml中配置如下

<message-resources

   key="myresource"

parameter="com.accp.struts.ApplicationResources"

/>

ApplicationResources文件内容如下：

form.skill=SQL Server

<html:option value="form.skill"

bundle="myresource"

key="form.skill"/>

<html:link>标签：生成一个超链接

属性的作用：

page：要链接页面的相对路径，一般用于链接同一应用程序中的页面

href：要链接页面的完全路径，一般用于链接不同应用程序中的页面

forward：将请求转发给struts-config.xml中所配置的<global-forwards>     元素下的<forward>，再由其转发给要链接的页面

action：将请求转发给任意一个Action

示例：

<html:link page="/other.jsp">

<html:link href="/MyHtml/other.jsp">

<html:link forward="other">

与其相对应的是

<global-forwards>

   <forward name="other" path="/other.jsp"></forward>

</global-forwards>

<html:link action="/other.do">

与其相对应的是：

<action-mappings>

<action forward="/other.jsp" path="/other"/>

</action-mappings>

<html:errors>输出保存在ActionMessages中的错误消息

属性的作用：

name：指定ActionMessages对象存放在request，session中的key，    如果未指定。默认为Globals.ERROR_KEY.(一般不要指定)

property：指定消息的属性。如果为设置，将显示ActionMessages中的      所有信息。

bundle： 指定Resource Bundle。如果没有设置，则使用默认的       Resource Bundle

使用步骤：

1) 创建资源文件 ApplicationResources.properties，向其中指定一   些预定义信息

errors.error.one=<font color\="red">this is a  

ActionErrors's message</font><br/>

errors.error.three=<font color\="blue">the third

ActionErrors's message</font><br/>

errors.error.two=<font color\="green">the second         ActionErrors's message</font><br/>

注：<html:errors>可以自动识别html元素

ApplicationResources.properties文件在struts-config.xml中按如下方式配置

    <message-resources

key="form" --注意：这里指定了该文件的key

parameter="com.accp.resource.ApplicationResources"

/>

2) 在ActionForm Bean中的validate()方法中加入如下代码：

   ActionErrors errors= new ActionErrors();

   errors.add(Globals.ERROR_KEY,

new ActionMessage("errors.error.one"));

   errors.add(ActionMessages.GLOBAL_MESSAGE,

new ActionMessage("errors.error.two"));

errors.add("threeError",

new ActionMessage("errors.error.three"));

注意：

(a) 三个add()方法中第一个参数不同，Globals.ERROR_KEY与 ActionMessages.GLOBAL_MESSAGE都是系统默认的常量， 其功能一样。"threeError"为自定义值。

(b) 以上代码也可以写入Action类中的execute()方法中，但是   后面要加上一下代码

this.addErrors(request, errors);

3) 在网页中显示<html:errors>中的内容

a) 显示所有信息：

<html:errors bundle="form" />

注意：<html:errors>中的bundle属性中的值"form" 与struts- config.xml 文件中

<message-resources

key="form"

parameter="com.accp.resource.ApplicationResources"

/>

中的key="form"相匹配

如果struts-config.xml文件中<message-resources>并没有指定key属性，那么<html:errors>中的bundle属性就可以省略

即：

<message-resources

                parameter="com.accp.resource.ApplicationResources"

/>

<html:errors/>

<html:errors />

b) 显示特定信息：

<html:errors property="threeError" bundle="form" />

注意：<html:errors>中的property属性中的值"threeError"与前面步骤(2)中的代码

errors.add("threeError",

new ActionMessage("errors.error.three"));

中的"threeError"相同。这样可以输出想要显示的信息

<html:messages>输出保存在ActionMessages中的错误消息

语法格式：

<html:messages >

    <bean:write name="message"/>

</html:messages>

属性的作用：

name：指定ActionMessages对象存放在request，session中的key，    如果未指定。默认为Globals.MESSAGE_KEY.(一般不要指定)

id： 为从消息中检索出来的ActionMessages对象命名。该名称要和

<bean:write />中name属性的值相同。

bundle： 指定Resource Bundle。如果没有设置，则使用默认的       Resource Bundle

message：指定消息的来源，默认值是true。如果为true，就从request，

session范围内检索key为Globals.MESSAGE_KEY的ActionMessages对象，此时name属性无效。如果为false，那么就根据name属性中的值来检索ActionMessages对象，此时若没有设置name属性，将采用默认值Globals.ERROR_KEY。

filter：是否过滤资源文件中的html标记。false为不过滤，true为过滤。

             默认值为true。

注：<html:errors>不可以自动识别html元素，它会将html元素当作普   通字符。

使用步骤：

(1) 创建资源文件 ApplicationResources.properties，向其中指定一   些预定义信息

errors.message.one=<font color\="red">this is a

ActionMessage's message</font><br/>

errors.message.three=<font color\="blue">the third

ActionMessage's message</font><br/>

errors.message.two=<font color\="green">the second

ActionMessage's message </font>

ApplicationResources.properties文件在struts-config.xml中按 如下方式配置

   <message-resources

key="form" --注意：这里指定了该文件的key

parameter="com.accp.resource.ApplicationResources"

/>

(2) 在Action类的execute()方法中加入如下代码：

   ActionMessages message= new ActionMessages();

   message.add(ActionMessages.GLOBAL_MESSAGE,

new ActionMessage("errors.message.one"));

   message.add(Globals.MESSAGE_KEY,

new ActionMessage("errors.message.two"));

   message.add("threeMessage",

new ActionMessage("errors.message.three"));

   this.saveMessages(request, message);

注意：

(a) 三个add()方法中第一个参数不同，Globals.ERROR_KEY与    ActionMessages.GLOBAL_MESSAGE都是系统默认的常量，其   功能一样。"threeMessage"为自定义值。

(b) 以上代码不可以在ActionForm Bean类中的validate()方法中使用。

(3) 在网页中显示<html:messages>中的内容

a) 显示所有信息：

<html:messages bundle="form">

      <bean:write name="message"filter="false"/>

</html:messages>

注意：<html:messages >中的bundle属性中的值"form" 与 struts- config.xml 文件中

<message-resources

key="form"

   parameter="com.accp.resource.ApplicationResources"

/>

中的key="form"相匹配

如果struts-config.xml文件中<message-resources>并没有指定key属性，那么<html:errors>中的bundle属性就可以省略

即：

<message-resources

                parameter="com.accp.resource.ApplicationResources"

/>

<html:messages >

      <bean:write name="message"filter="false"/>

</html:messages>

b) 显示特定信息：

    <html:messages id="message" bundle="form" 

property="threeMessage">

     <bean:write name="message"/>

</html:messages>

注意：<html:messages>中的property属性中的值 "threeMessage"与前面步骤(2)中的代码

message.add("threeMessage",

new ActionMessage("errors.message.three"));

中的"threeMessage"。

这样可以输出想要显示的信息(实际上在这里不会输出任何内容，但是若和validator验证框架一起使用便可以看到效果，这种使用方法，可以参考validator验证框架中的例子)

<bean:message>输出资源文件中的信息

属性的作用：

bundle： 指定Resource Bundle。如果没有设置，则使用默认的       Resource Bundle

key：指定Resource Bundle中的key

arg0，arg1，arg2，arg3：Resource Bundle中资源文件内容的占位符

使用步骤：

(1) 创建资源文件 ApplicationResources.properties，向其中指定一   些预定义信息

message.info=<font color\="red">this is a message form          resource bundle</font><br>

message.info.args=<font color\="red">hello {0}，

welcome to {1}</font><br>

ApplicationResources.properties文件在struts-config.xml中按如下方式配置

   <message-resources

key="form" --注意：这里指定了该文件的key

parameter="com.accp.resource.ApplicationResources"

/>

(2) 在网页中显示<bean:messages>中的内容

(a) <bean:message bundle="form" key="message.info" />

注意：<bean:messages >中的bundle属性中的值"form"与

struts- config.xml 文件中

<message-resources

key="form"

   parameter="com.accp.resource.ApplicationResources"

/>

中的key="form"相匹配

如果struts-config.xml文件中<message-resources>并没有指定key属性，那么<bean:message>中的bundle属性就可以省 略,即：

<message-resources

             parameter="com.accp.resource.ApplicationResources"

/>

<bean:message key="message.info" />

(b) <bean:message bundle="form"

key="message.info.args"

arg0="jack" arg1="xfaccp"/>

其中：arg0，arg1分别对应资源文件

message.info.args=<font color\="red">hello {0}，

welcome to {1}</font><br>

中的{0},{1}