关闭

struts标签

607人阅读 评论(0) 收藏 举报

JSP StrutsHTML标签库详解

Struts提供了五个标签库,即:HTMLBeanLogicTemplateNested

 标签库

 说明

 HTML 标签

 用来创建能够和Struts 框架和其他相应的HTML 标签交互的HTML 输入表单

 Bean 标签

 在访问JavaBeans 及其属性,以及定义一个新的bean 时使用

 Logic 标签

 管理条件产生的输出和对象集产生的循环

 Template 标签

 随着Tiles框架包的出现,此标记已开始减少使用

 Nested 标签

 增强对其他的Struts 标签的嵌套使用的能力

 

标签的公共特征

 

使用固定属性名称的Struts 标签:

 属性

 说明

 id

 命名自定义标签创建时的脚本变量名。

 name

 指出关键字值,在该关键字下可以找到一个存在的bean 。如果给出了scope属性,则仅仅在scope中查找。否则,根据标准的顺序在各种scope中查找:(page, request, session, or application)

 property

 指出bean 中的某个属性,可以在其中检索值。如果没有标明,则使用对象本身的值。

 scope

 定义了Bean在哪个范围(page, request, session, or application)中被查找。如果没有标明按顺序查找。脚本变量(id)将在相同的范围中创建。

 

Struts 标签也支持嵌套引用,例如:

Property="foo.bar.baz"

这相当于进行下面的调用:
getFoo().getBar().getBaz()


或者做为setter
getFoo().getBar().setBaz(value)

 

虽然Struts 标签的设计原意是为了避免使用scriptletscriptlet的表达式还能够提供给所有的Struts 标签使用。但请确保使用完整的表达式:

 错误:
 <html:link href="'<%= "/" + name %>/index.jsp>'>
 
 
正确:
 <html:link href="'<%= "/" + name + "/index.jsp" %>'>    //
表达式必须提供整个属性值

 

 

Html 标签库

1.        <html>标签
它有两个属性:localexhtml,两者都不是必需的。

 <html:html locale=/"true/">

 
此行代码解析后:
 <html lang=/"en/">

2.        说明:生成的结果取决于Struts应用程序所位于的服务器的locale。如果你将应用程序部署到一个不同locale的服务器,你不需要改变代码,Locale会自动调整。

3.        <base>标签:表示所包含页面的绝对位置。这个标签只有内嵌在head标签中才有效。

 <html:base/>

 
此行代码解析后:
 <base href=/"http://www.mymain.com/myStrutsApp/testing.jsp/">

4.        <img>标签
最重要的属性page:图象文件的路径,前面必须带有一个斜线。
其它属性:heigntwidthalt

  <html:img page=/"/logo.gif/" height=/"50/"  width=/"200/" alt=/"Web Logo/"/>

5.        <link>标签

 <html:link page=/"/index.html/">Click demo</html:link>

 
此行代码解析后:
  <a href=/"/index.html/">Click demo</a>

6.        <errors>标签:通过一个简单的<html:errors/>标签,你就可以在一个JSP页面上显示完全自定义的错误信息。功能超强大!!
说明:这个标签在Request对象的属性集合中查找reserved key。如果它找到一个reserved key,它就假设这个key是一个String、或是一个String数组  
       
(它包含在模块的MessageResources中查找的message keys)、或是类型为org.apache.struts.action.ActionErrors的一个对象。
          
如果在应用程序资源中存在相应的信息,那么就可以用下面这些可选的message keys  
         · errors.header  or  errors.prefix
:相应的信息在错误信息的单独列表前显示。 
         · errors.footer or  errors.suffix
:相应的信息在错误信息的单独列表后显示。

7.        <form>标签系列
使用<form>标签时必须遵循一些规则:

1.        标签中必须包含一个action属性,它是这个标签中唯一必需的属性。如果不具备该属性则JSP页面会抛出一个异常。之后你必须给这个action属性指定一个有效值。一个有效值是指应用程序的Struts配置文件中元素里的任何一个子元素的访问路径。而且相应的元素中必须有一个name属性,它的值是form bean的名称。

 <html:form action=/"/login/" > 

 
如果你有上述一个标签 ,那么你的Struts配置文件的元素中必须有一个如下显示为粗体的元素: 
<action-mappings> 
     <action path=/"/login/" 
      type=/"com.javapro.struts.LoginAction/"  
      name=/"loginForm/"
      scope=/"request/"
      input=/"/login.jsp/">
      <forward name=/"success/" path=/"/mainMenu.jsp/"/>
    </action>
    .
    .
    .
</action-mappings>  //
这就是说一个form标签是和form bean相关联的。

2.         

3.        任何包含在<form>中用来接收用户输入的标签(<text><password><hidden><textarea><radio><checkbox><select>)必须在相关的form bean中有一个指定的属性值。比如,如果你有一个属性值被指定为“username”<text>标签,那么相关的form bean中也必须有一个名为“username”的属性。输入<text>标签中的值会被用于生成form beanuserName属性。


<form>
标签还有一些不是必须但很有用的次要属性。
比如,你可以用focus属性来生成JavaScript,它会定焦focus)到该form所包含的一个元素上。使用focus属性时你需要给它指定元素的名称。

 <body>
 <html:form action=/"/login/" focus=/"password/">
 User Name: <html:text property=/"userName/"/>
 <br>Password: <html:text property=/"password/"/>
 <br><html:submit/>
 </html:form>
 </body>

 
代码解析后:
 <body>
 <form name=/"loginForm/" method=/"post/"  action=/"/myStrutsApp/login.do/">
 User Name: <input type=/"text/" name=/"userName/"  value=/"/">
 <br>Password: <input type=/"text/"  name=/"password/" value=/"/">
 <br><input type=/"submit/"   value=/"Submit/">
 </form>
 <script language=/"JavaScript/"  type=/"text/javascript/">
  <!--
  if (document.forms[/"loginForm/"].elements[/"password/"].type != /"hidden/") 
       document.forms[/"loginForm/"].elements[/"password/"].focus()
  // -->
 </script>

 </body>

有没有看到这个标签库是如何建立JavaScript来定焦到password元素上的这也是该库让人着迷的地方之一。你不用担心如何在客户端进行编程,它会帮你自动生成。
还可以看到,<form>标签中method属性的缺省值是POST

<text>
标签、<hidden>标签、<textarea>标签、<radio>标签、<checkbox>标签、<submit>标签、<reset>标签:
都有一个property属性,最后会被转换成HTML中的name属性,当然还有namevalue属性。

<password>
标签

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

该标签中的一个很重要的属性是"redisplay",它用于重新显示以前输入到这个区域中的值。该属性的缺省值为true。然而,为了使password不能被重新显示,你或许希望将该属性的值设为false

<select>
标签和<option>标签: 

 <html:select property=/"color/" size=/"3/">
  <html:option value=/"r/">red</html:option>
  <html:option value= /"g/">green</html:option>
  <html:option value= /"b/">blue</html:option>
 </html:select>

遗补1.) <html:link>标签

forward属性:链接到一个global forward上;action属性:链接到一个action mapping上;
href
属性:这个链接会转发给控制器,由控制器做决定;page属性:一个相对的链接。

page属性链接到action上:

  <html:link page="/html-link.do">
   Linking with the page attribute.
 </html:link>


注意,上面的代码中你不必指定web的关联。相反的,如果你使用href属性,你就必须像下面所示指出web的关联(这里的关联就是struts-exercise)

 <html:link href="/struts-exercise-taglib/html-link.do">
   Using Href
 </html:link>


很明显,当你在相同的web应用程序中做链接是,它比page属性更加好。你也能用href在不同的服务器上创建链接:

 <html:link href="http://otherserver/strutsTut/html-link.do">
  Using Href
 </html:link>


另一种链接到html-link.do的方法是用action属性:

 <html:link action="/html-link">
  Using Action attribute
 </html:link>


你也可以以硬编码的方式使用参数:

 <html:link page="/htmllink.do?doubleProp=3.3&amp;longProp=32">
   Double and long via hard coded changes
 </html:link>


或者使用paramId, paramName, and paramProperty属性:

 <html:link page="/html-link.do" paramId="booleanProperty" paramName="testbean"
   paramProperty="nested.booleanProperty">
   Boolean via paramId, paramName, and paramValue
</html:link>


解析后的代码:

 <a href="/struts-exercise-taglib/html-link.do?booleanProperty=false">
    Boolean via paramId, paramName, and paramValue
 </a>


另外,还能使用带name属性的Map来实现传递多个参数:

 <%
java.util.HashMap newValues = new java.util.HashMap();
newValues.put("floatProperty", new Float(444.0));
newValues.put("intProperty", new Integer(555));
newValues.put("stringArray", new String[]
{ "Value 1", "Value 2", "Value 3" });
pageContext.setAttribute("newValues", newValues);
%>
...
 <html:link action="/html-link" name="newValues">
    Float, int, and stringArray via name (Map)
 </html:link>


你也能够链接到Map类型的action上,上面的代码解析后的结果:

 <html:messages property="property2" message="true" id="msg" header="messages.header" footer="messages.footer">
 <tr><td><%= pageContext.getAttribute("msg") %></td></tr>
 </html:messages>

2.) selectoption标签
<html:select>
的属性:property-与ActionForm中的某个属性对应;size-显示option的数目;multiple-默认为fales,表示不能多选,当设定为true时,property对应的ActionForm的属性必须为数组。
<html:select property="name" size=6 multiple="true">
<html:option>
的属性:keylocalbundle-指定Resource Bundle中的内容。
例如 <html:option value="color1">Orange</html:option>
<html:option value="color1" bundle="htmlselect.Colors" key="htmlselect.red"/>
它和配置文件中的<message-resources>元素的key属性匹配 --> <message-resource parmeter="HtmlSelectColors" key="htmlselect.Colors"/>
<message-resource>
中配置的资源文件为HtmlSelectColors.properties,相关内容为 htmlselect.red=RED
<html:options>
标签,提供了一组<option>元素,在<html:select>元素中可以包含多个<html:options>元素。非常灵活,可以取得集合或数组中的值。
1 <html:options collection="coll" property="value" labelProperty="label" /> 这指在coll的集合中存放了optionsvalue指实际能被提交的值,label是显示给用户的值。
2 <html:options property="value" labelProperty="label" /> collection属性不被指定时,将使用表单相关的form beanform beanvalue属性存放option valuelabel属性值显示给用户。
3 <html:options name="valueBean" property="values" labelName="labelsBean" labelProperty="labels" /> 这个意思是value值存放在名为valueBeanbeanvlaues属性中,它是一个collectionlabel值也是同样的意思。
<html:optionsCollection>
标签,和<html:options>的用法很相似。
例如 <html:select property="custId"><html:optionsCollection property="customers" label="name" value="custId" /></html:select>
这个标签和org.apache.structs.util.LabelValueBean结合的很好,如果把labelvalue都放到这个对象中,可以很简单的这样应用:
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

JSP StrutsBean标签库详解

Bean 标签库
        此标签库和Java Bean有很强的关联性,设计的本意是要在JSP JavaBean 之间提供一个接口。Struts 提供了一套小巧有用的标签库来操纵JavaBean和相关的对象:cookie header parameter definewritemessage includepageresourcesizestruts

1.        bean:cookiebean:headerbean:parameter
这三个标签用来重新得到cookie, request headerrequest parameter
bean:header
bean:parameter标签定义了一个字符串;bean:cookie标签定义了一个Cookie对象。你可以使用value属性做为默认值。如果找不到指定的值,且默认值没有设定的话,会抛出一个request time异常。如果你期望返回多个值的话,可把multiple属性设为true

 <bean:cookie id="sessionID" name="JSESSIONID" value="JSESSIONID-ISUNDEFINED"/>
 //
这段代码定义了一个名为sessionID的脚本变量,如果找不到一个名为JSESSIONIDcookie,那sessionID
 //
的值就被设置为JSESSIONID-ISUNDEFINED

2.       
下面代码会输出一些Cookie对象的一些属性:

 <jsp:getProperty name="sessionID " property="comment"/> …
 <jsp:getProperty name="sessionID" property="domain"/> …
 <jsp:getProperty name="sessionID" property="maxAge"/> …
 <jsp:getProperty name="sessionID" property="path"/> …
 <jsp:getProperty name="sessionID" property="value"/> …
 <jsp:getProperty name="sessionID" property="version"/> …

3.       
下面是在request中输出所有header的例子: 

 <%
        java.util.Enumeration names =((HttpServletRequest) request).getHeaderNames();
%>

<%
        while (names.hasMoreElements()) {
        String name = (String) names.nextElement();
%>
<bean:header id="head" name="<%= name %>"/>
… <%= name %>
… <%= head %>

<%
        }
%>

4.       
下面是parameter的例子:

 <bean:parameter id="param1" name="param1"/>
 <bean:parameter id="param2" name="param2" multiple="true"/>  //
此处定义了一个param2[]
 <bean:parameter id="param3" name="param3" value="UNKNOWN VALUE"/>

5.       
于其它标签结合使用:

 <bean:header id="browser" name="User-Agent"/>
<P>You are viewing this page with: <bean:write name="browser"/></P>
----------------------------------------------------------------------------------------------------------------------------------
<bean:cookie id="username" name="UserName" scope="session"
value="New User" />
<P>Welcome <bean:write name="username" property="value"/!</P> 
  //
根据cookie创建一个新的Bean,如果用户名称已经存储在cookie中,它就不显示为一个新用户。 

6.         

7.        bean:define:有三个用途。
一是定义新字符串常量:

 <bean:define id="foo" value="This is a new String"/>
 <bean:define id="bar" value='<%= "Hello, " + user.getName() %>'/>
 <bean:define id="last" scope="session" value='<%= request.getRequestURI() %>'/>

8.       
二是复制一个现有的bean给新的bean

 <bean:define id="foo" name="bar"/>   
 <bean:define id="baz" name="bop" type="com.mycompany.MyClass"/>  //
定义脚本变量的类型,默认为Object

9.       
三是复制一个现有的bean的属性给新的bean

 <bean:define id="bop" name="user" property="role[3].name"/>
  <bean:define id="foo" name="bar" property="baz" scope="request"  toScope="session"/> 
  //toScope
属性指新beanscope,默认为page   

10.     上段代码的意思是把名为barbeanbaz属性赋值给foofoo的类型为String(默认)

11.     bean:include
这个标签和bean:include标签和相似,不同点就是它定义了一个可以复用的脚本变量。用id属性命名一个新的脚本变量,还支持forwardhrefpagetransaction.属性,和html:link中的属性意义一样。

 <bean:include id="footerSpacer"  page="/long/path/footerSpacer.jsp"/> 
 
然后你能够在多个地方(scopepage)调用:
 <bean:write name="footerSpacer" />

12.      

13.     bean:message
用来实现对国际化的支持的一个标签,配合java.util数据包中定义的LocaleResourceBundle类来完成这个任务,用java.text.MessageFormat类配置消息的格式。
   
首先要指定资源文件的名称。这个文件会包含用默认语言编写的在程序中会出现的所有消息,这些消息以关键字-的形式存储。文件需要存储在类路径下,路径要作为初始化参数传送给ActionServlet
   
实现国际化的规定:所有的资源文件必须都存储在基本资源文件所在的目录中。基本资源文件包含的是用默认地区语言-本地语言编写的消息。如果基本资源文件的名称是ApplicationResources.properties,那么用其他特定语言编写的资源文件的名称就应该是ApplicationResources_xx.properties(xxISO编码,如英语是en)。因此这些文件应包含相同的关键字,但关键字的值是用特定语言编写的。
   
然后,ActionServlet的区域初始化参数必须与一个true值一起传送,这样ActionServlet就会在用户会话中的Action.LOCALE_KEY关键字下存储一个特定用户计算机的区域对象。现在可以运行一个国际化的web站点,它可以根据用户计算机上的设置的区域自动以相应的语言显示。

使用特定的字符串来替换部分消息:

 在资源文件中的定义:info.myKey = The numbers entered are {0},{1},{2},{3}
 
标记的使用:<bean:message key="info.myKey" arg0="5" arg1="6" arg2="7" arg3="8"/>
 Jsp
页面的显示:The numbers entered are 5,6,7,8  // 最多支持4个参数

14.      

15.     bean:page:把Jsp中的内部对象做为脚本变量。

<bean:page id="requestObj" property="request"/> 

16.      

17.     bean:resource:获得应用程序的资源,这个资源可以是一个String或从java.io.InputStream中读入。使用ServletContext.getResource()ServletContext.getResourceAsStream() 方法检索web应用中的资源,如果在检索资源时发生问题,就会产生一个ruquest time异常。 

 <bean:resource id="webxml" name="/WEB-INF/web.xml"/>

18.     使用input属性时,资源会做为一个InputStream,如果不指定就被当成一个String

19.     bean:size:得到存储在arraycollectionmap中的数目,类型为java.lang.Integer

 <bean:size id="count" name="employees" />

20.      

21.     bean:struts:复制Struct 对象(三种类型)给新的beanscopepage

 <bean:struts id="form" formBean="CustomerForm"/>   
 <bean:struts id="fwd" forward="success"/>
 <bean:struts id="map" mapping="/saveCustomer"/>

22.      

23.     bean:write:以字符串形式输出bean的属性值。
filter
属性:设为true时,将HTML保留字转换为实体("<" 转换为 &lt);
ignore
属性:如果对象不存在,不会抛出异常。

 <bean:write name="userRegistration" property="email" scope="request"/>

 

 

0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:2385次
    • 积分:101
    • 等级:
    • 排名:千里之外
    • 原创:3篇
    • 转载:0篇
    • 译文:0篇
    • 评论:0条
    文章分类
    文章存档
    阅读排行
    评论排行