`
flashdream8
  • 浏览: 675492 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

Struts - 标签库

阅读更多

Struts提供了五个标签库,即:HTML、Bean、Logic、Template和Nested。
 标签库
  说明
 
 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 标签的设计原意是为了避免使用scriptlet,scriptlet的表达式还能够提供给所有的Struts 标签使用。但请确保使用完整的表达式:

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

 
 
Html 标签库
<html>标签
它有两个属性:locale和xhtml,两者都不是必需的。

 <html:html locale="true">

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

说明:生成的结果取决于Struts应用程序所位于的服务器的locale。如果你将应用程序部署到一个不同locale的服务器,你不需要改变代码,Locale会自动调整。
<base>标签:表示所包含页面的绝对位置。这个标签只有内嵌在head标签中才有效。

 <html:base/>

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

<img>标签
最重要的属性page:图象文件的路径,前面必须带有一个斜线。
其它属性:heignt、width、alt。
  <html:img page="/logo.gif" height="50"  width="200" alt="Web Logo"/>

<link>标签

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

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

<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:相应的信息在错误信息的单独列表后显示。
<form>标签系列
使用<form>标签时必须遵循一些规则:
标签中必须包含一个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相关联的。


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

<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属性,当然还有name和value属性。

<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.) select和option标签
<html:select> 的属性:property-与ActionForm中的某个属性对应;size-显示option的数目;multiple-默认为fales,表示不能多选,当设定为true时,property对应的ActionForm的属性必须为数组。
<html:select property="name" size=6 multiple="true">
<html:option>的属性:key、local、bundle-指定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的集合中存放了options,value指实际能被提交的值,label是显示给用户的值。
例2 <html:options property="value" labelProperty="label" /> collection属性不被指定时,将使用表单相关的form bean,form bean中value属性存放option value,label属性值显示给用户。
例3 <html:options name="valueBean" property="values" labelName="labelsBean" labelProperty="labels" /> 这个意思是value值存放在名为valueBean的bean的vlaues属性中,它是一个collection;label值也是同样的意思。
<html:optionsCollection>标签,和<html:options>的用法很相似。
例如 <html:select property="custId"><html:optionsCollection property="customers" label="name" value="custId" /></html:select>
这个标签和org.apache.structs.util.LabelValueBean结合的很好,如果把label和value都放到这个对象中,可以很简单的这样应用:
<html:select property="custId"><html:optionsCollection property="customers" /></html:select>


本篇文章来源于 新技术天空 原文链接:http://www.ntsky.com/tech/java/opensource/struts/2007-04-17/8ba37e2140878bd9.html

分享到:
评论

相关推荐

    struts-el-1.3.10.jar struts-el.jar strutsEL标签库

    struts-el-1.3.10.jar struts-el.jar strutsEL标签库

    struts的tld标签库文件

    ·struts-bean标签库。在将JavaBean代码放入JSP 页面时这个库提供实质性的加强的功能以改善其性能,它由标签提供。 ·struts-logic标签库。这个库可管理有条件的文本生成,在对象集合中循环以重复生成输出文本和应用...

    struts-html标签

    首先,使用Struts HTML标签前,需要在`web.xml`配置文件中声明`struts-html.tld`文件的位置,这是标签库描述符文件(TLD),包含了所有可用标签的定义。声明如下: ```xml &lt;taglib-uri&gt;struts-html&lt;/taglib-uri&gt; ...

    struts-menu文件

    此外,还需要在JSP页面上使用Struts-menu提供的标签库来展示菜单。 7. **权限控制**:Struts-menu支持与Spring Security或Apache Shiro等权限管理框架集成,可以实现菜单项的动态显示,根据用户的权限来决定哪些...

    struts2标签库struts2标签库struts2标签库

    "Struts2标签库详解" Struts2标签库是Struts2框架中的一个重要组件,它提供了一系列的标签,帮助开发者快速构建Web应用程序。在Struts2标签库中,标签可以分为UI标签和非UI标签两大类。UI标签用于生成HTML控件,如...

    struts-1.2.9-lib.zip和struts-1.2.9-src.zip

    2. **标签库**:包括`struts-bean.jar`、`struts-html.jar`、`struts-logic.jar`和`struts-nested.jar`等,提供了一系列预定义的JSP标签,如logic标签用于流程控制,bean标签用于展示数据,html标签则用于表单元素的...

    struts-1.3.8-lib(new)

    8. **struts-taglib.jar**:包含了Struts的所有标签库。 9. **struts-tiles-extras.jar**:扩展了Tiles的功能。 10. **commons-logging.jar**:Apache Commons Logging,日志服务接口。 11. **commons-chain.jar**:...

    Struts标签库 Struts 标签库

    Struts2标签库是Java开发Web应用程序时常用的一个强大工具,尤其在构建MVC(Model-View-Controller)架构的应用程序中发挥着重要作用。Struts2框架提供了丰富的自定义标签库,极大地简化了视图层的开发,使得开发者...

    jakarta-struts-1.1.zip_jakarta-Struts-1_jakarta-struts 1_jakarta

    JSP Tags(Struts Tags)是定制的JSP标签库,简化了视图层的开发,如表单、数据展示等。 在"www.pudn.com.txt"这个文件中,可能包含的是与Jakarta Struts相关的资源链接或者一些额外的说明,例如教程、示例代码或...

    struts-1.3.8-all.zip

    此外,还需要编写ActionForm类,实现业务逻辑的Action类,以及使用JSP和Struts标签创建用户界面。 Struts 1.3.8虽然已经是一个较老的版本,但它的设计理念和模式在现代Web开发中仍然有其价值。例如,MVC模式被广泛...

    struts-bean标签

    Struts-Bean标签是Struts框架提供的一组用于在JSP页面中操作和管理JavaBean的标签库。这些标签使得开发者能够方便地访问和操作JavaBean的属性,以及处理HTTP请求头、参数和Cookie信息。以下是对Struts-Bean标签库中...

    Struts-Menu实例教程

    - **struts-config.xml**:在Struts的核心配置文件中,需要添加Struts-Menu的相关拦截器和标签库引用,以便在页面上使用。 4. **创建菜单模型** 在Java类中,可以定义一个菜单模型,用来存储菜单的数据。这些模型...

    struts-tags.tld Eclipse使用struts2标签库tld文件

    Eclipse使用struts2标签库tld文件

    Struts所有jar包、DTD文件(struts-1.2.9-bin.rar)

    2. **标签库**:如`struts-bean.jar`、`struts-html.jar`和`struts-tiles.jar`,它们分别提供Bean标签、HTML标签和Tiles布局支持。 3. **国际化支持**:如`struts-resources.jar`,包含用于多语言环境的资源文件。 4...

    struts1标签库详解

    Struts1 标签库详解 Struts1 标签库是 Apache Jakarta 的一个著名的开源项目,目标是为构建基于 Java 的 web 应用程序提供一个框架。Struts 提供了非常多的标签,依据功能和使用习惯的不同被分到了五个标签库中:...

    struts-menu集成struts2.3.1例子以及注意的地方

    这通常涉及到自定义拦截器或者标签库。 5. **使用`struts-menu`标签**:在JSP页面中,使用`struts-menu`提供的标签来渲染菜单。这些标签会根据配置的数据源生成HTML代码。 6. **注意事项**:集成过程中可能会遇到...

    struts-2.5.22-all.zip

    在标签中提到了"struts2 2.5.22 jar",这表明除了核心库之外,可能还有其他相关库文件,例如struts2的插件或者特定的配置文件。这些库文件对于开发基于Struts2的应用程序至关重要,它们提供了框架的扩展性和灵活性,...

    使用Struts-menu轻松实现网页菜单.doc

    此版本包含核心库`struts-menu-2.4.1.jar`和Web应用包`struts-menu-2.4.1.war`,后者需解压后获取所需文件。 #### 集成Struts-menu 要将Struts-menu集成到现有的Struts应用中,需遵循以下步骤: 1. **放置JAR包**...

    struts2标签库例子

    Struts2 标签库详解 Struts2 提供了一个强大的标签库,用于简化 Web 应用程序的开发过程。这些标签可以分为两类:通用标签和 UI 标签。下面,我们将详细介绍 Struts2 标签库的使用。 4.1 通用标签 通用标签用来...

    struts-2.5.20-all.rar

    - 创建视图页面,如JSP,使用Struts2标签库。 通过深入学习和实践,开发者可以充分利用Struts2的优势,构建高效、可维护的Web应用。不过,值得注意的是,尽管Struts2在过去的几年中非常流行,但现在已被Spring Boot...

Global site tag (gtag.js) - Google Analytics