`
j2ee_zhongqi
  • 浏览: 208831 次
  • 性别: Icon_minigender_1
  • 来自: 深圳
社区版块
存档分类
最新评论

Portlet Tag Library

阅读更多
转自:http://apps.hi.baidu.com/share/detail/1823867

PLT.22 Portlet Tag Library
portlet tag library 可以放在 JSPs 的檔案之中去直接存取 portlet 特殊的元素,

例如 RenderRequest 及 RenderResponse.

他也提供了 JSPs 去存取 portlet 的一些功能如 portlet 的 URLs.

Portlet container 必須提供 portlet tag library 的實作. Portlet 的開發人員可以使用定義在 JSP Specification 1.2 中 JSP.7.3.9 Well-Know URIs 的機制來實作.

而 JSP 該如何使用 tab library 呢 ? 如同下面的程式碼

<%@ taglib uri="http://java.sun.com/portlet" prefix="portlet" %>


PLT.22.1 defineObjects Tag
defineObjects tag 必須定義以下的變數讓 JSPs 可以使用

RenderRequest renderRequest
RenderResponse renderResponse
PortletConfig portletConfig
這些變數必須參照 Portlet API 的物件並且放在 request scope 的物件中 ( 定義在 PLT.16.3.1 Included Request Attributes 章節 )

一個 JSP 程式中可以透過 scriptlet 利用到 defineObjects tag 在所有的地方.

defineObjects tag 不可以定義任何屬性, 也不可以包含任何 body content.

簡單的 JSP 範例如下
<portlet:defineObjects/>
<%=renderResponse.setTitle("my portlet title")%>

這就是透過 defineObjects tag, JSP 可以呼叫 renderResponse 的 setTitle() 去設定 portlet 的標題.

PLT.22.2 actionURL Tag
portlet 中 actionURL 是為了建立一個 URL 可以連結到目前的 portlet 並且可以透過帶有參數的 request 動作去驅動.

而 URL 的傳遞參數必須使用 param tag 放在 actionURL 的起始以及結束的 tag 之間.

windowState ( 型態: String, 非必要的)
當這個 link 被執行的時候, 這個 portlet windowState 應該要執行的動作. 預先設定的 windowState 有 minimized, normal, 以及 maximized . 假如這些標準的視窗狀態在這個 request 是非法的, 應該就要丟出 JspException. 非法的理由有可能是 portal 不支援這些狀態, portlet 無法宣告他們在 Deployment Descriptor 之中讓 portal 支援這些狀態, 或是現在這個使用者不被允許使用到這些狀態. 假如視窗狀態不能讓 URL 設定, portlet 將待在和現在這個 request 相同的狀態. WindowState 的屬性應該是不分大小寫的.

portletMode (型態: String, 非必要的)
假如當這個 link 被執行的時候沒有錯誤發生, 這個 portlet 應該要具備的 mode. 預先設定的 portlet mode 有 edit, help, 以及 view . 假如這些標準的 portlet mode 在這個 request 是非法的, 應該就要丟出 JspException. 非法的理由有可能是 portal 不支援這些 mode, portlet 無法宣告他們在 Deployment Descriptor 之中讓 portal 支援這些 mode, 或是現在這個使用者不被允許切換到這些 mode . 假如 portlet mode 不能讓 URL 設定, portlet 將待在和現在這個 request 相同的 mode . PortletMode 的屬性應該是不分大小寫的.

var (型態: String, 非必要的)
為了 action URL 輸出到某個 scope 變數的名稱. 這輸出到 scope 的變數名稱應該是 String. 預設 URL 執行是把結果寫到現在這個 JspWriter. 假如結果輸出成為 JSP 的 scope 變數, 透過 var 的屬性定義, 將不會有任何東西寫到現在這個 JspWriter.

注意: 在 URL 被建立之後, 將不可能利用變數和 String 串聯去 extend 那 URL 或增加任何更多的參數值. 假如被給定的參數名稱已經存在在這個 page 的 scope 或他已經被使用在一個重複的迴圈中, 新的屬性值將覆蓋舊有的.

secure (型態: String, 非必要的)
假如結果的 URL 必須是 secure 的連結 ( secure="true" ) 或一個 insecure one ( secure="false"). 假如 run-time 環境不支援標準的安全性設定, 將會丟出 JspException. 假如這 URL 沒有設定任何 security, 他必須待在和現在 request 相同的 security 設定.

JspException 具有 PortletException 將產生一些錯誤視為 root 產生會丟出以下的狀況.

If an illegal window state is specified in the windowState attribute.
If an illegal portlet mode is specified in the portletMode attribute.
If an illegal security setting is specified in the secure attribute.
以下是一個使用 actionURL tag 的例子

<portlet:actionURL windowState="maximized" portletMode="edit">
<portlet:param name="action" value="editStocks"/>
</portlet:actionURL>

這個範例是建立一個 URL 將讓 portlet 進入 EDIT 的狀態並且 window state 最大化 ( MAXIMIZED )的去編輯股票報價列表.

PLT.22.3 renderURL Tag
portlet 中 renderURL 是為了建立一個 URL 可以連結到目前的 portlet 並且可以透過帶有參數的 request 動作去驅動.

而 URL 的傳遞參數必須使用 param tag 放在 renderURL 的起始以及結束的 tag 之間.

windowState ( 型態: String, 非必要的)
當這個 link 被執行的時候, 這個 portlet windowState 應該要執行的動作. 預先設定的 windowState 有 minimized, normal, 以及 maximized . 假如這些標準的視窗狀態在這個 request 是非法的, 應該就要丟出 JspException. 非法的理由有可能是 portal 不支援這些狀態, portlet 無法宣告他們在 Deployment Descriptor 之中讓 portal 支援這些狀態, 或是現在這個使用者不被允許使用到這些狀態. 假如視窗狀態不能讓 URL 設定, portlet 將待在和現在這個 request 相同的狀態. WindowState 的屬性應該是不分大小寫的.

portletMode (型態: String, 非必要的)
假如當這個 link 被執行的時候沒有錯誤發生, 這個 portlet 應該要具備的 mode. 預先設定的 portlet mode 有 edit, help, 以及 view . 假如這些標準的 portlet mode 在這個 request 是非法的, 應該就要丟出 JspException. 非法的理由有可能是 portal 不支援這些 mode, portlet 無法宣告他們在 Deployment Descriptor 之中讓 portal 支援這些 mode, 或是現在這個使用者不被允許切換到這些 mode . 假如 portlet mode 不能讓 URL 設定, portlet 將待在和現在這個 request 相同的 mode . PortletMode 的屬性應該是不分大小寫的.

var (型態: String, 非必要的)
為了 render URL 輸出到某個 scope 變數的名稱. 這輸出到 scope 的變數名稱應該是 String. 預設 URL 執行是把結果寫到現在這個 JspWriter. 假如結果輸出成為 JSP 的 scope 變數, 透過 var 的屬性定義, 將不會有任何東西寫到現在這個 JspWriter.

注意: 在 URL 被建立之後, 將不可能利用變數和 String 串聯去 extend 那 URL 或增加任何更多的參數值. 假如被給定的參數名稱已經存在在這個 page 的 scope 或他已經被使用在一個重複的迴圈中, 新的屬性值將覆蓋舊有的.

secure (型態: String, 非必要的)
假如結果的 URL 必須是 secure 的連結 ( secure="true" ) 或一個 insecure one ( secure="false"). 假如 run-time 環境不支援標準的安全性設定, 將會丟出 JspException. 假如這 URL 沒有設定任何 security, 他必須待在和現在 request 相同的 security 設定.

JspException 具有 PortletException 將產生一些錯誤視為 root 產生會丟出以下的狀況.

If an illegal window state is specified in the windowState attribute.
If an illegal portlet mode is specified in the portletMode attribute.
If an illegal security setting is specified in the secure attribute.
以下是一個使用 renderURL tag 的例子

<portlet:renderURL portletMode="view" windowState="normal">
<portlet:param name="showQuote" value="myCompany"/>
<portlet:param name="showQuote" value="someOtherCompany"/>
</portlet:renderURL>

這個範例將產生一個 URL 去提供一個 link 可以去顯示公司其他公司的股票報價及改變 portlet mode 成為 VIEW 並且將 window state 改成 NORMAL.

PLT.22.4 namespace Tag
這個 tag 產生一個目前 portlet 中唯一的數值.

這個 tag 應該被 named elements 使用在 portlet 的輸出, 例如 javascript 的功能或變數. 而 namespacing 就是確認給定的名稱是這個 portlet 唯一的值, 是避免名稱重複影響了其他 portal 的 element 以及這一頁的其他 portlets.

namespace tag 不允許任何 Body Content.

以下是一個使用 namespace tag 的例子

<A HREF="javascript:<portlet:namespace/>doFoo()">Foo</A>

這個範例預先設定 javascript function 加上 namescape + 'doFoo', 以確認這個功能在portal page 中是唯一的.

PTL.22.5 param Tag
這個 tag 是定義一個參數值, 可能是放在 actionURL 或 renderURL 之中. param Tag 不准包含任何 Body Content.

下面是 param Tag 一些必要的屬性

name (型態: String, 必要的)
增加在 URL 之中參數的屬性名稱. 假如 name 是空值 (NULL) 或 空白字串 ( empty ), 將不會執行任何動作.

value (型態: String, 必要的)
增加在 URL 之中參數的屬性值. 假如 value 是空值 (NULL) 他將視同空白字串 (empty) 處理.

以下是一個使用 param tag 的例子

<portlet:param name="myParam" value="someValue"/>
分享到:
评论

相关推荐

    portlet-2-spec (JSR 286)

    Portlet标签库变化(Portlet Tag Library Changes)** - **新增CSS类:**提供了额外的CSS类,增强了样式定制能力。 **8. Portlet请求分发器变化(Portlet Request Dispatcher Changes)** - **请求分发机制:**对...

    liferay portal(jsp)开发指南

    在Liferay中,需要添加PortletContextListener监听器,以及引用Liferay的Portlet Tag Library(TLD): ```xml ... &lt;listener-class&gt;...

    Spring mvc portlet demo

    在portlet中,视图通常是JSP页面,使用EL(Expression Language)和JSTL(JavaServer Pages Standard Tag Library)来展示数据。 4. **DispatcherPortlet** - 类似于Spring MVC中的DispatcherServlet,...

    JSR 168 Portlet Project Creator 插件jar包

    JSR 168,全称为JavaServer Pages Standard Tag Library 1.6,是Java社区进程(Java Community Process)发布的一项标准,旨在规范portlet的开发。Portlet是一种可重用的Web组件,常用于企业级应用程序,特别是内容...

    WebSphere Portal 6.1 Portlet隐藏 和 动态Title实现

    在`Control.jsp`中,开发者可能使用JSTL(JavaServer Pages Standard Tag Library)或EL(Expression Language)来处理动态数据,并通过JavaScript或jQuery处理DOM操作,实现Portlet的显示隐藏以及Title的动态更新。...

    struts2-portlet-2.0.11

    这个版本包含了多个重要的TLD(Tag Library Descriptor)文件,这些文件在Java Servlet和JSP技术中用于定义自定义标签库。 1. **struts-bean.tld**: 这个TLD文件是Struts1的遗留组件,尽管Struts2已经不再直接使用...

    index-database-portlet

    3. **JSP(JavaServer Pages)**:用于创建portlet的动态视图部分,结合EL(Expression Language)和JSTL(JavaServer Pages Standard Tag Library)来展示数据。 4. **Java Persistence API (JPA)**:可能用于处理...

    Squares Portlet Framework-开源

    这款框架的诞生,源于IBM的先进理念和技术积累,它在原有的基础上融合了JSTL(JavaServer Pages Standard Tag Library)和一系列实用的标记库,为开发者提供了一套完善的解决方案,特别在处理表单和数据验证方面展现...

    pluto-src-1.0.1-rc1.zip

    3. **LICENSE.jstl**: JSTL(JavaServer Pages Standard Tag Library)是JSP的一个标准标签库,包含处理各种常见任务的标签,如迭代、条件判断等。LICENSE文件表示JSTL的许可信息。 4. **LICENSE.portlet-api**: ...

    liferay portal 开发实例

    5. **JSP页面**:视图部分,负责展示数据,通常使用EL(Expression Language)和JSTL(JavaServer Pages Standard Tag Library)来动态渲染内容。 6. **部署描述符**:如liferay-plugin-package.xml,定义portlet的...

    jsp参考文献jsp参考文献jsp参考文献jsp参考文献

    - **JSTL(JavaServer Pages Standard Tag Library)**:标准标签库,提供了一组通用的标签,简化了JSP开发。 - **Servlet生命周期**:因为JSP最终会被编译为Servlet,所以理解Servlet的初始化、服务和销毁阶段对JSP...

    spring web flow reference 2.4.0

    - **Spring Security Facelets Tag Library**:集成了Spring Security的Facelets标签库,提高了安全性。 - **Spring JavaScript Updates**:改进了JavaScript的更新机制,使得前端与后端之间的交互更加流畅。 - **...

    SpringMVC所需包

    - `jstl`: JavaServer Pages Standard Tag Library,用于在JSP页面中处理数据和控制流程。 - `javax.servlet-api`和`javax.servlet.jsp-api`: 这些是Servlet和JSP API的依赖,用于与Web服务器交互。 - `jackson`...

    spring mvc 3.0.5 jar包

    - `jstl-1.1.2.jar`:JavaServer Pages Standard Tag Library,用于在JSP页面中执行标准动作和表达式语言。 8. **服务器端的类加载器优化**: - `org.springframework.instrument.tomcat-3.0.5.RELEASE.jar`:当...

    ssm依赖jar包

    3. jstl:JavaServer Pages Standard Tag Library,提供了一套标准的标签库,简化JSP页面的编写。 4. log4j或logback:日志框架,用于记录应用程序的日志信息。 5. mysql-connector-java:MySQL的JDBC驱动,如果你的...

    jetspeed 工具

    同时,Jetspeed兼容其他Java标准,如Servlets、JSP(JavaServer Pages)和JSTL(JavaServer Pages Standard Tag Library),这使得与其他Java框架的集成变得更加简单。 在“jetspeed-2.1.3”这个压缩包中,包含了...

    SpringMVC+Spring+Mybatis所需jar包

    7. **JSTL**: JSP Standard Tag Library,JSTL 是一组用于处理常见Web应用任务的JSP标签库,包括核心标签、HTML标签、XML标签和函数标签等。使用JSTL可以减少Java代码在JSP页面中的使用,使页面更易于阅读和维护。 ...

    spring-reference.pdf

    - **A form tag library for Spring MVC**: 为Spring MVC提供了表单标签库,方便创建HTML表单。 - **Sensible defaulting in Spring MVC**: 在Spring MVC中提供了合理的默认配置,减少了配置工作量。 - **Portlet ...

    Spring 2 参考

    - **A form tag library for Spring MVC**:Spring MVC框架中加入了表单标签库,这极大地简化了Web表单的创建过程。 - **Sensible defaulting in Spring MVC**:Spring MVC提供了更为合理的默认配置,减少了开发过程...

Global site tag (gtag.js) - Google Analytics