liferay6开发文档 别人的我来让大家免费下Word文档格式.docx
《liferay6开发文档 别人的我来让大家免费下Word文档格式.docx》由会员分享,可在线阅读,更多相关《liferay6开发文档 别人的我来让大家免费下Word文档格式.docx(14页珍藏版)》请在冰豆网上搜索。
下新建一个portal-ext.properties文件,内容如下(这里用mysql当作例子):
#
#MySQL
jdbc.default.driverClassName=com.mysql.jdbc.Driver
jdbc.default.url=jdbc:
mysql:
//localhost/lportal?
useUnicode=true&
characterEncoding=UTF-8&
useFastDateParsing=false
jdbc.default.username=root
jdbc.default.password=1234
其他数据库配置可以参见:
上面的配置仅仅只是liferay6.0之后的方法,与之前的版本还是有不同的,具体的各版本的数据库配置可以
参考:
3、在liferay-portal-tomcat-6.0.5/liferay-portal-6.0.5/tomcat-6.0.26/bin目录中执行startup.bat,
此时就已经启动tomcat了,一般会启动5分钟左右。
启动完毕后会自动在浏览器中打开
http:
//localhost:
8080,这样你就可以开始访问liferayportal了。
4、登录liferayPortal
在打开的浏览器中,点击右上角的login,输入帐号和密码。
在这里的输入的帐号密码为
email:
bruno@
password:
bruno
liferay从5.2之后的版本中都带有一个7cogs.inc公司的示例数据库,所以这里的管理员帐号密码如上。
如果删除示例数据库,则账号密码如下:
test@
test
5、删除7cogs例子
a、在tomcat/webapps下面找到目录sevencogs-hook这个目录,删除掉
b、在删除与tomcat平级的data/hsql目录
c、重启tomcat,这时的管理员帐号就变为test@
6、liferay启动的时候日志信息是乱码怎么办?
打开liferay-portal-tomcat-6.0.5/liferay-portal-6.0.5/tomcat-6.0.26/conf/目录下的logging.properties文件,加上一句java.util.logging.ConsoleHandler.encoding=gbk,重新启动就行了。
二、搭建liferay的开发环境
1、开发方式介绍
从6.0开始提供可eclipse可视化的插件之后就更加的友好,开发一个portlet或者一个hook都只需点点鼠标即可完成,这在官方wiki里面可以找到视频教程。
在准备开发之前需要先了解“portlet规范”,然后再看liferay6的开发指南,之后再看下面的内容。
Liferay6开发文档下载地址:
Portlet规范介绍文档下载地址:
2、首先需要下载liferay的sdk(开发环境包)、liferayide(开发环境的插件)。
sdk的下载地址:
liferayide下载地址:
安装此插件的时候eclipse要用3.6版本的。
在自己的工作目录解压sdk包liferay-plugins-sdk-6.0.5.zip、在eclipse中安装liferayide。
解压sdk后看到其目录结构如下:
有ext、hook、portlet等目录中放的是ext、hook、portlet以插件形式开发的文件。
要修改一下sdk目录下build.properties文件中运行环境目录,此处使用tomcat,所以修改大约76行修改为类似下的目录地址:
app.server.dir=D:
/liferay/liferay-portal-6.0.3/tomcat-6.0.26
以portlet为例子,里面有build.xml、build-common-portlet.xml、create.bat、create.sh、portlet.zip
这5个文件,不用说build.xml、build-common-portlet.xml是ant文件应该都知道,create脚本就是新建一个
插件工程,工程目录结构在portlet.zip中。
但是现在有了liferayide后就不用执行脚本创建了,而是直接用eclipse。
这里有liferayide的使用方法:
在使用liferayide的过程中需要配置sdk和与绑定tomcat的目录,这里就不做详细介绍了,就是路径的问题。
装完ide后的图示:
3、搭建完环境后新建一个liferaypluginproject,可以newportlet、Hook(扩展环境)、ext(扩展环境)、theme(主题)、layout(布局)类型的;
其中newPortlet和Hook的时候会得到liferayide的帮助,即自动生成一些配置文件,而且这两种扩展的目录结构相同都能热部署,所以hook和portlet
可以合并起来开发,它们在相同的目录结构下能够只能够覆盖jsp页面,java类和配置文件也只能覆盖部分,而且它们跟ROOT是分开的war包。
ext扩展环境更加灵活!
可以修改任何东西,但是ide不提供菜单方式,对于jsp页面可以在/docroot/WEB-INF/ext-web/docroot目录下可以创建与源码中相同
目录结构即可覆盖。
java类的目录则是创建工程的时候已经创建好的,例:
ext下的/docroot/WEB-INF/ext-impl/src目录对应源码中的/portal-impl/src目录。
如果我要修改源码中的LoginAction.java,那么我需要在/docroot/WEB-INF/ext-impl/src目录中新建com.liferay.portlet.login.action包(和源码中包名相同)。
源码中的一些配置文件都在/portal-web/docroot/WEB-INF/下,在ext中对应在/docroot/WEB-INF/ext-web/docroot/WEB-INF/目录下。
三、plugin项目的部署。
1、在liferay的根sdk目录中会发现build.properties配置文件,里面是一些关于配置web服务器的路径。
2、将其复制一份,改名为build.${username}.properties,这里的username即计算机的用户,可以在命令行中查看C:
\DocumentsandSettings\Administrator>
,我的是build.Administrator.properties。
3、修改build.Administrator.properties中的app.server.dir,把它修改成你tomcat的路径。
4、eclipse中配置刚才的sdk,然后newLiferayPluginProject,,之后找到在根目录下的build.xml,直接执行direct-deploy即可。
此时到/tomcat/webapps目录下会看到被部署过去的项目,部署其他类型的plugin也是如此。
5、启动tomcat即可。
四、配置文件之间的关系
在开发liferay的时候肯定一些原有的portlet是需要修改的,但是怎么能从页面中看到的那个portlet一直找到源码中你想要修改java类和jsp页面呢?
根据一段时间的研究发现这个方法,但是看起来很笨。
例如:
我要修改登陆时用到的portlet和页面,我是这样找到的portlet和jsp页面的。
1、在页面中“右键”--“查看源文件”,“Ctrl+F”搜索一下portlet的标题,即“signin”。
2、找到之后会发现标题上面有段代码<
sectionclass="
portlet"
id="
portlet_58“>
,可以确定这个portlet的id是47。
3、上面的id对应源码中的liferay-display.xml中portlet的id、对应portlet-custom.xml和liferay-portlet.xml中<
portlet-name>
标签的值。
4、找到portlet-custom.xml中对应的portlet后
<
init-param>
<
name>
view-action<
/name>
value>
/login/login<
/value>
<
/init-param>
其中/login/login即对应struts-config.xml中<
action>
的path属性值,从而可以找到其对应的java类。
5、<
forward>
的path属性值对应tiles-defs.xml中<
definition>
的name属性值,从而可以找到其对应的jsp页面。
ps:
关于tiles与struts1的配置可以参考。
五、自定义布局(layout)
1、在liferayide出来之前自定义布局都是在tpl(freemarker)文件中直接写代码,现在直接用可视化工具就能画布局。
先newLiferaylayoutTemplatePlug-inProject,打开生成的tpl文件可以用工具拖拽layout。
对于它的使用没什么难的,部署则跟上面讲的一样。
要么就在ROOT/layouttpl/custom中直新建tpl模板文件,之后在ROOT/WEB-INF/liferay-layout-templates.xml中配置。
2、可以查看tpl中生成的代码与liferay自带的模板文件做对比,找找规律其实挺简单的。
六、自定义主题(theme)
liferayportal中每个页面都可以设置不同的theme,在ROOT/html/themes/目录中每个文件夹就代表一个theme,liferay默认的theme就是基于_styled的,不过这个theme中的样式只是提供给portlet的,而默认使用的主题是classic,打开_classic可以看到其目录结构如下。
这里的_diffs目录是自定义theme最主要的,除_diffs之外的目录都是theme所需的资源目录。
如果你想要覆盖当前的theme的样式则可以在这个目录中创建与其他资源目录相同结构的目录、之后创建相同名字的文件就会覆盖。
或者直接改资源目录里的css文件、.vm文件也都可以。
1、自定义liferay的主题还是有两种方法,像自定义layout一样,一种是用liferayide,一种是直接在ROOT中改。
2、使用liferayide自定义主题。
首先NewLiferaythemePlug-inProject,工程中会出现_diffs目录,这时需要从ROOT/html/theme/classic中拷贝css、images、js、templates目录到工程中与_diffs同级。
现在等于拥有了跟classic一模一样的一套theme,如果想改动样式则在diffs中改,这样比较好维护,官方开发指南中建议只改custom.css文件,因为所有样式都在这个文件里面,之后部署即可。
3、直接在ROOT中自定义主题。
在ROOT/html/theme/中直接拷贝classic一份并改名为mytheme,然后在WEB-INF目录中修改liferay-look-and-feel.xml,新增mytheme的配置信息即可,需要修改样式同2中的方式即可。
4、关于页面中的布局、theme中的colorschemes、js的修改可以参考官方开发指南,还需要了解velocity的语法。
七、liferay提供的webservice
liferay对外提供的webservice地址http:
8080/tunnel-web/axis;
如果有需要的话可以调用。
八、配置文件的属性portal.properties
九、liferayportaldebug源代码
具体步骤如下:
将liferayportal源码导入eclipse编译,对着工程右键--》debugas--》debugconfigurations--》source选项卡
--》点右边add--》选择javaproject--》选择liferayportal源码的工程--》OK了。
以dubug模式启动liferay自带的tomcat,在源码的MainServlet中设置断点,用户每一次请求都会经过其service方法,这样就能
看到效果了。
----byliuyake