Liferay Portal 6学习笔记3:Liferay IDE的安装使用

Liferay Portal 6在23号做了一个小版本更新，现在的版本是6.04，主要是修复了大量的bug

下载地址如下：http://sourceforge.net/projects/lportal/files/Liferay%20Portal/6.0.4/

更新内容：http://issues.liferay.com/secure/ReleaseNote.jspa?version=10550&styleName=Html&projectId=10952

 

Liferay IDE安装

简介

Liferay IDE是一个Eclipse插件，用来方便进行Liferay开发，主要是方便开发portlet、插件开发、布局模板、主题包的制作等。现在的版本为1.01，支持Eclipse 3.5和3.6。仅用于Liferay 6+版本，不支持早期版本。

 

比如之前开发Portelt，如果手动的编写配置信息到portlet.xml，liferay-portlet.xml，liferay-display.xml，language.properties等信息，现在可以通过Liferay IDE的portlet向导进行，就像Eclipse中servlet的开发一样，可以大大提高生产力。

 

安装

Liferay IDE是一个Eclipse插件，安装方法和普通的插件一样，仅支持Eclipse 3.5和3.6其他版本不能保证能正常运行。

 

在线更新地址：

 

Eclipse Galileo SR2 (3.5.2) http://releases.liferay.com/tools/ide/eclipse/galileo/stable/

Eclipse Helios (3.6.0) http://releases.liferay.com/tools/ide/eclipse/helios/stable/

离线包下载

http://sourceforge.net/projects/lportal/files/Liferay%20IDE/liferay-ide-eclipse-updatesite-1.0.1.zip/download

 

Liferay IDE配置

SDK的安装

Liferay提供的有一个SDK，就是在上一篇文章中下载得到的SDK。打开Eclipse-windows-prefernces，在左边找到Liferay--Installed SDKs，点击右边的add-->browse；在add的下方有一个download，如果这里没有下载SDKs，可以在这里在线安装，不过不推荐，这里的下载速度超慢。安装后如下图：

 

 

配置服务器环境

在打开的Eclipse属性里面，找到左边的server--Runtime Environment，点击添加，找到liferay,Inc，如下图：

 点击，Next-->Browse(这里下面的Download and Install是在线安装，太慢不建议),找到我们下载的Tomcat绑定包，即liferay-portal-tomcat-6.0.4.zip这个文件的解压目录。点击确定。

 

测试IDE

打开Eclipse的服务器管理界面，如果找不到windows ---show views--servers，右键New-->server，Liferay,Inc，在这里找到Liferay V6.0 server，点击OK。现在在server的界面里面应该已经有了Liferay server，在上面点击右键，start。等待tomcat启动完成。

 

待启动完成后，在server上面点击右键 Liferay -->Open Portal home，就能在Eclipse的浏览器里面打开Liferay Portal。这个Portalt的配置请看： LifeRay Portal 6学习笔记2:Liferay Portal6安装及简单设置

 

创建一个插件开发工程

Liferay的开发模式基本上有两种，一种是插件式的开发，一种是扩展环境的开发，现在我们使用Liferay IDE创建一个插件式的开发环境

 

Eclipse ->new->other->Liferay->Liferay Plug-in Project。如下图，填写相应的Project Name，点击确定。

 这个时候我们就创建了一个插件开发的工程，名字叫liferayStudy。

编写自己的Portlet

运行工程

在分析Portlet之前，首先让我们上面创建的工程在Liferay里面跑起来，在server视图里面，new-server选择Liferay server，next，如下：将有效的工程添加到Liferay server里面，然后点击完成。

分析Portlet

在创建自己的Portlet之前，我们首先来分析一下liferay里面的portlet都有哪些东西。在完成上一步操作之后，启动Liferay server，输入帐号密码，点击“添加”-“更多”（不清楚之处，请参数上一篇文章）-“示例”，呵呵，现在看到了什么？我们刚才创建的工程liferayStudy,如下图。

 点击添加，就可以看到将这个portlet添加到了Liferay中。

 

我们只是添加了一个插件工程，这个portlet从哪里来的呢？其实这个是创建工程是创建的一个默认portlet，在创建自己的portlet之前，首先来分析一下这个portlet是怎么添加到Liferay里面，并让我们简单通过添加来添加的呢？

 

涉及的文件如下：

portlet.xml

liferay-portlet.xml

liferay-display.xml

 

首先看portlet.xml里面的内容

 

<portlet>
		<portlet-name>liferayStudy</portlet-name>
		<display-name>LiferayStudy</display-name>
		<portlet-class>com.liferay.util.bridges.mvc.MVCPortlet</portlet-class>
		<init-param>
			<name>view-jsp</name>
			<value>/view.jsp</value>
		</init-param>
		<expiration-cache>0</expiration-cache>
		<supports>
			<mime-type>text/html</mime-type>
		</supports>
		<portlet-info>
			<title>LiferayStudy</title>
			<short-title>LiferayStudy</short-title>
			<keywords>LiferayStudy</keywords>
		</portlet-info>
		<security-role-ref>
			<role-name>administrator</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>guest</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>power-user</role-name>
		</security-role-ref>
		<security-role-ref>
			<role-name>user</role-name>
		</security-role-ref>
	</portlet>

 

这里面的内容很多看名字都可以理解， 关键点在portlet-name，和init-param下面的其他权限什么的一看就明白不再细说。

 

 

portlet-name是和其他相关文件关联的“ID”,init-parma显示的是关联的JSP文件。

 

这个portlet.xml的定义是portlet 2.0规范定义的。

 

下面看lifery-portlet.xml

 

<liferay-portlet-app>
	<portlet>
		<portlet-name>liferayStudy</portlet-name>
		<icon>/icon.png</icon>
		<instanceable>true</instanceable>
		<header-portlet-css>/css/main.css</header-portlet-css>
		<footer-portlet-javascript>/js/main.js</footer-portlet-javascript>
		<css-class-wrapper>liferayStudy-portlet</css-class-wrapper>
	</portlet>
	<role-mapper>
		<role-name>administrator</role-name>
		<role-link>Administrator</role-link>
	</role-mapper>
	<role-mapper>
		<role-name>guest</role-name>
		<role-link>Guest</role-link>
	</role-mapper>
	<role-mapper>
		<role-name>power-user</role-name>
		<role-link>Power User</role-link>
	</role-mapper>
	<role-mapper>
		<role-name>user</role-name>
		<role-link>User</role-link>
	</role-mapper>
</liferay-portlet-app>

 

 这个里面的大部分信息也是看名字就能知道是什么意思，这个文件算是将前面定义的portlet在liferay里面注册，关联信息是使用的portlet-name

 

下面看liferay-display.xml

 

<category name="category.sample">
		<portlet id="liferayStudy" />
	</category>

 

这里面的信息很少，只有portlet id="liferayStudy"这一个，这个是归类，将前面定义的portlet归类到哪个下面，这里面sample，所以在上面我们是在示例这个分类在下面找到这个portlet的。

 

创建自己的portlet

以前没有Liferay IDE时，上面的那些配置信息都要手动撰写的，现在有了liferay IDE,都可以通过向导创建来完成。

 

在我们上一步创建的工程里上面点右键-New--Liferay Portlet，出现的界面如下：

 在这里输入相应的Portlet class，和相应的包名，其他的不用变，这两个是可以自定义的，点击下一步

 

注意：接下来的两个步骤里面基本上也不用动其他的，但是这个向导生成的portlet info里面的name，第一个字母变成了小写，这里务必要改过来，就是第一步里面的portlet class要和后面的portlet name一致，不然在添加Portlet时会报错。

 点击下一步，完成即可。

 

刷新浏览器，在“添加”-->“更多”-->"示例"里面即可以看到我们到才添加的portlet。

 

点击添加的Portlet上面的小螺丝刀，可以看到，多了首选项和帮助等。这时我们在上面的Portlet Modes里面选中Edit，Help的效果

这些里面要显示什么具体的信息和要展现什么具体内容，根据需要了，相应的JSP存在docroot/portletdemo下面。

 

PS：在SDK的目录里面有一个build.properties文件，这是属性的配置文件，用来指定Tomcat的位置的，不推荐在这上面直接编辑，而是复制一份将其重命名为build.${user.name}.properties，其中的${user.name}指的是当前系统用户名，如果不确定，打开cmd，后面跟的就是当前用户名，如我的为huqiwen,有些是administrator。如果是administrator，就命名为build.administrator.properties。

 

在这个文件里面只要填上要修改的项就可以了，会自动覆盖build.properties里面的对应项

评论

18 楼 SINCE1978 2016-06-07  

jsr168 portlet不过是sun又一个半死不活的规范，同时小众到家了，鸡肋
“就像Eclipse中servlet的开发一样”——serverlet需要动用IDE去写吗？，从这个角度看，说白了这个portlet插件也是个鸡肋

17 楼 actan 2012-10-09  

eclipse 3.7 的插件也有了，更新地址：

http://releases.liferay.com/tools/ide/eclipse/indigo/stable/

16 楼 hu437 2011-09-28  

coolhappiness 写道

我出现的 问题 就是 ，在 建立的 项目上点击 右键，新建--》列表中 没有 楼主 文章 中的 
New--Liferay Portlet
请 楼主帮忙 ，，，解惑~！~~~~~

                                非常   感谢 ！！！！

我不确定你的是什么问题，可以换以下步骤操作
1、查看你的视图是否中liferay视图
2、如果在new里面找不到，可以在new-other-liferay里面寻找
3、或者可以在工具栏里面，使用工具栏里面的按钮

15 楼 coolhappiness 2011-09-28  

我出现的 问题 就是 ，在 建立的 项目上点击 右键，新建--》列表中 没有 楼主 文章 中的 
New--Liferay Portlet
请 楼主帮忙 ，，，解惑~！~~~~~

                                非常   感谢 ！！！！

14 楼 coolhappiness 2011-09-28  

help：

请问 楼主：我 现在 安装好 liferay的ide 后 可以 new “Liferay Project”，建立Liferay Project 工程 后  ，按照 楼主 文章中 “创建自己的portlet”章节 ，创建 portlet “在我们上一步创建的工程里上面点右键-New--Liferay Portlet，出现的界面如下：” 请问 为什么我这里 找不到 这一 步骤？

13 楼 hu437 2011-02-14  

zhengpei456 写道

请问Liferay IDE 是否只是针对eclipse的？对于SpringSource可以安装不？一安装就提示：

Cannot complete the install because one or more required items could not be found.
  Software being installed: Liferay IDE 1.1.0.v201009141126 (com.liferay.ide.eclipse.tools.feature.group 1.1.0.v201009141126)

没有用过SpringSource，是Eclipse的一个插件，现在的版本是1.2

12 楼 zhengpei456 2011-02-11  

请问Liferay IDE 是否只是针对eclipse的？对于SpringSource可以安装不？一安装就提示：

Cannot complete the install because one or more required items could not be found.
  Software being installed: Liferay IDE 1.1.0.v201009141126 (com.liferay.ide.eclipse.tools.feature.group 1.1.0.v201009141126)

11 楼 forlhd 2010-10-28  

hu437 写道

forlhd 写道

谢谢你的学习笔记，我开始学，用liferay6.0.5，但是在学的过程出现了问题，你可以帮我解决下吗？
就是我在IE中登录(用test)后，点击添加->更多，就一直loading。。点击管理->页面布局，也是loading..这个问题一直解决不了。
我按照你的方法，创建过一个portlet，有人说是我的一个portlet可能有问题。
可是我在别的地方复制一个liferay，开始server，登录后还是这样的问题？
知道这是什么原因吗？

我想这个和浏览器没有关系，liferay一直这样就是页面有错误的问题

你看一下你的后台有没有报错？

如果没有你运行你从官方下载的绑定的干净的tomcat运行看一下

从官方下载绑定的干净的liferay6.0.5,还是一样。但是我换成google浏览器就可以了。。

10 楼 hu437 2010-10-27  

forlhd 写道

谢谢你的学习笔记，我开始学，用liferay6.0.5，但是在学的过程出现了问题，你可以帮我解决下吗？
就是我在IE中登录(用test)后，点击添加->更多，就一直loading。。点击管理->页面布局，也是loading..这个问题一直解决不了。
我按照你的方法，创建过一个portlet，有人说是我的一个portlet可能有问题。
可是我在别的地方复制一个liferay，开始server，登录后还是这样的问题？
知道这是什么原因吗？

我想这个和浏览器没有关系，liferay一直这样就是页面有错误的问题

你看一下你的后台有没有报错？

如果没有你运行你从官方下载的绑定的干净的tomcat运行看一下

9 楼 forlhd 2010-10-27  

我用的是IE7浏览器

8 楼 forlhd 2010-10-27  

谢谢你的学习笔记，我开始学，用liferay6.0.5，但是在学的过程出现了问题，你可以帮我解决下吗？
就是我在IE中登录(用test)后，点击添加->更多，就一直loading。。点击管理->页面布局，也是loading..这个问题一直解决不了。
我按照你的方法，创建过一个portlet，有人说是我的一个portlet可能有问题。
可是我在别的地方复制一个liferay，开始server，登录后还是这样的问题？
知道这是什么原因吗？

7 楼 hu437 2010-09-07  

yay2008 写道

你好,在配置完SDK和运行环境后.在server上点Open Portal home打开主页后,用[e-mail]账户登录进去,点击左上角的'添加'按钮,到了加载Portlet的页面就不动了..一直显示加载中,但是在ie中打开就没问题,不知道怎么会事儿.我用的6.0.5版难道这个版本有问题...

这个版本没有问题，我不知道你用的什么浏览器，我用Chrome是没有问题的~~

6 楼 yay2008 2010-09-07  

你好,在配置完SDK和运行环境后.在server上点Open Portal home打开主页后,用[e-mail]账户登录进去,点击左上角的'添加'按钮,到了加载Portlet的页面就不动了..一直显示加载中,但是在ie中打开就没问题,不知道怎么会事儿.我用的6.0.5版难道这个版本有问题...

5 楼 yangcaifeng_14 2010-09-02  

前人栽树，后人乘凉，谢了！

4 楼 空谷悠悠 2010-08-02  

LZ很用心哦！

3 楼 harbey 2010-07-27  

加油，支持原创！

2 楼 hu437 2010-07-27  

harbey 写道

哥们，快点发布啊！或者告诉我资源地址，谢谢！

资源地址？什么意思？

现在已经完成的部分，有些内容是参看了 liferay.com 上面的Wiki，然后又加入了很多自己的理解


公司里面一直在用liferay 4.2.2，这些文章是我自己学习liferay 6的一些记录，是原创。


如果你想自学可以去liferay.com的网站上看

1 楼 harbey 2010-07-27  

哥们，快点发布啊！或者告诉我资源地址，谢谢！