Page
Page標(biāo)簽的作用是從頁面的上下文中獲取屬性,將其包裝為Bean,并通過一個(gè)腳本變量來訪問該Bean。
當(dāng)該標(biāo)簽中出現(xiàn)問題時(shí)(比如指定的Page上下文屬性沒有找到),將會(huì)拋出一個(gè)請求期的異常
該標(biāo)簽不可含有標(biāo)簽體內(nèi)容。
該標(biāo)簽有兩屬性。
屬性 |
描述 |
id |
設(shè)定存儲屬性的bean的名字
(必須) |
property |
獲取的頁面上下文的屬性的名字,必須是下列屬性中的一個(gè):application,
config, request, response, or session.
(必須) |
Parameter
Parameter用于從請求中提取參數(shù)值。得到的參數(shù)值將會(huì)被用于定義一個(gè)Page范圍內(nèi)屬性,該屬性的類型是java.lang.String或者java.lang.String[](當(dāng)multiple屬性不為null時(shí))。
當(dāng)該標(biāo)簽中出現(xiàn)問題時(shí)(比如指定的參數(shù)沒有找到,并且value屬性沒有被設(shè)置),將會(huì)拋出一個(gè)請求期的異常。
該標(biāo)簽不可含有標(biāo)簽體內(nèi)容。
該標(biāo)簽有四個(gè)屬性。
屬性 |
描述 |
id |
設(shè)定用于暴露頁面屬性的腳本變量的名字。
(必須) |
name |
設(shè)置所要獲取值的屬性的名字
(必須) |
multiple |
當(dāng)該屬性被設(shè)置任何值時(shí),生成包含所有以匹配的請求參數(shù)的String[]對象。如果該屬性被設(shè)置為null,但只有一個(gè)參數(shù)匹配,在String[]對象的第一個(gè)([0]元素)元素將包含獲得的值。
(可選) |
value |
缺省的值,當(dāng)指定的name屬性沒有匹配的參數(shù)時(shí),將會(huì)返回該值
(可選) |
Resource
Resuorce標(biāo)簽用來獲取Web應(yīng)用的資源的值,該資源通過name屬性來識別。該標(biāo)簽使得資源可以作為java.io.InputStream或java.lang.String對象,這可以通過input屬性設(shè)置。
當(dāng)該標(biāo)簽中出現(xiàn)問題時(shí)(比如指定的資源沒有找到),將會(huì)拋出一個(gè)請求期的異常。
該標(biāo)簽不可含有標(biāo)簽體內(nèi)容。
該標(biāo)簽有三個(gè)屬性。
屬性 |
說明 |
Id |
設(shè)定頁面作用域內(nèi)的腳本變量的名字,該腳本變量保存從Wet應(yīng)用資源中獲取的值
(必須) |
name |
標(biāo)示要取得相應(yīng)值的應(yīng)用相關(guān)的Web資源,該屬性必須由/字符開始
(必須) |
input |
如果該屬性被設(shè)置為任何值,得到的資源將會(huì)被作為java.io.InputStream對象,當(dāng)設(shè)置為null時(shí)候,資源將會(huì)作為java.lang.String對象。該屬性缺省值為null。
(可選) |
Size
Size標(biāo)簽用于獲取集合類型的對象的元素的個(gè)數(shù),這里所說的集合類型包括數(shù)組(array),java.util.collection和java.util.map等類型。該標(biāo)簽將集合類型對象的元素個(gè)數(shù)封裝到一個(gè)java.lang.Integer腳本變量中。該標(biāo)簽中的集合類型對象可以通過設(shè)定用一個(gè)運(yùn)行期的表達(dá)式來設(shè)定collection屬性,或通過name屬性設(shè)置的一個(gè)JSP Bean,再或者是name屬性設(shè)置的Bean中的由property屬性指定的屬性。
當(dāng)該標(biāo)簽中出現(xiàn)問題時(shí)(比如指定的集合類型的數(shù)據(jù)實(shí)際上并不是array、collection或者map,或者指定的Bean沒有找到等),將會(huì)拋出一個(gè)請求期的異常
該標(biāo)簽不可含有標(biāo)簽體內(nèi)容。
該標(biāo)簽有五個(gè)屬性。
屬性 |
描述 |
id |
用來保存集合元素個(gè)數(shù)的JSP Bean的腳本變量名,該Bean的類型為java.lang.Integer
(必須) |
collection |
表示運(yùn)行期的表達(dá)式,該表達(dá)式的值最終應(yīng)當(dāng)是array、collection或者map。
(可選) |
name |
標(biāo)示包含需要計(jì)數(shù)的集合類型數(shù)據(jù)的JSP Bean的名字。如果property屬性被設(shè)置,集合數(shù)據(jù)將從Bean中的屬性中獲得,如果property沒有被設(shè)置,則通過name屬性設(shè)置的Bean將作為集合對象計(jì)數(shù)。
(可選) |
property |
設(shè)定通過name屬性設(shè)定的Bean中用于計(jì)數(shù)的集合類型的成員名字。
(可選) |
scope |
Bean的作用域,通過name屬性設(shè)定的Bean將會(huì)在該作用域內(nèi)查找。當(dāng)該屬性沒有設(shè)置時(shí),將按如下順序查找:page, request, session, 和application.
(可選) |
Struts
Struts標(biāo)簽用來復(fù)制一個(gè)指定的Struts內(nèi)部組件到一個(gè)頁面作用域內(nèi)的腳本組件。能夠獲取的Struts組件包括FromBean、Forward或者一個(gè)mapping對象。
當(dāng)該標(biāo)簽中出現(xiàn)問題時(shí)(比如指定的Struts組件沒有找到),將會(huì)拋出一個(gè)請求期的異常。
該標(biāo)簽不可含有標(biāo)簽體內(nèi)容。
該標(biāo)簽有四個(gè)屬性。
屬性 |
描述 |
id |
設(shè)定用來保存相應(yīng)的獲取的Struts組件的腳本變量名。
(必須) |
formBean |
指定要復(fù)制的Struts ActionForm對象的名字。
(可選) |
forward |
指定要復(fù)制的全局的ActionForward的名字。
(可選) |
mapping |
指定要復(fù)制的ActionMapping對象的路徑。
(RT EXPR) |
注意:forward屬性和mapping屬性是互斥的,只能在一個(gè)Strutst標(biāo)簽中設(shè)定他們其中一個(gè)。
Write
Write標(biāo)簽用來獲取并輸出bean的屬性值。如果format屬性被設(shè)置了,那么輸出的值將會(huì)按照format屬性進(jìn)行格式輸出。
當(dāng)該標(biāo)簽中出現(xiàn)問題時(shí)(比如指定的Bean沒有找到),將會(huì)拋出一個(gè)請求期的異常
該標(biāo)簽不可含有標(biāo)簽體內(nèi)容。
該標(biāo)簽有九個(gè)屬性。
20
屬性 |
描述 |
bundle |
設(shè)定存儲包含消息字符串的MessageResources對象的Bean的名字,該Bean的作用域?yàn)锳pplication,該Bean對應(yīng)于struts-config.xml文件中的一個(gè)<message-resource> 元素。該屬性的缺省值是Action.MESSAGES_KEY。
(可選) |
filter |
如果該屬性被設(shè)定為true,輸出的字符串中的HTML敏感字符(比如<、>等將會(huì)被過濾,而用等同的其他字符來替代。設(shè)置為false則不會(huì)對HTML敏感字符進(jìn)行過濾。缺省值為true。
(可選) |
format |
設(shè)定用于格式化獲取的屬性值的字符樣式。
(可選) |
formatKey |
設(shè)定查找存儲于應(yīng)用資源中的格式化字符串的關(guān)鍵字。
(可選) |
ignore |
如果該屬性被設(shè)置為true,當(dāng)指定的bean不存在時(shí),僅僅返回而不輸出任何東西。如果被設(shè)置為false,當(dāng)出現(xiàn)上面的情況時(shí),則將會(huì)拋出一個(gè)運(yùn)行期的異常,這和標(biāo)簽庫中的其他標(biāo)簽是一致的。
缺省值為false
(可選) |
locale |
Session作用域下包含當(dāng)前的Locale對象的Bean的名字,然后該屬性用于生成于用戶區(qū)域設(shè)置有關(guān)的消息。
(可選) |
Name |
設(shè)定要獲取屬性并輸出的Bean的名字,如果property屬性沒有設(shè)定,則該Bean本身將被用于輸出。
(可選) |
property |
設(shè)定通過name屬性指定的Bean中需要輸出的屬性的名字。
(可選) |
Scope |
指定查詢的用于獲取并輸出屬性的Bean的作用域,如果沒有設(shè)定,將會(huì)按照如下順序查找page, request, session, 和application。
(可選) |