PDF《Realizing the Benefits of Lifreay'》

0

1 2

3 3.

1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 3.10

4 5 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9 5.10 5.11 5.12

6 7 目录 介绍 Realizing the Benefits of Lifreay'

s Developement Platform Working with Liferay'

s Developer Tools 开发 Portlet 应用 创建 Portlet 项目 Portlet 项目概览 实现 My Greeting Portlet 理解 Portlet 执行的两个阶段 从 Action 阶段向 Render 阶段传递信息 开发有多个 action 的 Portlet 为 Portlet 设置友好的 URL Portlet 本地化 实现 Portlet 偏好设置 Creating Plugins to Share Templates, Structures, and More Developing JSF Portlets with Liferay Faces 生成服务层(Service Layer)代码 Service Builder 是什么? 定义对象-关系映射(ORM) 生成服务 写本地服务类 调用本地服务 Understanding the Service Builder-generated Code 创建用户界面 调用 Liferay 的内置服务 使用 Model Hints Writing Remote Service Classes Developing Custom SQL Queries Configuring service.properties Accessing Services Remotely Using Liferay Frameworks Liferay Portal 6.2 开发指南

2 8

9 10

11 12

13 14

15 16

17 Designing Workflow with Kaleo Creating Mobile Apps that Use Liferay Creating and Integrating with OpenSocial Gadgets Creating Liferay Themes and Layout Templates Customizing and Extending Functionality with Hooks Designing User Interfaces with AlloyUI Liferay Marketplace Advanced Customization with Ext Plugins What'

s New in Liferay 6.2 APIs? Conclusions Liferay Portal 6.2 开发指南

3 Liferay Portal 6.2 开发指南 主要内容是翻译 Liferay 的官方文档,是为了照顾公司内阅读英文文档有困难的新人. 几点说明: 1. 应该不会全部翻译,只翻译用到的. 2. 有些内容可能不全是翻译,会根据开发中遇到的问题进行一些调整. 3. 另外,因主要使用 Maven,Ant 的内容应该会比较少. 关于翻译用词的一些说明: 1. 有些术语或名称不做翻译,直接用原文. 2. folder 会翻译成 目录 . 3. 有些语句不是直译的,会尽量保证符合原意. 4. 平时很少翻译,对 Liferay 也说不上很熟悉,有任何问题希望大家指正. 似乎还是要用 Ant 构建,要不使用 Service Builder 相对复杂. Liferay Portal 6.2 开发指南

4 介绍 创建 Portlet 项目 使用 Plugins SDK 创建 portlet 非常简单.在 Plugins SDK 中有一个 portlets 目录,你的项目 就应该放在这里.先给你的 portlet 起一个 项目名(projtect name) (不能有空格)和一 个 显示名(display name) (可以有空格). 对于 greeting portlet,项目名是 my-greeting,portlet 标题是 My Greeting . 起好名字后就可 以开始创建项目了.可以用不同的方法来创建这个项目,先使用 Liferay Developer Studio(因使用的是 Liferay IDE,两者应该是类似的,后面都会改为 Liferay IDE),然后再 尝试使用命令行方式. 使用 Liferay IDE 1. 点击菜单 File ->

New ->

Liferay Project. 2. 在 Project Name 和 Display Name 中分别填写 my-greeting-portlet 和 My Greeting . Liferay Portal 6.2 开发指南

5 创建 Portlet 项目 3. 保持 Use default location checkbox 选中.默认的 default location 就是当前使用的 workspace.如果你想把项目保存到其它位置,取消选项并且指定存储目录. 图3.1:使用 Liferay IDE 创建 portlet 项目非常简单. 4. 选择 Ant(liferay-plugins-sdk) 构建方式.如果你想用 Maven 构建方式,请浏览 Developing Plugins Using Maven 章节. Liferay Portal 6.2 开发指南

6 创建 Portlet 项目 5. 设置好的 SDK 和 Liferay 运行环境应该已经被选中了.如果你还没有设置 Plugins SDK,点击 Configure SDKs 来打开 Install Plugin SDKs 向导.如果要设置运行环境,需 要点击 Liferay Portal Runtime 下拉菜单后面的 New Liferay Runtime 来打开 New Server Runtime Environment 向导. 6. 选择 Portlet 插件类型. 7. 点击 Next. 8. 在下一个客串中,选择 Liferay MVCframework,然后点击 Finish. 可以创建一个新的 plugin 项目,也可以在现有 Liferay 项目中创建一个新的 plugin.一个 Liferay 项目可以包含多个 plugin. 使用命令行 实际上和使用 IDE 创建是类似的,只不过 IDE 通过图形界面收集参数,然后帮我们去执行 ant 或 maven 了.就不翻译了. 部署 Portlet 项目 Liferay 提供了一种称为 auto-deploy 的机制来轻松地部署 portlet 和其它类型的 plugin 项目. 只要将 war 文件放到 deploy 目录中,就会自动部署到应用服务器中(portal 会做一些处 理).本文中都会使用这种方式进行部署. 注意: 这种 auto-deploy 的机制只在像 Tomcat、Jboss 这样的应用服务器中可用.在Weblogic、Websphere 等应用服务器中需要使用相应的工具进行部署,这种机制就不好用 了. 在 Liferay IDE 中部署 将 portlet 项目拖到应用服务器中.部署 plugin 项目时,应用服务器会输出一些信息表示 plugin 已经读取、注册并且已经可以使用了. Reading plugin package for my-greeting-portlet Registering portlets for my-greeting-portlet