JSR 168 翻译00（目录）

JSR 168 翻译00（目录）

1.    前言

1.1.        其他参考资源

1.2.        本规范目标读者

1.3.        API 参考

1.4.        其他java(tm) 平台规范

1.5.        其他重要的参考

1.6.        术语

1.7.        提供反馈

1.8.        致谢

2.    总览

2.1.        什么是Portal（门户）？

2.2.        什么是Portlet？

2.3.        什么是Portlet 容器？

2.4.        一个示例

2.5.        Portlet规范和J2EE 的关系

3.    Portlet规范与Servlet规范的关系

3.1.        Portlet 与Servlets/JSPs

3.2.        Portlet容器 与Servlet容器的关系

4.    概念

4.1.        Portal 页面的元素

4.2.        Portal 页面的生成

4.3.        Portal 页面请求响应的序列

5.    Portlet 接口

5.1.        Portlet 实例的个数

5.2.        Portlet 生命周期

5.2.1.            装载和实例化

5.2.2.            初始化

5.2.2.1.  初始化中的错误情况

5.2.2.2.  工具考量

5.2.3.            Portlet 窗口

5.2.4.            处理请求

5.2.4.1.  请求动作

5.2.4.2.  提交请求

5.2.4.2.1.      GenericPortlet

5.2.4.3.  处理请求期的多线程问题

5.2.4.4.  处理请求期的异常

5.2.4.5.  线程安全

5.2.5.            服务完成

6.    Portlet 配置

6.1.        初始化参数

6.2.        Portlet Resource Bundle

7.    Portlet URL

7.1.        Portlet URL

7.1.1.            包括Portlet 模式或窗口状态

7.1.2.            Portlet URL 安全

8.    Portlet 模式

8.1.        模式：VIEW

8.2.        模式：EDIT

8.3.        模式：HELP

8.4.        定制Portlet 模式

8.5.        GenericPortlet 提交的处理

8.6.        定义Portlet 模式支持

9.    窗口状态

9.1.        状态： NORMAL

9.2.        状态：MAXIMIZED

9.3.        状态：MINIMIZED

9.4.        定制窗口状态

10.             Portlet Context

10.1.   Portlet Context 范围

10.2.   Portlet Context 功能

10.3.   与servlet Context 关系

10.3.1.       ServletContext 与PortletContext 通讯方法

11.             Portlet 请求

11.1.   PortletRequest 接口

11.1.1.       请求的参数

11.1.2.       额外的请求参数

11.1.3.       请求的属性

11.1.4.       请求的Properties

11.1.5.       请求Context 路径

11.1.6.       安全属性

11.1.7.       响应类型

11.1.8.       国际化

11.1.9.       Portlet 模式

11.1.10.  窗口模式

11.2.   ActionRequest 接口

11.2.1.        接收上载数据

11.3.   RenderRequest 接口

11.4.   请求对象生命期

12.              Portlet 响应

12.1.   PortletResponse 接口

12.1.1.       响应的Properties

12.1.2.       URL 编码

12.2.   ActionResponse 接口

12.2.1.       重定向

12.2.2.       Portlet 模式和窗口状态改变

12.2.3.       提交参数

12.3.   RenderResponse 接口

12.3.1.        内容类型

12.3.2.       输出流和Writer 对象

12.3.3.       缓冲

12.3.4.       Namespace 编码

12.3.5.       Portlet 标题

12.4.   响应对象的生命期

13.             Portal Context

14.             Portlet 参数选择

14.1.   PortletPreferences 接口

14.2.   参数选择属性范围

14.3.   参数选择属性定义

14.3.1.       本地化参数选择属性

14.4.   确认参数选择值

15.             会话(session)

15.1.   创建一个session

15.2.   session 范围

15.3.   绑定属性到session

15.4.   与Web 应用HttpSession的关系

15.4.1.       HttpSession 方法映射

15.5.   保留的HttpSession 属性名

15.6.   session 超时

15.7.   最后连接的时间

15.8.   重要的Session Semantics

16.             分发请求到servlet 和JSP

16.1.   获得PortletRequestDispatcher

16.1.1.       在请求分发器路径中查询字符串

16.2.   使用一个请求分发器

16.3.   包含的方法

16.3.1.       包含的请求参数

16.3.2.       包含的请求属性

16.3.3.       为Servlets/JSPs 包含的请求、响应对象

16.3.4.       错误处理

17.             用户信息

17.1.   定义用户属性

17.2.   访问用户属性

17.3.   用户信息要点

18.             高速缓存

18.1.   超期缓存

19.             Portlet应用

19.1.   与Web 应用的关系

19.2.   与PortletContext 的关系

19.3.   Portlet 应用的元素

19.4.   目录结构

19.5.   Portlet 应用 Classloader

19.6.   Portlet 应用打包文件

19.7.   Portlet 应用部署描述符

19.8.   替换一个Portlet 应用

19.9.   错误处理

19.10.            Portlet 应用环境

20.             安全

20.1.   介绍

20.2.   角色

20.3.   编程安全

20.4.   指定安全约束

20.5.   在EJB 调用中传递安全身份

21.             打包和部署描述符

21.1.   Portlet 和 Web 应用部署描述符

21.2.   打包

21.2.1.       目录结构示例

21.2.2.       版本信息

21.2.3.       Portlet 部署描述符元素

21.2.4.       Portlet 部署描述符处理规则

21.2.5.       部署描述符

21.2.6.       部署描述符结构图

21.2.7.       部署描述符中的唯一值

21.2.8.       本地化

21.2.8.1.           部署描述符本地化值

21.2.8.2.           Portlet 的地区支持

21.2.9.       部署描述符示例

21.2.10.  Resource Bundles

21.2.11.  Resource Bundles 示例

22.             Portlet Tag 库

22.1.   defineObjects Tag

22.2.   actionURL Tag

22.3.   renderURL Tag

22.4.   namespace Tag

22.5.   param Tag

23.             技术兼容工具箱（TCK）需求

23.1.   TCK 测试构件

23.2.   TCK 需求

23.2.1.       为TCK 测试的portal 页面公布配置

23.2.1.1.           和portal TCK 提供的XML 文件Schema

23.2.1.2.           给供应商提供的XML 文件Schema

23.2.2.       为测试的portal 页面的编程配置

23.2.3.       测试Portlet 内容

23.2.4.       需要用户身份Test Cases

A.    定制Portlet 模式

A.1. Portlet 模式：about

A.2. Portlet 模式：config

A.3. Portlet 模式：edit_defaults

A.4. Portlet 模式：preview

A.5. Portlet 模式：print

B.    标记语言片

C.    CSS 样式定义

C.1. Links (Anchor)

C.2. 字体

C.3. Messages

C.4. Sections

C.5. Forms

C.6. Menus

D.    用户信息属性名

D.1. 示例

E.    未来将有功能

F.    TCK 申明