Bean Tags
Struts-bean 标签库中的JSP自定义标签的主要作用是用于访问Bean和Bean的属性,以及基于这些访问而定义新的Bean,使得页面可以通过脚本变量和页面内的属性来访问这些Bean。
Cookie
Cookie标签的作用是获取指定的Cookie的属性值并将其定义一个脚本变量。
当该标签中出现问题时(比如设定的cookie变量没有找到,并且value属性没有被设置),将会抛出一个请求期的异常。
该标签不可有标签体内容。
该标签有四个属性。
属性 | 描述 |
Id | 指定脚本变量的名字(同样也是页面范围内的属性名),该变量或属性表示了该请求的Cookie的值 (必须) |
multiple | 如果该属性的值都被设定为任何值时,那么任何匹配的cookie都将被集成到一个类型为javax.servlet.http.Cookie []的Bean中。如果该属性没有设定,那么第一个匹配的cookie将会被获取,存储到类型为javax.servlet.http.Cookie的Bean中。 (可选) |
name | 指定用于获取属性值的cookie的名字 (必须) |
value | 缺省的属性值,如果没有匹配的cookie时,该属性将会被存储到一个类型为javax.servlet.http.Cookie的Bean中。 (可选) |
Define
Define标签的作用是获取一个由指定的Bean的属性并把它定义为一个Bean,并通过脚本变量将其展现该Bean,该Bean将被存储于指定的作用域范围内。
当该标签中出现问题时(比如指定的Bean没有找到,并且value属性没有被设置),将会抛出一个请求期的异常。
该标签可以含有JSP标签体内容。
该标签有七个属性,
属性 | 描述 |
Id | 指定展现该Bean脚本变量的名字,该变量在指定的作用域内有效,可以用于获取相应的属性值。 (必须) |
name | 指定获取属性值的Bean的名字。该属性是必须设置的,除非你设置了value属性 (可选) |
property | 指定获取的Bean中的属性名,Bean的名字由name设定。如果该属性没有设置,那么脚本变量的值通过id属性从通过name属性得到的Bean相应的属性中获得。 (可选) |
scope | 指定查询的用于获取属性的Bean的作用域,如果没有设定,将会按照如下顺序查找page, request, session, 和application。 (可选) |
toScope | 指定脚本变量作用域,缺省值是page. (可选) |
type | 设定以id属性名而展现出的的类型的完整的类名。缺省情况:如果设定了value属性,为java.lang.String,其他情况下是java.lang.Object。 (可选) |
value | java.lang.String类型的值,设定了定义的Bean的值。该属性在没有设定name属性时,是必须设定的。 (可选) |
Head
Head标签的作用是Cookie标签相似,不同之出仅仅在于Head标签用于从head中获取数据,而不是从cookie中获取。
当该标签中出现问题时(比如指定的head属性没有找到,并且value属性没有被设置),将会抛出一个请求期的异常。
该标签不可含有标签体内容。
该标签有四个属性。
属性 | 描述 |
Id | 指定脚本变量的名字(同样也是页面范围内的属性名),该变量或属性表示了该请求的head的值 (必须) |
multiple | 如果该属性的值都被设定为任何值时候,那么将会调用HttpServletRequest.getHeaders ()方法,并将返回值包装为String[]类型的Bean。如果没有设定或设定为null时候,将调用HttpServletRequest.getHeaders ()方法,返回值将被包装为类型为String的Bean (可选) |
Name | 指定HTTP head属性的名字 (必须) |
Value | 缺省的属性值,如果没有匹配的head时,该属性将会被使用。 (可选) |
Include
Include标签的作用是引入Web应用资源并获取结果,该标签使得响应的数据作为String类型的对象。该标签的作用和<jsp:include>相当类似,除了在该Tag中响应数据是被存储与一个页面范围内的对象属性中。
该标签支持三种类型的资源组件:forward、href和page。
当该标签中出现问题时(比如设定的资源组件不存在),将会抛出一个请求期的异常。
该标签不可含有标签体内容。
该标签有七个属性。
属性 | 描述 |
Id | 指定作用域为page的脚本变量,该变量用于访问Web应用的资源的值。 (必须) |
anchor | 设定HTML anchor标签,该标签将会被加入到最后生成的URL中。设定时候不需要在设定字符串中包含anchor中的#字符。 (可选) |
forward | 用于查找全局的ActionForward,通过对配置的查找,最终得到需引入的资源的上下文相关的实际的URL。 (可选) |
href | 绝对的需引入的资源的URL地址。 (可选) |
Name | 设定引入资源的应用相关的URL位置。 新的Struts1.1后版本中该属性不被支持,使用page属性代替。 (可选) |
page | 设定引入资源的应用相关的URL位置。 (可选) |
transaction | 如果设定为true,在可能的情况下,将会导致事务标签包含于最终的URL中。缺省值为false (可选) |
Message
Message标签用于从预定义的资源中获取相应关键字的对应字符串属性。它同样具有能力处理对以占位符表示的参数的能力。该标签用于支持应用的国际化。
当该标签中出现问题时(比如应用没有绑定资源文件,或者指定的关键字在资源文件中查找失败),将会抛出一个请求期的异常
该标签不可含有标签体内容。
该标签有十一个属性
属性 | Description |
arg0 | 对字符串中存在第一个参数时,设定参数值 (可选) |
arg1 | 对字符串中存在第二个参数时,设定参数值 (可选) |
arg2 | 对字符串中存在第三个参数时,设定参数值 (可选) |
arg3 | 对字符串中存在第四个参数时,设定参数值 (可选) |
arg4 | 对字符串中存在第五个参数时,设定参数值 (可选) |
bundle | 设定存储包含消息字符串的MessageResources对象的Bean的名字,该Bean的作用域为Application,该Bean对应于struts-config.xml文件中的一个<message-resource> 元素。该属性的缺省值是Action.MESSAGES_KEY。 (可选) |
key | 消息的关键字,Struts利用该关键字在预定义的资源中查找相应的消息,该关键字必须在资源中出现,否则将会抛出异常。 如果该属性没有设定,关键字将通过name和property属性生成。 (可选) |
locale | Session作用域下包含当前的Locale对象的Bean的名字,然后该属性用于生成于用户区域设置有关的消息。 缺省值为Action.LOCALE_KEY (可选) |
name | 设定用于获取关键字的Bean的名字。如果property属性没有被设置,那么该Bean本身的值将会被用做关键字。 (可选) |
property | 设定用于获取关键字的Bean的属性的名字。 (可选) |
scope | 设定用于查找获取关键字的Bean的作用域。 如果没有设定,将会按如下的顺序查找Bean:page、request、session、application (可选) |
Page