Jakarta Struts 编程:使用Tiles框架

2024-01-11 11:08

本文主要是介绍Jakarta Struts 编程:使用Tiles框架,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

发布时间:2006.03.15 19:55 来源:Matrix 作者:javaduke

作者: Chuck Cavaness
原文: http://www.onjava.com/pub/a/onjava/excerpt/progjakstruts_14/index3.html
译者: blasterboy
Email: zhangjy@bpusoft.com.cn
MSN: sinogod928@hotmail.com

这是Jakarta Struts编程一书中使用 Tiles框架系列的第三部分,主要阐述了如何使用标记库(包括:insert, definition, put, putList, add, get, getAsString, useAttribute, importAttribute, and initComponentDefinitions).

Tiles标记库(The Tiles Tag Library)
这一部分介绍Tiles 框架使用的JSP自定义标记。表14-1列出了框架可用的标记 。这些标记与其他一些基于模板的框架所提供的标记是非常相似的,但是Tiles框架中蕴含着更丰富的功能。


表 14-1: Tiles框架标记库中的标记

标记名(Tag name) 描述(Description)
Add 增加一个元素到环境列表中。
definition 创建一个Tiles组件定义。
Get 从请求作用域中得到内容(content),这个内容是put 标
记所置入的。
GetAsString 传递tile/component/template属性指定的值到当前的
JspWriter中。
importAttribute 引入一个Tiles属性到指定的上下文(context)中;
initComponentDefinitions 初始化一个Tiles定义工厂。
Insert 插入一个Tiles组件。
Put 设置一个属性到一个Tiles上下文中。
PutList 声明一个列表,这个列表作为一个属性被传递。
useAttribute 在页面中使用一个属性值。

insert 标记
insert 标记是负责页面中插入内容。在一个Tiles布局中, insert标记使用属性值指定的内容。在非Tile布局中,insert标记是用来获得一个框架(layout)并且使用put 标记把内容传递给布局中。
表14-2列出insert 标记的属性:

表 14-2:insert 标记的属性

属性名(Attribute name) 描述(Description)
attribute 当前Tiles /组件上下文的属性名称,这个属性值是由
name 属性来传递的。
beanName Bean 的名称作为值来使用.Bean是从指定的内容中获得。
如果有的话,Bean可以从指定的上下文中获得。否则就得
使用pageContext.findAttribute( ) 方法获得。 如果
beanProperty 属性已经指定,也可以从相应Bean属性中
获得这个值 。
如果,这个Bean(或Bean的属性值)是某个属性类
(Direct, Instance,等等)的实例, 那么插入过程要依照类
的类型而定。另外,调用Bean 的toString( ) 方法,并返
回值为String,并传给name属性。
beanProperty Bean 属性(property)的名字,如果指定,那么这个值从
Bean的属性(property)中获得.
beanScope Bean的作用范围,如果没有指定,
pageContext.findAttribute( ) 方法可以使用。Bean的
范围可以是任何的JSP, 组件(component),或者模板
(template)。在后两者情况(组件,模板),bean 可
以在 Tiles (tile)/组件(component)/模板(template)
内容中
component 一个描述tile 或者 模板(template)URI的字符串. 模板
(template),页(page)和 组件(component)属
性必须有严格相同的行为
controllerUrl 在页被插入前,控制器(controller)的直接URI 。 这个URI
通常用来指示一个struct action. 这个控制器(action) 是用
来为inserted tile 准备数据的。
只能有 一个controllerUrl 或 controllerClass
controllerClass 页面(page)被插入前,直接调用的一种控制(control)类
的类型。这个类是用来为inserted tile 准备数据的。
只能有 一个controllerUrl 或 controllerClass 。这个类
实现或扩展下列类之一:
org.apache.struts.tiles.Controller,
org.apache.struts.tiles.ControllerSupport,
或org.apache.struts.action.Action.
definition Insert定义的名称。定义在一个集中的文件中被定义。现
在,仅仅一个工厂(factory)的定义可以用这个属性插入。
插入一个用definition定义的定义,用beanName="".
flush true 或者 false. 如果true, 当前页会在tile insertion.前
输出流
ignore 如果这个属性设置为 true 并且name所指定的属性不存在的
话,仅仅会返回一个什么都没有写得结果。初始值设置为
false,可以抛出一个 runtime exception
name 一个要被插入得实体(entity)的名字。查找按照下面的顺
序 definition, attribute, 然后 page.
page 一个表示tile 或者 template 的URI字符串。template,
page, 和 component 属性要严格的有同样的行为
role 如果用户是指定的角色,那么这个标记才会起作用,否则,
这个标记会被忽略掉,并且不会写出任何内容。
template 一个表示tile 或者 template 的URI字符串。template,
page, 和 component 属性要严格的有同样的行为

definition 标签
definition 标签用bean的定义方法创建一个tile (template),这个新创建的bean在requested scope用一个id来标识。definition 标签的有些语法和insert 一样。新的定义可以扩展在definition factory (XML file)中已经描述过的定义,并且可以重载以前定义的参数。

Table 14-3 列出了definition 标签支持的属性

属性名 描述
extends 可以用来扩展的父定义,这个父定义在definitions factory被
定义了。
id 定义bean的名称,这个属性是必需的
page 要插入template/component 的URL 。和template.一样。
role 在插入一个定义前,进行检查role.如果当前用户并没有定义这个
role,那么这个定义将不会被插入。再插入的时候进行检查,
而不是在定义的时候。
scope 在新定义bean 的时候被创建。如果没有指定,
默认值是page scope.
template tile/component/template (a JSP page)的URL .
下面的片断展示了如何在JSP中使用definition标签。

<tiles:definition id="storefront.default" page="/layouts/storefrontDefaultLayout.jsp" scope="request"> <tiles:put name="header" value="/common/header.jsp" /> <tiles:put name="menubar" value="/common/menubar.jsp" /> <tiles:put name="copyright" value="/common/copyright.jsp" /> </tiles:definition>

一个完整的例子将在这章后面的"Declaring Definitions in a JSP Page" 中展示

put 标签
put 标签用来传递属性到一个tile 组件。 这个标签只能在insert 或 definition 标签内部使用。 put标签的值被value 属性或者标签体指定。也经常被指定值得类型。
string: 文如其名
page 或template: 内容包含指定的URL. 名字通常以URL用.
definition: 内容从指定(from factory)的定义获得. 名字以已定义的名字使用。如果type 已经使用, 他就会被get 或 insert 标签插入到tile. 如果type 属性没有被指定,则内容是不确定的untyped,除非它来自一个typed bean.
提示: Setting direct="true" 与setting type="string" 是相同的.

Table 14-4 列出了put 标签的属性。

属性名 描述
beanName Bean 的名称,和值(value)的使用方法一样.Bean是从
特殊的内容中获得。如果有的话,还可以用
pageContext.findAttribute( ) 方法获得。 如果
beanProperty 属性已经指定,可以从相应Bean属性中获
得这个值 。
beanProperty Bean 属性(property)的名字,如果指定,那么这个值从
Bean的属性(property)中获得.
beanScope Bean的作用范围,如果没有指定,
pageContext.findAttribute( ) 方法可以使用。Bean的
范围可以是任何的JSP, 组件(component),或者模板
(template)。在后两者情况(组件,模板),bean 可以
在 Tiles (tile)/组件(component)/模板(template) 内
容中
content Content 在tile 范围内。 属性相当于value 属性,增加是
为了于JSP template tags 兼容。.
Direct Content的控制方法: true意味着Content直接显示; false
意味着content 被包含。 false 是默认值。也是指定
content 类型的一种方法。如果 direct="true", content
是 "string"; 如果 direct="false", content 是 "page".
增加这个属性是为了于JSP template tags 兼容。.
Name 属性的名称(name).
Role 如果用户是指定的角色,那么这个标记才会起作用,否则,
这个标记会被忽略掉,并且不会写出任何内容。
Type content 的类型(type)。有效值
是"string", "page", "template", 或 "definition".
Value 属性的值,可以是String 或者 Object. 值是直接被分配
的。 (value="aValue") 或者从一个bean 获得。一个
value, content, 或 beanName 一定存在。
putList 标签
putList 标签建立一个list,在 tile 中以值传递。 list 元素用add 标签增加。这个标签只能在insert 或definition 标签中使用。

Table 14-5 列出putList 标签的属性。

属性名 描述
Name List 的名称。这个属性是被要求的。

add 标签
add 标签是增加一个element 到周围的list 中。这个标签只能在putList 标签中使用。这个值可以直接被分配。 (value="aValue") 或者从一个bean中获得。 一个value 或beanName 必须被指定。

Table 14-6 列出 add 标签的属性。

属性名 描述
beanName Bean 的名称,和值(value)的使用方法一样.Bean
是从特殊的内容中获得。如果有的话,还可以用
pageContext.findAttribute( ) 方法获得。 如果
beanProperty 属性已经指定,可以从相应Bean属性
中获得这个值 。
beanProperty Bean 属性(property)的名字,如果指定,那么这
个值从Bean的属性(property)中获得.
beanScope Bean的作用范围,如果没有指定,
pageContext.findAttribute( ) 方法可以使用。
Bean的范围可以是任何的JSP, 组件
(component),或者模板(template)。在后两者
情况(组件,模板),bean 可以在 Tiles (tile)/组件
(component)/模板(template) 内容中content
和value 属性相同。增加这个属性是为了于JSP
template tags 兼容。
direct Content的控制方法: true意味着Content直接显示;
false 意味着content 被包含。 false 是默认值
role 如果用户是指定的角色,那么这个标记才会起作用,否
则,这个标记会被忽略掉,并且不会写出任何内容。如果
add 标签在定义中被定义,则role不会起什么作用。.
type content 的类型(type)。有效值
是"string", "page", "template", 或 "definition".
如果type 属性没有指定,则 content 是没有类型的
(untyped)除非它从一个bean 类型中获得。.
value 增加的值。可以是String 或者 Object.

get 标签
get 标签是从 tile 文中获得内容。并且把它插入到页面中。

Table 14-7 列出get 标签的属性。

属性名 描述
flush true 或者 false. 如果true, 当前页会在tile insertion.前输出流.
ignore 如果这个属性值被设置为 true 并且属性被指定的名字不存在,
只会简单的返回一个什么都没有的结果。默认值是false, 它可以引
起一个runtime exception 的抛出。
name 从 tile 范围内得到的内容的名称。这个属性是要求的。
role 如果用户是指定的角色,那么这个标记才会起作用,否则,这个标
记会被忽略掉,并且不会写出任何内容。

getAsString 标签
getAsString标记负责查找tile属性指定的属性值,并作为字符串传给当前的JspWriter对象,一般使用toString()方法进行转换。如果不存在,将会抛出一个JSPException异常。表14-8列出了这个标记的属性:

Table 14-8: getAsString标记属性

属性名 描述
ignore 如果这个属性值被设置为 true 并且属性被指定的名字不存在,只
会简单的返回一个什么都没有的结果。默认值是false, 它可以引起
一个runtime exception 的抛出。
name 属性的名称(name). 这个属性是要求的
role 如果用户是指定的角色,那么这个标记才会起作用,否则,这个标
记会被忽略掉,并且不会写出任何内容。

useAttribute标记
useAttribute 标记在指定的范围内使用tile的属性值声明了一个Java 变量和一个属性。这个变量和属性由id指定一个名字,如果没有指定,则是original name 。

Table 14-9 列出了useAttribute tag的属性。

属性名 描述
classname 声明变量的类名
id 属性和变量所声明的名称
ignore 如果这个属性值被设置为 true 并且属性被指定的名字不存
在,只会简单的返回一个什么都没有的结果。默认值是
false, 它可以引起一个runtime exception 的抛出。
name 属性的名称(name). 这个属性是要求的
scope 声明属性的Scope.默认是"page".

importAttribute标记

importAttribute 标记从tile 中插入一个属性到被请求的作用域。name 和 scope 属性是可选的。如果没有指定,所有的属性将引入到page作用域 中. 一旦引入,这个属性可以像其他在JSP中的BEAN一样使用。
Table 14-10 列出了 importAttribute 标签的属性

Table 14-10: importAttribute标记属性

属性名 描述
ignore 如果这个属性值被设置为 true 并且属性被指定的名字不存在,只
会简单的返回一个什么都没有的结果。默认值是false, 它可以引起
一个runtime exception 的抛出。
name Tile的属性名。如果没有指定,则所有的属性将被引入。
scope 被引入属性的scope属性,默认值"page".
initComponentDefinitions标记
initComponentDefinitions标记初始化定义工厂。

Table 14-11: initComponentDefinitions标记的属性

属性名 描述
classname 如果指定,值为创建和初始化工厂属性的类名。
file 定义文件名,此属性是必需的

这篇关于Jakarta Struts 编程:使用Tiles框架的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/594163

相关文章

中文分词jieba库的使用与实景应用(一)

知识星球:https://articles.zsxq.com/id_fxvgc803qmr2.html 目录 一.定义: 精确模式(默认模式): 全模式: 搜索引擎模式: paddle 模式(基于深度学习的分词模式): 二 自定义词典 三.文本解析   调整词出现的频率 四. 关键词提取 A. 基于TF-IDF算法的关键词提取 B. 基于TextRank算法的关键词提取

使用SecondaryNameNode恢复NameNode的数据

1)需求: NameNode进程挂了并且存储的数据也丢失了,如何恢复NameNode 此种方式恢复的数据可能存在小部分数据的丢失。 2)故障模拟 (1)kill -9 NameNode进程 [lytfly@hadoop102 current]$ kill -9 19886 (2)删除NameNode存储的数据(/opt/module/hadoop-3.1.4/data/tmp/dfs/na

Hadoop数据压缩使用介绍

一、压缩原则 (1)运算密集型的Job,少用压缩 (2)IO密集型的Job,多用压缩 二、压缩算法比较 三、压缩位置选择 四、压缩参数配置 1)为了支持多种压缩/解压缩算法,Hadoop引入了编码/解码器 2)要在Hadoop中启用压缩,可以配置如下参数

Makefile简明使用教程

文章目录 规则makefile文件的基本语法:加在命令前的特殊符号:.PHONY伪目标: Makefilev1 直观写法v2 加上中间过程v3 伪目标v4 变量 make 选项-f-n-C Make 是一种流行的构建工具,常用于将源代码转换成可执行文件或者其他形式的输出文件(如库文件、文档等)。Make 可以自动化地执行编译、链接等一系列操作。 规则 makefile文件

使用opencv优化图片(画面变清晰)

文章目录 需求影响照片清晰度的因素 实现降噪测试代码 锐化空间锐化Unsharp Masking频率域锐化对比测试 对比度增强常用算法对比测试 需求 对图像进行优化,使其看起来更清晰,同时保持尺寸不变,通常涉及到图像处理技术如锐化、降噪、对比度增强等 影响照片清晰度的因素 影响照片清晰度的因素有很多,主要可以从以下几个方面来分析 1. 拍摄设备 相机传感器:相机传

Linux 网络编程 --- 应用层

一、自定义协议和序列化反序列化 代码: 序列化反序列化实现网络版本计算器 二、HTTP协议 1、谈两个简单的预备知识 https://www.baidu.com/ --- 域名 --- 域名解析 --- IP地址 http的端口号为80端口,https的端口号为443 url为统一资源定位符。CSDNhttps://mp.csdn.net/mp_blog/creation/editor

【Python编程】Linux创建虚拟环境并配置与notebook相连接

1.创建 使用 venv 创建虚拟环境。例如,在当前目录下创建一个名为 myenv 的虚拟环境: python3 -m venv myenv 2.激活 激活虚拟环境使其成为当前终端会话的活动环境。运行: source myenv/bin/activate 3.与notebook连接 在虚拟环境中,使用 pip 安装 Jupyter 和 ipykernel: pip instal

pdfmake生成pdf的使用

实际项目中有时会有根据填写的表单数据或者其他格式的数据,将数据自动填充到pdf文件中根据固定模板生成pdf文件的需求 文章目录 利用pdfmake生成pdf文件1.下载安装pdfmake第三方包2.封装生成pdf文件的共用配置3.生成pdf文件的文件模板内容4.调用方法生成pdf 利用pdfmake生成pdf文件 1.下载安装pdfmake第三方包 npm i pdfma

零基础学习Redis(10) -- zset类型命令使用

zset是有序集合,内部除了存储元素外,还会存储一个score,存储在zset中的元素会按照score的大小升序排列,不同元素的score可以重复,score相同的元素会按照元素的字典序排列。 1. zset常用命令 1.1 zadd  zadd key [NX | XX] [GT | LT]   [CH] [INCR] score member [score member ...]

git使用的说明总结

Git使用说明 下载安装(下载地址) macOS: Git - Downloading macOS Windows: Git - Downloading Windows Linux/Unix: Git (git-scm.com) 创建新仓库 本地创建新仓库:创建新文件夹,进入文件夹目录,执行指令 git init ,用以创建新的git 克隆仓库 执行指令用以创建一个本地仓库的