IBM portlet API 開發

本主題簡單概述了 IBM portlet API。不推薦使用該 API，並且本主題僅為尚未遷移到標準 portlet API 的 portlet 提供支援內容。

抽象 Portlet 類是 IBM portlet API 的核心抽象。Portlet 類擴充 Servlet API 的 HTTPServlet。所有 portlet 間接地擴充此抽象類別，且從 HttpServlet 繼承，如下所示：

... +--javax.servlet.http.HttpServlet | +--org.apache.jetspeed.portlet.Portlet | +--org.apache.jetspeed.portlet.PortletAdapter | +--com.myCompany.myApplication.myPortlet

因此，portlet 是特殊類型的 servlet。這種類型的 servlet 的屬性使它們能容易地插入並在門戶網站伺服器中運行。與 servlet 不同，portlet 不能直接發送重新導向或錯誤到瀏覽器，轉寄請求，或者寫任意的標記到輸出資料流。portlet 容器依賴於 WebSphere Application Server 實現的 J2EE 體繫結構。結果是，portlet 按類似於 J2EE Web 應用程式的方式封裝，並按類似於 servlet 的方式部署。

總之，與 servlet 相比，可更加動態地管理 portlet。可在不啟動和重新啟動門戶網站伺服器的情況下，應用以下更新： 可使用門戶網站系統管理使用者介面安裝和除去由幾個 portlet 組成的 portlet 應用程式。 portlet 的設定可由有適當訪問權的管理員更改 可使用管理 portlet 動態建立和刪除 portlet。例如，一旦管理員建立新的剪下，剪下 portlet 就可用於建立新的 portlet 執行個體。

portlet 容器依賴於 WebSphere Application Server 實現的 J2EE 體繫結構。結果是，portlet 按類似於 J2EE Web 應用程式的方式封裝在 WAR 檔案中，並按類似於 servlet 的方式部署。與其他 servlet 相似，要使用 servlet 部署描述符（web.xml）把 portlet 定義到應用程式伺服器。這個檔案定義 portlet 的類檔案和唯讀初始化參數。

下圖顯示部署了其 WAR 檔案之後的 portlet。對於門戶網站伺服器上部署的每個 portlet，它在應用程式伺服器上建立一個 servlet 或者 portlet 類執行個體。

初始化參數是由 portlet 開發人員設定的，並可由 portlet 使用 PortletConfig 對象讀取。servlet 部署描述符可以包含多個 Web 應用程式，每個 Web 應用程式由 <servlet> 元素定義。此外，每個 servlet 定義可以指向同一 portlet 類檔案，這樣可為每個 portlet 類執行個體使用不同的初始化參數，建立不同的 PortletConfig 對象。有關更多資訊，請參閱 Web 應用程式部署描述符。