Portal Page的呈現

先看一下在JSR168中提到的Portal page，可以了解一個Portal Page上大概有哪些element：

OK...進入本次主題

PSML:
PSML的全名是Portal Structure Markup Language。J2用PSML來定義Portal內的各種resource，包括Page、Folder、Link、Security、Menus等等，有關J2的PSML詳細介紹在此http://portals.apache.org/jetspeed-2/guides/guide-psml.html。

這裡要特別提一下PSML Page。在J2中，一個PSML Page就代表一個Portal page，其根元素為<page>，裡面指定了這個Portal page所包含的portlet及排列方式(ex: 2行或3行)、這個Portal page所使用的樣板(稍後會提到的layout)還有這個Portal page的外觀(稍後會提到的decoration)等等。

另外一個要特別說明的是在PSML Page中所使用的<fragment>這個tag。fragment有portlet和layout二種，用type這個屬性來區別；<fragment type="portlet">代表一個portlet，<fragment type="layout">代表這個page所用的layout；然而不管是哪一種fragment，name屬性的值都應該依照"portlet-app-id::portlet-id"的格式。

以之前範例中的Sample.psml為例，根元素是<page>，所以這是一個PSML Page；第一個<fragment>是layout fragment，指定了這個page所使用的layout，name屬性的值為"jetspeed-layouts::VelocityTwoColumns"。第二個<fragment>就是範例的echo portlet，name屬性的值為"sample::EchoPortlet"，就符合之前所描述的格式。

事實上，layout fragment其實也是portlet。看一下C: omcatwebappsjetspeedWEB-INFapps裡有一個jetspeed-layouts目錄，就是J2內部的一個Portlet application。因此"jetspeed-layouts::VelocityTwoColumns"會對到這個目錄下portlet-id為VelocityTwoColumns的portlet。總之，J2的layout也是portlet，如果再研究一下，其實還是個Velocity Bridge的portlet.

layout:
J2中的layout指的是用來排列Portal page中各個portlet的樣板。預設的情況下，J2用Velocity來實現layout。

decoration:
J2中的decoration是用來裝飾Portal page和portlet使其美觀，分為layout-decoration和portlet-decoration兩種。layout-decoration負責一整個Portal page(因此叫page-decoration)，而portlet-decoration負責每一個Portlet fragment。預設的情況下，J2用Velocity和CSS來實現decoration。當J2在呈現一Portal page時，會依照這個Portal page指定的layout來排列這個page上的各個portlet，並且使用這個page所指定的layout-decoration和portlet-decoration來美化這個page和所有的portlet。有關decoration的細節可參考http://portals.apache.org/jetspeed-2/guides/guide-decorators.html

Aggregator:
在J2中，一個Portal page的request最後通常會傳給一個Aggregator，然後由Aggregator負責跟Portal page內包含的所有portlet溝通並聚合各個portlet fragment以產生整個Portal page。以之前舉例的jetspeed-pipeline來說(C: omcatwebappsjetspeedWEB-INFassemblypipelines.xml)，可以看到aggregatorValve這個bean被注入了org.apache.jetspeed.aggregator.PageAggregator這個Aggregator；再參考C: omcatwebappsjetspeedWEB-INFassemblyaggregation.xml中，可已知道這個bean的實作是org.apache.jetspeed.aggregator.impl.PageAggregatorImpl。

來看一下這個PageAggregatorImpl的中用來產生Portal page的方法(部份省略修改):

 public void build( RequestContext context ){
    //取得requested page
    ContentPage page=context.getPage();
   
    //取得 root fragment
    ContentFragment root = page.getRootContentFragment();
    
    //aggregate及render各個Portlet，基本上render的結果都寫到context裡
    aggregateAndRender(root, context, page);
 
    //將結果寫入response
    context.getResponse().getWriter().write(root.getRenderedContent());
    
}

首先要注意一下傳入的是一個J2的RequestContext物件，基本上可以視為是用來存放這次request相關資訊的一個context；此外，可以把ContentFragement物件視為portlet。而其中第6行取得root fragment，實際上就是取得前面所說的layout fragment，也就是"jetspeed-layouts::VelocityTwoColumns"這個portlet。

接著再看一下第9行的aggregateAndRender()方法(部份省略修改)：

protected void aggregateAndRender( ContentFragment f, RequestContext context, ContentPage page ){
 
    Iterator children = f.getContentFragments().iterator();
    while (children.hasNext()){
        ContentFragment child = (ContentFragment) children.next();
        
        //遞迴
        aggregateAndRender(child, context, page);
    }
       
     // 開始真正做render的動作，基本上render的結果都寫到context裡
     renderer.render(f, context);  //renderer是org.apache.jetspeed.aggregator.impl.PortletRendererImpl
     
     //加上decoration
     addStyle(context, f.getDecorator(),ContentFragment.PORTLET);
       
}

由上面的code，可以了解到J2先把整個page上所有的portlet由外到內串起來，再由內到外一個一個做render的動作，而每render完一個portlet，就加上對應的decoration，直到做完整個page。

在第12行中，render的動作實際上是renderer透過Pluto來呼叫portlet(實際上是ContentFragment物件被包成portlet window)的render方法。PortletRendererImpl.render()這個方法裡使用了常見的Worker Thread和Observer樣式，以達到render多個portlet的功能，有興趣的不妨研究一下。

那如果想要新加外觀呢??最簡單的方式，就是先參考J2的layout portlet寫自已的layout，然後加入decoration。講起來容易，不過layout可是不太容易寫的，因為牽扯到的技術還蠻多，而且對J2也要有一定了解；但是如果能做出來，安裝就不會太麻煩。也許等以後J2紅起來以後，會有各式各樣的外觀可以玩吧... Cool

其他參考資料：
Portal Design Doc : http://portals.apache.org/jetspeed-2/guides/guide-portal-design.html
簡介J2中有關Portal Page的一些概念

Jetspeed Power Tool (JPT) : http://portals.apache.org/jetspeed-2/guides/guide-jpt.html
開發layout和decoration時會用到