ITeye博客

struts1的常用的标签

xiajava2011 · 2011-03-26 22:42 · 企业架构 · Markdown

Bean标签库共有 11个标签。这些标签可以完成如下五种工作:

  1.   获得 HTTP请求信息
    
  2.   访问 Java对象
    
  3.   访问 JSP内嵌对象和 Struts配置对象
    
  4.   访问 Web资源和属性文件
    
  5.   输出信息
    

下面我们就来分别介绍一下如何使用 Bean标签库中的标签来完成上述的工作。

一、获得 HTTP 请求信息

使用 Bean标签库中的标签可以访问 Cookie、 HTTP请求头以及请求参数。

1.  <bean:cookie> 标签

bean:cookie标签用于获得一个 Cookie对象,并创建一个 page范围的变量来保存这个 Cookie对象。 bean:cookie标签有三个常用属性:

( 1) id:用于保存 Cookie对象的变量名。

( 2) name: Cookie名

( 3) value: Cookie的默认值。如果 name所指的 Cookie不存在, bean:cookie标签就会创建一个新的 Cookie对象,而 value属性的值就是这个 Cookie对象的 value属性值。如果忽略 value属性,当 bean:cookie标签未找到 name指写的 Cookie时,就会抛出一个 javax.servlet.jsp.JspException异常。因此,笔者建议在使用这个标签时加上 value属性。

  1. bean:header 标签

    bean:header 标签用于获得 HTTP请求头字段的值,并创建一个 page范围的变量来保存请求头字段的值。 bean:header标签有三个常用属性:

( 1) id:用于保存 HTTP请求头字段值的变量名。

( 2) name: HTTP请求头字段名。

( 3) value: HTTP请求头字段的默认值。如果 name所指的 HTTP请求头字段不存在, bean:header标签就会将 value属性的值存在 page范围的变量中。如果不指定 value属性,且指定的 HTTP请求头字段不存在时, bean:header标签就会抛出 javax.servlet.jsp.JspException异常。

  1. bean:parameter 标签

bean:parameter标签用于获得 HTTP请求参数的值,并创建一个 page范围的变量来保存所获得的 HTTP请求参数的值。 bean:parameter标签有三个常用属性:

( 1) id:用于保存 HTTP请求参数值的变量名。

( 2) name: HTTP请求参数名。

( 3) value: HTTP请求参数值的默认值。如果 name所指的 HTTP请求参数不存在, <bean:parameter >标签就会将 value属性的值存在 page范围的变量中。如果不指定 value属性,且指定的 HTTP请求参数不存在时, bean:parameter标签就会抛出 javax.servlet.jsp.JspException异常。

下面的例子演示了如何使用本节所讲的三个 Bean标签来获得 HTTP请求信息,在 <samples工程目录 >中建立一个 httpRequestInfo.jsp文件,代码如下:

<% @ taglib uri = " http://struts.apache.org/tags-bean " prefix = " bean " %> < html > < head > < title > 获得HTTP请求信息 </ title > </ head > < body > <% -- 测试bean:cookie标签 -- %> < bean:cookie id ="myCookie" name ="name" value ="default" />
<%
if (myCookie.getValue().equals( " default " )) { Cookie cookie = new Cookie( " name " , " newCookie " ); cookie.setMaxAge( 1000 ); response.addCookie(cookie); } %> ${myCookie.value} <% -- 用EL输出myCookie的value属性值 -- %> <%
// ${myCookie.value}相当于如下Java代码 Cookie cookie = (Cookie)pageContext.getAttribute( " myCookie " ); out.println(cookie.getValue());
%> < br > <% -- 测试bean:header标签 -- %> < bean:header id ="userAgent" name ="user-agent" value ="unknown" /> ${userAgent} < br > <% -- 用EL输出userAgent的值 -- %> <% -- 测试bean:parameter标签 -- %> < bean:parameter id ="myCountry" name ="country" value ="unknown" /> ${myCountry} <% -- 用EL输出myCountry的值 -- %> </ body >

在IE中输入如下的URL来测试httpRequestInfo.jsp:

http://localhost:8080/samples/httpRequestInfo.jsp?country=China

要注意的是,上述的三个 Bean标签都将变量保存到了 page范围内(也就是 JSP内嵌对象 pageContext中),并且不能改变变量的保存范围。读者在使用这三个 Bean标签时应注意这一点。

二、访问 Java 对象

  1. bean:define标签

bean:define标签用来将 Java对象的属性值保存在变量中。 bean:define标签有五个常用属性:

( 1) id:变量名。

( 2) name: Java对象名。

( 3) property: Java对象属性名。

( 4) scope: name所指的 Java对象所在的访问,如果不指定,默认是 page范围。

( 5) toScope: id所指的变量要保存的范围,如果不指定,默认是 page范围。

  1. bean:size标签

bean:size标签用来获得集合( Map、 Collection)或数组的长度。 bean:size标签有两个常用的属性:

( 1) id:一个 Integer变量

( 2) name:集合或数据的变量名。

下面的例子演示了如何使用本节所讲的两个 Bean标签来访问 Java对象。在 <samples工程目录 >目录中建立一个 accessJavaObject.jsp文件 , 代码如下 :

<% @ taglib uri = " http://struts.apache.org/tags-bean " prefix = " bean " %> < html > < head > < title > 访问Java对象 </ title > </ head > < body > <% -- 建立actionform.HtmlTagsForm对象实例 -- %> < jsp:useBean id ="htmlTagsForm" class ="actionform.HtmlTagsForm" /> < jsp:setProperty name ="htmlTagsForm" property ="name" value = "李宁" /> <% -- 测试bean:define标签 -- %>
< bean:define id ="myBeanVar" name ="htmlTagsForm" property ="name" /> ${myBeanVar} <% String arr = new String ; pageContext.setAttribute( " arr " , arr); %>
<% -- 测试bean:size标签 -- %>
< bean:size id ="length" name ="arr" /> ${length} </ body >

在 IE中输入如下的 URL来测试 accessJavaObject.jsp:

http://localhost:8080/samples/accessJavaObject.jsp

三、访问 JSP 内嵌对象和 Struts 配置对象

1. <bean:page>标签
<bean:page> 标签用来建立一个 page范围的变量,并可通过这个变量来访问 JSP的内嵌对象。这个标签有两个属性:

( 1) id:变量名。

( 2) property: JSP内嵌对象名,必须是 application、 config,、 request、 response或 session其中之一。

2. <bean:struts> 标签

bean:struts标签用来建立一个 page范围的变量,并可通过这个变量来访问 Struts的三个配置对象。这个标签有四个属性:

( 1) id:变量名。

( 2) formBean: struts-config.xml文件中的 标签的 name属性值。如果指定这个属性, bean:struts会创建 org.apache.struts.action.ActionFormBean类型的对象实例。

( 3) mapping: struts-config.xml文件中的 标签的 path属性值。如果指定这个属性, bean:struts会创建 org.apache.struts.action.ActionMapping类型的对象实例。

( 4) forward: struts-config.xml文件中的 标签的子标签 的 name属性值。如果指定这个属性, bean:struts会创建 org.apache.struts.action.ActionForward类型的对象实例。

在使用 bean:struts标签时应注意,在满足下面三种情况中的一种, bean:struts就会抛出异常:

( 1)同时使用了 formBean、 mapping和 forward中的两个或三个。

( 2)未指定 formBean、 mapping和 forward

( 3) formBean、 mapping或 forward所指的标签不存在。

下面的例子演示了 <bean:page>和 <bean:struts>标签的使用方法,在 <samples工程目录 >目录中建立一个 accessEmbeddedObject.jsp文件,代码如下:

<% @ taglib uri = " http://struts.apache.org/tags-bean " prefix = " bean " %> < html > < head > < title > 访问JSP内嵌对象和Struts配置对象 </ title > </ head > < body > < bean:page id ="myRequest" property ="request" /> myRequest.characterEncoding = ${myRequest.characterEncoding} < br > myRequest.contextPath = ${myRequest.contextPath} <% out.println(myRequest.getParameter( " abc " )); %> < bean:struts id = "myHtmlTagsForm" formBean ="htmlTagsForm" />< br > myHtmlTagsForm.type = ${myHtmlTagsForm.type} < br > myHtmlTagsForm.getClass() = ${myHtmlTagsForm.class} < bean:struts id = "myHtmlTags" mapping ="/htmlTags" />< br > myHtmlTags.type = ${myHtmlTags.type} < br > myHtmlTags.getClass() = ${myHtmlTags.class} < bean:struts id = "myNewProduct" forward ="newProduct" />< br > myNewProduct.path = ${myNewProduct.path} < br > myNewProduct.getClass() = ${myNewProduct.class} </ body >

四、访问 Web 资源和属性文件

  1. bean:include标签

bean:include标签用于获得相对或绝对路径的 Web资源,并将这些资源的内容保存到 page范围的变量中。 bean:include标签有四个常用的属性:

( 1) id:变量名。

( 2) href: Web资源的绝对路径。

( 3) page: Web资源的相对路径。以“ /”开头。

( 4) forward: struts-config.xml文件 元素的子元素 的 name属性值。如果指定这个属性, bean:include标签会自动获得 的 path属性所指的 Web资源的内容。

  1. bean:resource标签

bean:resource标签和 bean:include标签类似,也用来获得 Web资源的内容,但和 bean:include的不同之处是 bean:resource在访问 Web资源时(如 JSP页面),并不执行这个 JSP页面,而是将整个 JSP页面的原始内容保存到变量中,而 bean:include在访问这个 JSP页面时,会先执行这个 JSP页面,然后将 JSP页面执行后的结果保存在变量中。因此,使用 bean:include访问 Web资源和在 IE中输入相应的 URL的效果是一样的。而 bean:resource获得的是 JSP页面的源代码。

bean:resource标签有三个属性:

( 1) id:变量名。

( 2) name: Web资源的相对路径。以“ /”开头。

( 3) input:如果指定 input属性, id变量为 java.io.InputStream类型,如果未指定 input属性, id变量为 String类型。

3. <bean:message>标签

bean:message标签用于从 Java属性文件中获得字符串信息。要注意的是, bean:message标签获得字符串信息后,并不将所获得的信息保存在变量中,而是将其直接输出,也就是在执行 JSP页面时,在生成客户端内容时, bean:message标签会被属性文件中的字符串信息代替。 bean:message标签的常用属性如下:

( 1) key:属性文件中的字符串信息键名。

( 2) bundle: struts-config.xml文件中的 标签的 key值属值。如果不指定 bundle属性,就使用默认的属性文件。

( 3) name:用于获得键名的字符串变量名或对象实例变量名。 bean:message标签除了从 key属性中获得键名,还可以通过将 key保存在指定范围的变量中,然后通过 name属性获得这个 key。

( 4) property:获得 key的属性名。如果 name属性为对象实例变量名,则 bean:message标签会从 property所指的属性中获得 key。

( 5) scope: bean:message标签获得 name变量的范围。默认值是 page。

( 6) arg0 ~ arg4 :用于向带参数的字符串信息中传入参数值。分别对应于属性文件中的 {0} ~ {4}。

下面的例子演示了本节所涉及到的三个标签的使用方法。在运行这个例子之前,先在<samples工程目录>"src"struts目录中建立一个MyResources.properties文件,并输入如下的内容:

myGreet = hello { 0 }

然后在struts-config.xml中的元素中添加如下的子标签:

最后在 <samples工程目录 >中建立一个 accessResources.jsp文件,代码如下:

<% @ page import = " actionform.HtmlTagsForm " %> <% @ taglib uri = " http://struts.apache.org/tags-bean " prefix = " bean " %> < html > < head > < title > 访问Web资源和属性文件 </ title > </ head > < body > < bean:include id ="myWebVar1" href ="http://localhost:8080/samples/simpleValidation.jsp" /> < bean:include id ="myWebVar2" page ="/htmlTags.jsp" /> < bean:include id ="myWebVar3" forward ="newProduct" /> ${myWebVar1} ${myWebVar2} ${myWebVar3}

       < bean:resource  id ="myResVar"  name ="/htmlTags.jsp"   />
      ${myResVar}
       <% --   从MyResources.properties中获得信息  -- %>  
       < bean:message  bundle ="my"  key ="greet"   />
       <% --   从ErrorDescription.properties中获得信息  -- %>  
       < bean:message  key ="error.email.invalid"   />
       < bean:message  bundle ="my"  key ="myGreet"  arg0 ="李宁"   />

       <%
      request.setAttribute( " newGreet " ,  " greet " );
       %>
       < bean:message  bundle ="my"  name ="newGreet"   />

评论(0)

暂无评论。

评论功能维护中,当前仅展示历史评论。