IBM portlet开发指南

Portlet开发指南............................................................................................................................... 1 第一章节 入门介绍 ......................................................................................................................... 7 一、 Portlet简介 ............................................................................................................... 8 什么是Portal .................................................................................................................... 9 什么是Portlet ................................................................................................................... 9 什么是Portlet容器 .......................................................................................................... 9 三者关系 ......................................................................................................................... 10 版本兼容性 ..................................................................................................................... 10 JSR286的主要新特性 .................................................................................................... 10 与J2EE的版本对应 ....................................................................................................... 10 二、 Portlet与servlet的关系 ........................................................................................ 11 Portlet与servlet/jsp中的桥梁 ...................................................................................... 12 用servlet生命周期事件 ................................................................................................ 12 Servlet容器与Portlet容器之间的关系........................................................................ 12 三、 开发环境搭建 ......................................................................................................... 13 IBM WebSphere Portal环境搭建 ................................................................................... 13 Apache Pluto Portal环境搭建 ........................................................................................ 42 快速入门 ......................................................................................................................... 47 第二章节 独有概念 ....................................................................................................................... 54 四、 Portlet概念 ............................................................................................................. 55 Portlet定义 ..................................................................................................................... 55 Portlet是Portal页面中的一个区域 ............................................................................. 55 Portlet和Web框架 ....................................................................................................... 56 五、 Portlet URLs ............................................................................................................. 57 BaseURL 接口 ................................................................................................................. 57 包含Portlet Mode和 Window State信息 ................................................................... 58 Portlet URL安全性 ......................................................................................................... 58 总结 ................................................................................................................................. 58 六、 Portlet Modes .......................................................................................................... 60 查看 Portlet Mode ......................................................................................................... 60 编辑 Portlet Mode ......................................................................................................... 60 帮助 Portlet Mode ......................................................................................................... 60 自定义 Portlet Modes ................................................................................................... 60 受支持的 Portlet Modes................................................................................................ 61 七、 Window States ........................................................................................................ 62 正常 Window State ........................................................................................................ 62 最大化 Window State .................................................................................................... 62 最小化 Window State .................................................................................................... 62 自定义 Window States .................................................................................................. 62 支持的 Window State .................................................................................................... 62 八、 Portlet Preferences .................................................................................................. 63 PortletPreferences 接口 ................................................................................................ 63 Preference Attributes 范围 ............................................................................................ 63 Preference Attributes 定义 ............................................................................................ 64 第三章节 基础概念 ....................................................................................................................... 65 九、 Portlet生命周期接口 ............................................................................................. 66 Portlet 实例的数量 ........................................................................................................ 66 Portlet生命周期............................................................................................................. 66 Portlet 的个性化 ............................................................................................................ 67 Request请求处理 ........................................................................................................... 68 总结 ................................................................................................................................. 72 十、 Portlet Config .......................................................................................................... 73 初始化参数 ..................................................................................................................... 73 Portlet Resource Bundle .................................................................................................. 73 默认事件命名空间 ......................................................................................................... 74 公告展现参数 ................................................................................................................. 74 发布事件 ......................................................................................................................... 74 处理事件 ......................................................................................................................... 74 支持的国际化 ................................................................................................................. 74 支持的运行时选项 ......................................................................................................... 74 总结 ................................................................................................................................. 75 十一、 Portlet Context ................................................................................................ 76 Portlet Context范围 ....................................................................................................... 76 Portlet Context 功能 ...................................................................................................... 76 与 Servlet Context关系 ................................................................................................. 76 总结 ................................................................................................................................. 77 十二、 Portlet Requests .............................................................................................. 78 PortletRequest 接口 ...................................................................................................... 78 ClientDataRequest 接口 ................................................................................................. 82 ActionRequest 接口 ....................................................................................................... 82 ResourceRequest 接口 .................................................................................................. 82 EventRequest 接口 ........................................................................................................ 83 RenderRequest 接口 ...................................................................................................... 83 Request对象的时间范围 .............................................................................................. 83 总结 ................................................................................................................................. 83 十三、 Portlet Response ............................................................................................. 84 PortletResponse 接口 .................................................................................................... 84 StateAwareResponse 接口 ............................................................................................ 86 ActionResponse 接口 ..................................................................................................... 86 EventResponse 接口 ...................................................................................................... 86 MimeResponse 接口 ...................................................................................................... 87 RenderResponse 接口 ................................................................................................... 87 ResourceResponse 接口 ................................................................................................ 88 Response 对象的时间范围 ........................................................................................... 88 十四、 Sessions ........................................................................................................... 89 创建Session .................................................................................................................... 89 Session 范围 ................................................................................................................... 89 Session中设置属性 ........................................................................................................ 89 与Web Application HttpSession关系 ............................................................................ 89 写入Portlet Session ........................................................................................................ 90 Session Timeouts............................................................................................................. 91 最后访问时间 ................................................................................................................. 91 重要的 Session 语义 ..................................................................................................... 91 总结 ................................................................................................................................. 91 十五、 请求分发给 Servlets 和 JSPs ....................................................................... 92 获取 PortletRequestDispatcher ..................................................................................... 92 使用Dispatcher .............................................................................................................. 92 Include 方法 ................................................................................................................... 92 forward 方法 .................................................................................................................. 93 Servlet filters ................................................................................................................... 94 改变默认的Included Forwarded Session 范围 ............................................................ 94 总结 ................................................................................................................................. 94 十六、 Portlet 标签库 ................................................................................................ 95 defineObjects 标签 ........................................................................................................ 95 actionURL 标签 .............................................................................................................. 97 renderURL 标签 ............................................................................................................. 97 resourceURL标签 ........................................................................................................... 98 namespace标签 ............................................................................................................. 99 param标签 ..................................................................................................................... 99 总结 ................................................................................................................................. 99 十七、 Portlet 应用 .................................................................................................. 100 与Web Applications的关系 ........................................................................................ 100 与PortletContext的关系 ............................................................................................. 100 Portlet Application中的元素 ....................................................................................... 100 目录结构 ....................................................................................................................... 100 Portlet Application Classloader ..................................................................................... 100 Portlet Application 存档文件 ...................................................................................... 100 Portlet application 部署描述符 ................................................................................... 101 更新Portlet Application ............................................................................................... 101 十八、 打包和部署描述符 ....................................................................................... 102 Portlet和部署描述符 ................................................................................................... 102 打包 ............................................................................................................................... 102 Portlet部署描述符元素 ............................................................................................... 102 处理Portlet 部署描述符规则 ..................................................................................... 103 Portlet.xml中唯一的值 ................................................................................................ 103 第四章节 高级特性 ..................................................................................................................... 104 十九、 资源服务 ....................................................................................................... 105 ResourceServingPortlet 接口 ....................................................................................... 105 访问 Render 参数、 Portlet Mode、 Window State ............................................... 106 访问Request 和 Response Headers ........................................................................... 106 获取 HTTP 方法 .......................................................................................................... 107 访问Resource ID .......................................................................................................... 107 Resource URLs ............................................................................................................... 107 Generic Portlet 支持 .................................................................................................... 107 Ajax请求 ....................................................................................................................... 107 二十、 Portlet协作 ................................................................................................... 109 Public Render Parameters ............................................................................................. 109 Portlet Events ................................................................................................................ 110 Events传送复杂对象 ................................................................................................... 114 总结 ............................................................................................................................... 114 二十一、 Portlet Filter .................................................................................................. 116 什么是 Portlet filter ..................................................................................................... 116 主要概念 ....................................................................................................................... 117 总结 ............................................................................................................................... 119 第五章节 可选概念 ..................................................................................................................... 120 二十二、 缓存 ............................................................................................................... 121 缓存过期 ....................................................................................................................... 121 验证缓存 ....................................................................................................................... 121 总结 ............................................................................................................................... 122 二十三、 用户信息 ....................................................................................................... 123 定义用户属性 ............................................................................................................... 123 访问用户属性 ............................................................................................................... 123 重要注意事项 ............................................................................................................... 124 总结 ............................................................................................................................... 124 二十四、 安全性 ........................................................................................................... 125 介绍 ............................................................................................................................... 125 角色 ............................................................................................................................... 125 安全性代码开发 ........................................................................................................... 125 总结 ............................................................................................................................... 125 二十五、 Portal Context ................................................................................................ 126 二十六、 Portlet 容器运行时 ...................................................................................... 127 动态修改Portlet标题 .................................................................................................. 127 二十七、 使用注释的方法 ........................................................................................... 129 GenericPortlet Render Handling ................................................................................... 129 二十八、 Setting next possible Portlet Modes ............................................................. 130 二十九、 Struts2开发Portlet实例 ............................................................................. 131 三十、 Spring mvc开发Portlet实例 ....................................................................... 132 三十一、 附录 ............................................................................................................... 133 修改记录 ....................................................................................................................... 133 名词解释 ....................................................................................................................... 133 疑问 ............................................................................................................................... 134