liferay中文指南

liferay porta安装指南(初稿).............................................................................................. 1

1 介 绍............................................................................................................................. 2

1.1 入门................................................................................................................... 2

1.2 推荐配置............................................................................................................ 2

2 安 装............................................................................................................................. 2

2.1 配置开发环境..................................................................................................... 2

2.2 获得liferay portal 源码........................................................................................ 3

2.3 安装你的IDE--Eclipse......................................................................................... 3

2.4 用liferay的源码做开发........................................................................................ 3

2.4.1 获得Orion容器......................................................................................... 4

2.4.2 在Eclipse中配置Orion.............................................................................. 4

2.4.3 启动Orion................................................................................................. 5

2.4.4 配置你的Properties.................................................................................... 6

2.4.5 配置Orion................................................................................................. 6

2.5 创建扩展环境..................................................................................................... 7

2.5.1 启动扩展................................................................................................... 7

2.5.2 添加插件(主要是编译专业版).................................................................... 8

2.5.3 挂载数据库............................................................................................... 8

2.5.4 starting Liferay............................................................................................ 8

3 关于翻译...................................................................................................................... 8

1 介绍

1.1 入门

牋 在 这个文档中,我的目标是帮助大家设置你的额开发环境,使你可以自己在这个软件上开发出portlets.这个文档的起点是你必须具备一些web常识以及做 Servlet,jsp的开发经验.你们可能会在不同的操作系统上运行.我的能力有限,但是我会尽量保证这个配置可以适用于不同的系统

1.2 推荐配置

牋 虽然你的配置可能不高,但是作为开发和定制化Liferay,我们推荐下列硬件配置:

1 G内存

2.0 G CPU

2 安装

2.1 配置开发环境

配置Liferay可以完成任何企业级的JAVA应用任务.

Liferay 控制使用几个框架. 幸运的是,大部分的框架Liferay已经把它捆绑在了一起. 如果你想在Liferay上安装一些其他的工具.首先你要确保你的机 器上已经正确安装java JDK.你最好在你的机器上安装最新稳定的J2SE1.4.2这个版本.如果你没有请到http://java.sun.com这里去下载最新的版本.假设我下载以后解压缩放在D:\Java  这个目录中!当然你也可安装在你喜欢的目录中,但是从现在开始下文提到的{Java}我们都指的是这个安装目录.虽然你喜欢使用Sun的默认java编 译器,但是我们推荐你使用IBM的Jikes编译器--通常它可以描述更多的编译错误.确定你下载的是Jikes的1.21的版本,因为1.22是在 JDK1.5下工作运行的,由于不能向后兼容所以Liferay portal不能用.最终你还需要从http://ant.apache.org.下载Ant这个Java基本编译工具,解压缩到上面我们提到的那个目录(D:\Java).

接着设置你的环境变量:在WIndows下,打开控制面板/系统/高级/环境变量,新建变量:JAVA_HOME,ANT_HOME,JIKES_HOME

注意要把他们的路径写正确.设置JAVA的CLASSPATH以便其他的应用能在机器上运行.在PATH中添上%ANT_HOME%\bin;%JAVA_HOME%\bin;%JIKES_HOME%\bin

2.2 获得liferay portal 源码

现在开始,从 http://www.liferay.com/web/guest/downloads/portal_source

下 载最新稳定的Liferay portal企业版代码. 我把它解压缩到这个目录 D:\cvsroot\liferay (我使用CVS来储存代码), 接下来我们将使用{Liferay}来代表这个目录. 当你下载了这个稳定的 Liferay,Then download the latest stable Liferay,这个指南已经包括了基于tomcat的专业版.我将 在稍后在这章介绍关于Tomcat的捆绑.

2.3 安装你的IDE--Eclipse

尽管你可能用记事本修改或者部署Liferay portal 一些简单的事情,但是一个好的IDE工具可以加速提升你的工作.我向你展示 Eclipse这个工具,它可以很方便的部署和运行Liferay portal.下载最新的Eclipse版本

http://www.eclipse.org/downloads/index.php.  安装 Eclipse 到 {Java}\eclipse 且运行它.在菜单上 选择File/ Switch Workspace…然后选择 {Liferay}这个目录.

 

在workspace中启动你的工程, 选择 File /New/Project. 在对话框中选择Java Project 然后点击Next.在这个新的窗口中输入portal作为Project Name然后点击Finish.

 

如 果你恰当设置Workspace, 你应该可以在导航中看到portal这个工程的透视图. 在这个工程的根目录上单击鼠标右键选择 Properties/Java Build Path 点击右边Libraries你需要的jar包都已经加载上了.这些jar文件是通过 {Liferay}\portal 下面的 .classpath 文件定义加载的.

 

添加Eclipse的插件是很容易的事情. 自从 Eclipse集成Ant以后,启动Ant是个很容易的事情在Window菜单下选择Show View/Ant. 你就可以看到这个Ant显示在你的透视图中.

增 加 Liferay’s 构建文件也是这样的简单.简单到你就选择透视图上面的Ant然后单击Ant +这个符号. 注意这样会用Ant读到出现每个目录 中自己的build.xml文件. 我们单击选择portal这个目录中的build.xml文件. 你的启动图形如图 2.3.

2.4 用liferay的源码做开发

在一下部分我们主要介绍怎么使用Orion这个容器对Liferay的源码做开发和调试. It is important to note that working off the core source is not

recommended. 如果你想要扩充Liferay portal的功能的话,它是你要增加一个扩充的环境(在2.5节我们主要讲怎么扩展功 能).Development of the core portal should only be done for bug fixes or

enhancements that potentially would make it into the next build. Typical developers will

not need to read this section.

2.4.1 获得Orion容器

首先从 http://www.orionserver.com  , 下载Orion. 把这个文件释放到(i.e. {Java}\orion-2.0.6)这个目录,以下我将使用{orion}来代表上面这个路径.运行这个命令来测试你的服务“java –jar orion.jar”.

2.4.2 在Eclipse中配置Orion

在Eclipse中启动运行Orion需要我们稍微花些时间设置一下.首先在你的透视图下,右键工程名称在出来的菜单中选择Debug as/Debug,然后会出来一个对话框. 

 

如果你以前在 Java Application下面已经配置好一些,你可以新建一个或者删除它.在前面点击New这个按钮, 并且改变下列内容:

Main Tab页:

1. 改变name配置为 “orion”

2. 设置 Main class 为 “com.evermind.server.ApplicationServer”

 

Arguments Tab页:

1. Program arguments: -config {orion}/config/server.xml - userThreads (note that

you need to change the directory path)

2. VM arguments: -Xmx256m - Dfile.encoding=UTF8 - Duser.timezone=GMT

 

Classpath Tab页:

1. under the User Entries group, remove the “portal (default classpath)” entry

2. 单击 Add External JARs,在系统中找到你安装orion的目录中的orion.jar 添加它

注意: make sure that within your JRE Tab, your Project JRE points to a SDK as

opposed to just a JRE (i.e. my Project JRE has j2sdk1.4.2_05 next to it in parenthesis.

This may require you to add another entry within Java (from the left navigation) --

Installed JREs.
 

 

2.4.3 启动Orion

配置Orion有三个关键的文件. 第一个, {orion}\config\server.xml,

let’s you specify which “web-sites” will be accessible when started up. 增加一个新的

website 并插入这些内容:

<web-site path="./web-sites/portal.liferay.com- web.xml" />

注意这里,在Liferay网上下载得那个config里面是这样设置得<web-site path="./web-sites/default-web.xml" />
 

 

你还的指定一个Orion的另一个编译器:

<compiler executable="jikes" classpath="{Java}\jre\lib\rt.jar" />

现 在你已经详细指定了这个新的website,你需要创建一个调用文件portal.liferay.com-web.xml 在这个目录中 {orion}\config\web-sites\. 你可以看到类型于(Figure x.2. portal.liferay.com- web.xml)的图.

 

最后, 在{orion}\config\application.xml, 你需要增加两个 模块web- module 和ejb-module.所有web-app的元素声明在你的 portal.liferay.comweb.xml但是这 些声明也必须定义在你的 application.xml:见图(Figure x.3. application.xml)

通过插入ejb-module元素给你的EJBs增加一个适当的参考. 注意你可以在Orion中通过使用"file:"前缀直接找文件. An advantage

of using this prefix is that you don’t have to deploy your files to the server. 这 个可以有助于你快速的调试JSPs (简单的保存和更新你的JSP).另一个原因是它可以很好的编译和部署source文件成为class.

Note: When using the “file:” prefix for the portal-ejb module, you need to ensure that

the portal-ejb.jar does not exist within your {orion}\applications\ directory.
 

最 后,你必须编辑 {orion}\config\data- sources.xml 是你的应用能访问到你的数据库. 如果你使用的mysql请确认 mysql.jar已经部署到 {orion}\lib\目录, 配置你data- sources.xml 文件例似下面:

<data-sources>

<data-source

class="com.evermind.sql.DriverManagerDataSource"

name="Liferay"

location="jdbc/LiferayCore"

pooled-location="jdbc/LiferayPool"

xa-location="jdbc/xa/LiferayXA"

ejb-location="jdbc/LiferayEJB"

connection-driver="com.mysql.jdbc.Driver"

url="jdbc:mysql://localhost/lportal"

username="root"

password=""

inactivity-timeout="30"

schema="database-schemas/mysql.xml"

/>

</data-sources>

2.4.4 配置你的Properties

Liferay的配置多数都在 portal.properties 这个文件中. 类似于你的这个文件 build.properties,你在portal- ext.properties设置它的属性都比在portal.properties它本身根方便.

给你的portal配置一个,创建一个新的文件在{Liferay}\portal\util-java\ 这个目录中文件名为portal- ext.properties. 在里面添加下列设置:

portal.ctx=/portal

此外,注意在这个portal- ext.properties设置这个属性就不用考虑在portal.properties设置.

2.4.5 配置Orion

如果你想要你的Ant命令知道在什么地方部署它,你需要创建一个扩展名类app.server.{username}.properties. 在这个文件中添加一行 app.server={orion}

这 个 {orion} 就是我们安装Orion的目录, 例如这样 (i.e. app.server=D:/Java/orion- 2.0.5). 最 后用你Eclipse的Ant 显示, 运行你portal目录中的start和delpoy 标记. 如果你使用"file"前缀,不要忘记去删出 portal-ejb.jar 以后部署!

你全部设置了! 在你的Debug透视图中到前面单击bug 这个图标,这时在你的控制台就会看到Orion开始启动.

2.5 创建扩展环境

通 过扩展环境来开发和部署你的portlets 是你最感兴趣的. 这样可以改良你的portal但是不会让你有任何头痛的. 任何时间发布一个新的稳定的 Liferay portal 的版本,是你做的并且是一个震惊的,你可以把它卖掉.同样可是说你开发一个健壮的扩展环境. 所有新的 classes,JSPs,和所有的新的改变都应该在{Liferay}\ext里面.

 

It is in your best interest to develop your portlets via an Extension Environment. This

would allow you to upgrade your portal without any headaches. Any time a new stable

version of Liferay Portal is released, all you would need to do is drop in the new jars

and you’re set to go. With that said, your development should only be done within the

Extension Environment as well. Meaning, all new classes, JSPs, and all changes in

general, should be within {Liferay}\ext.

2.5.1 启动扩展

设 置启动你的扩展环境是很简单的. 在做任何事情之前,你需要改变一个属性文件(.properties)在 {Liferay}\portal目录 中. 注意在这个.properties 默认的文件中你从未改变这个值. 在每个.properties文档的顶部遵循它的注释替换(改变),需要创建 一个扩展名类似于这个release.{username}.properties的文件. 你可以在开始/运行 下打开一个命令提示这 个＄{username}的值会出现在Documents and Settings 后面.在你的这个新的.properties文件中添加正确的一行 ({Liferay}是真实的目录:

lp.ext.dir={Liferay}/ext

(Note that it’s a forward slash)

 

接 下来, 在2.3节中描述的Ant显示中,你能够扩展portal build.xml中的对象(taegets)列表. 在这些对象(taegets) 中,你可以看到 clean, start, build- ext.向前双击那些对象(taegets)一会儿观察它的输出. 你将看到一大堆文本的输 出通过指示说明你的扩张环境在运行.请仔细检查控制台输出的红色错误. 你可能发现你有一些可怕的错误设置在你的属性中. 如果所有的都很好,那么你应该 能到这里浏览你你扩展目录

{Liferay}\ext!

2.5.2 添加插件(主要是编译专业版)

主要是添加一个Tomcat编译环境老启动Liferay的专业版.大家看文档吧,确实累了

2.5.3 挂载数据库

对于这样挂载数据库请大家参考这个,http://www.liferay.com/web/guest/documentation/development/databases

2.5.4 starting Liferay

现在你有一个完整的开发环境,到前面单击Tomcat这个图标来启动你的web 服务.此时在你的portal已经启动,你可以在浏览器中输入 http://localhost  来查看运行效果!