struts框架bean html logic标签手册.docx

struts框架bean html logic标签手册.docx

《struts框架bean html logic标签手册.docx》由会员分享，可在线阅读，更多相关《struts框架bean html logic标签手册.docx（32页珍藏版）》请在冰豆网上搜索。

struts框架beanhtmllogic标签手册

struts框架bean,html,logic标签手册

目录：

bean:

cookie

bean:

define

bean:

header

bean:

include

bean:

message

bean:

page

bean:

parameter

bean:

resource

bean:

size

bean:

struts

bean:

write

html:

base

html:

cancel

html:

select

html:

checkbox

html:

radio

html:

multibox

html:

link

html:

errors

html:

javascript

html:

xhtml

logic:

iterate

logic:

present

logic:

messagesPresent

logic:

empty

logic:

match

logic:

equal

logic:

forward

正文：

Struts是ApacheJakarta的一个著名的开源项目，目标是为构建基于Java的web应用程序提供一个框架。

Struts提供了非常多的标签，依据功能和使用习惯的不同被分到了五个标签库中:

∙BeanTags:

该标签库包含的标签可以用来创建bean、访问bean和访问bean的属性。

同时提供了依据cookies、headers和parameters的值创建相关bean的能力。

∙HTMLTags:

该标签库包含的标签可以用来创建Struts输入表单。

∙LogicTags:

该标签库包含的标签可以用来进行逻辑判断、集合迭代和流程控制。

∙NestedTags:

该标签库建立在前三个标签库的基础上，具有前三个标签库的所有功能，只是允许标签间的嵌套。

∙TilesTags:

该标签库包含的标签可以用来创建tiles样式的页面。

这篇指南主要介绍前三个标签库中的标签。

如果您对后两类标签也感兴趣可以查阅参考资料中的Struts的用户指南。

bean:

cookie

cookie最早是由Netscape公司提出来的，用来存储客户的少量状态信息。

如果您对cookie的具体细节感兴趣可以查阅参考资料中的cookiespec。

bean:

cookie标签取回请求中名称为name的cookie的值。

如果没有指定multiple属性则依据刚取回的值创建一个Cookie类型的bean。

如果指定了multiple属性则依据刚取回的值创建一个Cookie[]类型的数组。

然后用id属性值将Cookie或Cookie[]绑定到page作用域中（这种绑定是为了其它标签能够使用该值），并创建对应的scripting变量（这种变量是为了JSP脚本能够使用该值）。

下面的代码片段示例了如何使用bean:

cookie标签读取名为JSESSIONID的cookie的值，并且使用了两种方式进行了输出：

presentcookie="JSESSIONID">

cookieid="jSession"name="JSESSIONID"/>

--其它标签通过绑定到page作用域中的属性使用该值-->

这个cookie的名称是

writename="jSession"property="name"/>，

值为

writename="jSession"property="value"/>。

--JSP脚本通过scripting变量使用该值-->

<%

Stringname=jSession.getName（）;

Stringvalue=jSession.getValue（）;

out.println（"这个cookie的名称是"+name+"，值为"+value+"。

"）;

%>

present>

bean:

define

bean:

define标签在toScope（如果没有指定值就使用page作用域）指定的作用域中创建一个新属性，同时创建一个scripting变量。

我们可以通过id值使用它们。

新创建的属性可以由其它标签使用，而新创建的scripting变量可以由JSP脚本使用。

我们可以使用三种方式为新创建的属性和scripting变量赋值：

∙通过该标签的name、property和scope取回值，并且保持类型的一致性，除非取回的值为Java的原始类型，这时会使用适合的包装器类对这些值进行包装。

∙通过该标签的value指定值，这时新创建的属性和scripting变量的类型为java.lang.String。

∙通过在该标签的体中嵌入值，这时新创建的属性和scripting变量的类型为java.lang.String。

下面的代码片段示例了如何使用bean:

define标签创建新属性values和新scripting变量values，它将listForm中persons的值取出来赋给values:

defineid="values"name="listForm"property="persons"

type="java.util.List"/>

下面给出ListForm的代码片段以帮助您更好的理解，其中Person是一个只有id和name两个属性的简单bean：

publicclassListFormextendsActionForm{

privateListpersons=null;

publicListgetPersons（）{

returnpersons;

}

publicvoidsetPersons（Listpersons）{

this.persons=persons;

}

publicvoidreset（ActionMappingmapping,

HttpServletRequestrequest）{

persons=null;

}

}

下面的代码片段示例了logic:

iterate标签如何使用bean:

define标签创建的新属性values:

iterateid="person"name="values">

writename="person"property="id"/>

iterate>

下面的代码片段示例了JSP脚本如何使用bean:

define标签创建的新scripting变量values:

<%

Personp=newPerson（）;

for（inti=0;i

p=（Person）values.get（i）;

out.println（p.getId（））;

out.println（"
"）;

}

%>

bean:

header

bean:

header标签取回请求中名称为name的header的值。

如果没有指定multiple属性则依据刚取回的值创建一个String类型的bean。

如果指定了multiple属性则依据刚取回的值创建一个String[]类型的数组。

然后用id属性值将String或String[]绑定到page作用域中（这种绑定是为了其它标签能够使用该值），并创建对应的scripting变量（这种变量是为了JSP脚本能够使用该值）。

下面是我的浏览器发送的header的内容，这些内容和浏览器有关，因此您的浏览器发送的内容可能和下面列出的不同。

不过这没有关系，因为要理解bean:

header标签您只要对这些内容有一个大概的认识就足够了。

accept:

*/*

accept-language:

zh-cn

accept-encoding:

gzip,deflate

user-agent:

Mozilla/4.0（compatible;MSIE6.0;//应该在同一行

WindowsNT5.1;SV1;.NETCLR1.1.4322）

host:

localhost:

8080

connection:

Keep-Alive

下面的代码片段示例了如何使用bean:

header标签读取名为User-Agent的header的值，并且使用了两种方式进行了输出：

presentheader="User-Agent">

--其它标签通过绑定到page作用域中的属性使用该值-->

您的浏览器是

headerid="userAgent"name="User-Agent"/>

writename="userAgent"/>。

--JSP脚本通过scripting变量使用该值-->

<%

out.println（"您的浏览器是"+userAgent+"。

"）;

%>

present>

bean:

include

bean:

include标签对指定url（由forward、href或page确定）处的资源做一个请求，将响应数据作为一个String类型的bean绑定到page作用域，同时创建一个scripting变量。

我们可以通过id值访问它们。

下面的代码片段示例了bean:

include标签的用法，其中include.txt文件包含要include的内容，然后将这些内容输出:

includeid="value"page="/include.txt"/>

--其它标签通过绑定到page作用域中的属性使用该值-->

writename="value"/>

--JSP脚本通过scripting变量使用该值-->

<%

out.println（value）;

%>

bean:

message

bean:

message标签用来从指定的locale中取回国际化的消息并输出，在这个过程中我们还可以传递五个以内的参数。

messagekey可以通过key直接指定，也可以通过name和property间接的指定。

bean:

message标签有两种指定messagekey的方式，一是通过key属性直接指定；二是通过name和property属性间接的指定，其中messagekey是在messageresources文件中定义的。

我们可以在struts-config.xml文件中使用来设置messageresources文件。

为了介绍该标签我使用了三个messageresources文件，三个文件的名字分别为Resources.properties、Resources_en.properties和Resources_zh.properties。

在struts-config.xml文件中的设置（这里不用设置三个，struts会依据locale自动找到对应的文件）如下：

三个messageresources文件中定义的messagekey为：

--Resources.properties-->

resource=Resources.properties.

from=Resources.properties.

--Resources_en.properties-->

from=Resources_en.properties.

--Resources_zh.properties

因为文件的编码被限制为ISO8859所以要有汉字必须用jdk的native2ascii提前转换

-->

from=Resources_zh.properties.

下面的代码片段示例了bean:

message标签的用法:

messagekey="from"/>

messagekey="resource"/>

linkaction="/locale?

language=en">English

link>

linkaction="/locale?

language=zh">Chinese

link>

上面的代码中含有改变locale的两个html:

link标签，要使它们工作您的struts-config.xml文件中必须含有下面定义的form和action:

type="org.apache.struts.action.DynaActionForm">

--action成功后要跳到那里-->

initial="/message.jsp"/>

name="localeForm"scope="request">

在不同的locale下我们得到了如下的两个结果：

在locale为zh时的结果：

Resources_zh.properties.

Resources.properties.

在locale为en时的结果：

Resources_en.properties.

Resources.properties.

让我们来看一下在locale为zh时如何得到的是上面的结果。

因为locale为zh所以

messagekey="from"/>
先找Resources_zh.properties这个文件从中得到form键的值。

而

messagekey="resource"/>
也会先找Resources_zh.properties这个文件但这次没有找到resource键，这时Struts会到Resources.properties这个文件中找，很幸运这里找到了。

如果还没有找到，或messageresource文件不存在就会抛出异常。

当locale为en时类似，您可以自己试试。

bean:

page

bean:

page标签将页上下文中的application、config、request、response或session取出，然后用id属性值将它们绑定到page作用域中（这种绑定是为了其它标签能够使用该值），并创建对应的scripting变量（这种变量是为了JSP脚本能够使用该值）。

下面的代码片段示例了bean:

page标签取出response，然后使用bean:

write标签将response的characterEncoding和contentType属性输出：

pageid="res"property="response"/>

--其它标签通过绑定到page作用域中的属性使用该值-->

writename="res"property="characterEncoding"/>

writename="res"property="contentType"/>

--JSP脚本通过scripting变量使用该值-->

<%

StringcharacterEncoding=res.getCharacterEncoding（）;

StringcontentType=res.getContentType（）;

out.println（characterEncoding+"
"）;

out.println（contentType+"
"）;

%>

您可以用和上面类似的代码访问application、config、request或session中的任何一个对象。

bean:

parameter

bean:

parameter标签取回请求中的参数值。

如果没有指定multiple属性则依据刚取回的值创建一个String类型的bean。

如果指定了multiple属性则依据刚取回的值创建一个String[]类型的数组。

然后用id属性值将String或String[]绑定到page作用域中（这种绑定是为了其它标签能够使用该值），并创建对应的scripting变量（这种变量是为了JSP脚本能够使用该值）。

下面的两个代码片段使用相同的url传递参数，url的形式为http:

//127.0.0.1:

8080/struts-demo/parameter.jsp?

param=1¶m=2¶m=3。

前面的代码片段中没有指定multiple属性，因此p是String类型而且仅仅读取了参数的第一个值。

后面的代码片段中指定了multiple属性的值，因此ps是String[]类型的包含所有参数的值。

parameterid="p"name="param"/>

writename="p"/>

parameterid="ps"multiple="true"name="param"/>

iterateid="p"name="ps">

writename="p"/>

iterate>

bean:

resource

bean:

resource标签取回指定的web应用程序的资源，以InputStream或String的形式保存到page作用域中并且创建scripting变量。

采用什么形式取决于标签的input属性，如果指定input则以InputStream的形式保存，如果没有指定input则以String的形式保存。

下面的两个代码片段示例了bean:

resource标签，其中resource.txt是要使用的资源文件。

前面的代码片段中没有指定input属性，因此以String的形式处理资源文件，bean:

write标签输出资源文件的内容。

后面的代码片段中指定了input属性的值，因此以InputStream的形式使用资源文件，两个bean:

write标签分别输出InputStream对象的实例名（如java.io.ByteArrayInputStream@16dadf9）和类名（如classjava.io.ByteArrayInputStream）。

resourceid="str"name="/resource.txt"/>

--其它标签通过绑定到page作用域中的属性使用该值-->

writename="str"/>

--JSP脚本通过scripting变量使用该值-->

<%

out.println（str+"
"）;

%>

resourceid="is"input="true"name="/resource.txt"/>

--其它标签通过绑定到page作用域中的属性使用该值-->

writename="is"/>

writename="is"property="class"/>

--JSP脚本通过scripting变量使用该值-->

<%

out.println（is+"
"）;

out.println（is.getClass（）+"
"）;

%>

bean:

size

bean:

size标签创建一个java.lang.Integer类型的bean，这个bean的值为该标签指定的Collection或Map中所含元素的个数。

这可以和logic:

iterate标签配合使用，因为logic:

iterate标签不能得到所叠代的集合的元素的个数，这有时候很不方便。

下面的代码片段示例了bean:

size标签取出persons中还有元素的个数，其中listForm和persons的定义参见bean:

define标签部分：

notEmptyname="listForm"property="persons">

sizeid="size"name="listForm"property="persons"/>

writename="size"/>

notEmpty>

bean:

struts

bean:

struts标签取回Struts的内部对象formBean、forward或mapping的值，然后用id绑定到page作用域中（这种绑定是为了其它标签能够使用该值），并创建对应的scripting变量（这种变量是为了JSP脚本能够使用该值）。

下面的代码片段示例了bean:

struts标签取出listForm对象，让我们先来看一下listForm的定义在读代码：

--listForm的定义

type="org.solo.struts.form.ListForm"/>-->

strutsid="listFormBean"formBean="listForm"/>

name:

writename="listFormBean"property="name"/>

type:

writename="listFormBean"property="type"/>

dynamic:

writename="listFormBean"property="dynamic"/>

上面代码运行的结果为：

name:

listForm

type:

org.solo.struts.form.ListForm

dynamic:

false

bean:

write

bean:

write标签将指定的bean的属性值写到当前的JspWriter中，并且可以对输出进行格式化。

下面的代码片段示例了bean:

write标签输出User-Agent：

presentheader="User-Agent">

headerid="header"name="User-Agent"/>

writename="header"/>

present>

下面的代码片段示例了bean:

write标签格式化输出当前日期，其中now是在DataForm中定义的一个java.util.Da