頁(yè)面布局

??? 在這個(gè)單元中我們將看到如何使用模板標(biāo)簽系統(tǒng)構(gòu)造一個(gè)標(biāo)準(zhǔn)的模板頁(yè)面。這個(gè)例子我們使用了一個(gè)簡(jiǎn)單的HTML頁(yè)面布局，請(qǐng)看下圖：

??? 這個(gè)頁(yè)面有多個(gè)標(biāo)準(zhǔn)單元組成,就像頁(yè)面設(shè)計(jì)者和開發(fā)者熟悉的那樣.這個(gè)頁(yè)面的主體由3個(gè)包含的單元組成:頁(yè)眉,頁(yè)內(nèi)容主體和頁(yè)腳.我們現(xiàn)在就看看這些單元并且了解如何使用模板標(biāo)簽系統(tǒng)來(lái)實(shí)現(xiàn).

頁(yè)主體

??? 下面的代碼單元顯示的是主體:
The Page Body Layout?
1
<@ saleMonth = data.getValueBean('SALE_MONTH') @>
<@ saleTitle = data.getValueBean('SALE_TITLE') @>
<@ dealHeading = data.getValueBean('DEAL_HEADING') @>
<@ salesAreaID = "Central District" @>

??
??

??
??

?????
??

??
??

?????
??

??
??

?????
??

???????? ???????? 3??????? <@ include 'pageHeader.ssp' @> ?????

???????? 4??????? <@ include 'sale/pageContent.ssp' @> ?????

???????? 5??????? <@ include 'pageFooter.ssp' @> ?????

1:頁(yè)聲明
??? 第一個(gè)有趣的條目是頁(yè)頂部的頁(yè)聲明(1).我們?cè)陧?yè)面開始聲明了這些變量,因此這些變量將能在下面的頁(yè)面和像頁(yè)眉那樣的包含頁(yè)所使用.
2:頁(yè)標(biāo)題
??? 下一步我們使用表達(dá)式來(lái)初始化頁(yè)面標(biāo)題(2).這個(gè)值能夠從配置文件中view-resources元素利用ViewResourcesConfig->getAppTitle來(lái)得到:
appTitle = "Flash Jacks' Sleek Tab Site"
...

3:頁(yè)眉
??? 頁(yè)眉是下一個(gè)有趣的條目(3).在這里我們使用包含指令來(lái)插入頁(yè)眉模板文件到頁(yè)主體中.我們將在下一個(gè)子單元中來(lái)看一看頁(yè)眉.
??? 我們僅僅使用了頁(yè)面直接去讀取頁(yè)眉,不論頁(yè)的組件存儲(chǔ)在哪里.這是一個(gè)好機(jī)會(huì)來(lái)介紹模板標(biāo)簽系統(tǒng)的目錄設(shè)置.默認(rèn)情況下,模板目錄布局如下所示(注意這些路徑相對(duì)于我們的應(yīng)用程序):
The Default PhpMVC_Tags Template Directory Layout Paths (relative)?
The Template Files? './WEB-INF/tpl'?
The Compiled Template Files? './WEB-INF/tpl_C'?
??? 如果需要的話我們可以在配置文件的view-resources結(jié)點(diǎn)來(lái)重新定義他們,就像這樣:
...
tplDir = "./WEB-INF/tpl-admin"
tplDirC = "./WEB-INF/tpl_admin_C"
...

4:頁(yè)內(nèi)容主體
??? 這是另外一個(gè)包含指令被用來(lái)插入模板文件(4)到主體中.注意包含的文件位于模板目錄的sales子目錄中:
"./WEB-INF/tpl/sale/pageContent.ssp"
5:頁(yè)腳
??? 又是一個(gè)包含指令,就像頁(yè)眉一樣.

頁(yè)眉單元

??? 在這個(gè)例子中頁(yè)眉模板文件('pageHeader.ssp')只是一個(gè)簡(jiǎn)單的單元,就像這樣:


?? <@ =viewConfig.getAppTitle @>

??? 當(dāng)主體頁(yè)面(包括包含的頁(yè)面)被編譯的時(shí)候,頁(yè)眉的表達(dá)式被轉(zhuǎn)換成下面這樣:


?? getAppTitle(); ?>

??? 被編譯的頁(yè)面被存儲(chǔ)在編譯模板目錄中,就像上面所說(shuō)的,默認(rèn)的編譯模板目錄是:
'./WEB-INF/tpl_C'

頁(yè)內(nèi)容主體單元

??? 頁(yè)內(nèi)容主體模板文件有一點(diǎn)復(fù)雜.文件('sale/pageContent.ssp')內(nèi)容顯示如下:
...
1
<@ item1=data->getValueBean("ITEM_1") @>
<@ products=data->getValueBean("PRODUCTS_ARRAY") @>

2

<@=dealHeading @> <@=saleMonth @>

3
Clearance deals

??
?????
?????
??

???????? <@ =item1.getName @> ?????

???????? <@ =item1.getCost @> ?????

4
Todays specials

?
???
???
?

???????? <@ =item.getName @> ???

???????? <@ =item.getCost @> ???

Our Staff at Your Service
...
5

?
???
???
?
? ...

????? Area Manager: ???

????? <@ =viewConfig.getAreaManager @> ???

1:一些更多的聲明
??? 在頁(yè)面頂部所顯示的額外聲明(1)能讓我們聲明頁(yè)變量以便下面能夠使用.在內(nèi)容被處理之后,這些聲明將在編譯后像下面這樣顯示:
getValueBean("ITEM_1"); ?>
...
getValueBean("PRODUCTS_ARRAY"); ?>
2:使用表達(dá)式來(lái)顯示內(nèi)容單元標(biāo)題
??? 現(xiàn)在我們使用兩個(gè)表達(dá)式(2)來(lái)顯示內(nèi)容單元的標(biāo)題.注意我們聲明這些變量是"全局"變量在主頁(yè)面的頂部.處理完后,表達(dá)式將轉(zhuǎn)換這些代碼,就像這樣:

??? 當(dāng)頁(yè)面被顯示到用戶的瀏覽器中,內(nèi)容單元的標(biāo)題看起來(lái)就像這樣:
Jack's Super Deals for : May 2010.
3:使用表達(dá)式來(lái)顯示一些數(shù)據(jù)條目
??? 現(xiàn)在我們能顯示一些實(shí)際的數(shù)據(jù)(3).在這個(gè)頁(yè)內(nèi)容主體單元中我們?cè)L問一些在PhpMVCTabAction類的ActionObject中的產(chǎn)品條目數(shù)據(jù).一個(gè)簡(jiǎn)化版的PhpMVCTabAction類在下面展示:
class PhpMVCTabAction extends Action {
?? ...
?? function execute($mapping, $form, &$request, &$response) {
????? // Our value bean container
????? $valueBeans =& new ValueBeans();

????? // Define some strings we need on our View template page
????? // These could be defined globally in the phpmvc-config.xml file.
????? // See: ExtendedController example.
????? $appTitle????? = "Flash Jack's Include Page";
????? $saleMonth???? = "May 2010";
????? $saleTitle???? = "Flash Jack's Super Sale";
????? $dealHeading?? = "Jack's Super Deals for :";
????? ...

????? // Save the string variables to our Value object
????? $valueBeans->addValueBean('APP_TITLE'???? , $appTitle);
????? $valueBeans->addValueBean('SALE_MONTH'??? , $saleMonth);
????? $valueBeans->addValueBean('SALE_TITLE'??? , $saleTitle);
????? $valueBeans->addValueBean('DEAL_HEADING'? , $dealHeading);
????? ...

????? // Some float values we could receive from a database query
????? // Note: The prices are formatted in the Products class constructor.
????? // Eg: "$ n,nnn.nn"
????? $price1 =? 125.00;
????? ...

????? // Setup some clearance deals (individual object instances):
????? // Note: The Product class file was included in our local prepend.php file
????? $item1 = new Product('Super Duper', $price1);
????? ...
????? $valueBeans->addValueBean('ITEM_1', $item1);
????? ...

????? // Todays specials (array of object instances)
????? $products = array();
????? $products[] = new Product('Gooses Bridle', $price3);
????? ...
????? $valueBeans->addValueBean('PRODUCTS_ARRAY', $products);

????? // Our staff
????? $staff1 =& new Staff('Bruce', 'Sales', 'Karate');
????? ...
????? $valueBeans->addValueBean('STAFF_1', $staff1);
????? ...

????? // Save the Value object
????? $this->saveValueObject($request, $valueBeans);
??? 在上面的代碼中,我們能看到$item1被創(chuàng)建并被保存成ActionObject的valueBeans條目.Bean數(shù)據(jù)條目現(xiàn)在能在模板頁(yè)面中被重新獲得:
<@ item1=data->getValueBean("ITEM_1") @>
??? 我們可以像下面那樣顯示條目的值:
<@ =item1.getName @>
...
<@ =item1.getCost @>
4:顯示數(shù)組
??? 我們也可以直接使用一些PHP代碼在我們的模板頁(yè)上.在這個(gè)分離的MVC模式中,我們應(yīng)該僅在這里編寫代碼去操縱這些通過ActionObject和ViewResourcesConfig實(shí)例(可能我們的自定義Bean也可以)提供的數(shù)據(jù).在上面的也內(nèi)容單元('sale/pageContent.ssp')中,我們使用一個(gè)PHP的foreach語(yǔ)法(4)來(lái)循環(huán)讀取$products數(shù)組.我們能在上面的PhpMVCTabAction類中看到$products數(shù)組被創(chuàng)建并被保存在ActionObject中,就和上面的$item1 Bean相似.在foreach循環(huán)中我們能使用表達(dá)式來(lái)顯示產(chǎn)品數(shù)據(jù):

??
?????
???????? <@ =item.getName @>
?????
?????
???????? <@ =item.getCost @>
??????
??

5:顯示ViewResourcesConfig屬性
??? 最后我們從view-resources元素所定義的ViewResourcesConfig屬性來(lái)顯示"Area Manager"(5)在我們的內(nèi)容頁(yè):
appTitle = "Flash Jacks' Sleek Tab Site"
...
className = "MyViewResourcesConfig">

??????
??????
? -resources>
??? 但是注意在這個(gè)範(fàn)例中我們使用了一個(gè)繼承ViewResourcesConfig類別的物件(MyViewResourcesConfig)來(lái)設(shè)定一些自訂的屬性.我們定義了一個(gè)擴(kuò)充ViewResourcesConfig類別的物件,在設(shè)定檔裡使用className=" MyViewResourcesConfig"屬性,並且MyViewResourcesConfig類別定義在檔案"MyViewResourcesConfig.php"中.MyViewResourcesConfig類別(classes/MyViewResourcesConfig.php)實(shí)作了setter/getter方法去處理自訂屬性("areaManager"),這個(gè)屬性我們?cè)趘iew-resources結(jié)點(diǎn)中定義:
class MyViewResourcesConfig extends ViewResourcesConfig {

?? // ----- Properties --------------------------------------- -------------- //

?? var $areaManager = '';

?? function getAreaManager() {
????? return $this->areaManager;
?? }

?? function setAreaManager($areaManager) {
????? $this->areaManager = $areaManager;
?? }
??
??? 注意:在真實(shí)的應(yīng)用程式中資料能從關(guān)係型資料庫(kù)中取得.

頁(yè)腳單元

??? 頁(yè)腳單元和上面討論過的頁(yè)眉單元的處理相類似.頁(yè)腳模板檔案('tpl/pageFooter.ssp')就像這樣:

?

??? 當(dāng)主體頁(yè)(包括包含的頁(yè)面)被編譯,在頁(yè)腳中的表達(dá)式被轉(zhuǎn)換成下面這樣:


?? getCopyright(); ?>

??? 編譯的頁(yè)眉頁(yè)儲(chǔ)存在編譯模板目錄.預(yù)設(shè)的編譯模板目錄是:
'./WEB-INF/tpl_C'