Liferay 6开发学习(二十四):Liferay开发模式介绍

2014年01月13日 Liferay 评论 8 条 阅读 14,596 views 次

(最近半年有点懒惰了,博客的更新频率明显降低了许多,以后尽量的多更新~)

在Liferay IDE 2.0中我们创建Liferay插件工程的时候,有以下几个选项:

  • Portlet
  • Service Builder Portlet
  • Hook
  • Layout Template
  • Theme
  • Ext

这是Liferay提供的几种插件模式,还有一种直接基于源码的开发,本篇文章即为介绍这几种模式的差异,我们在什么样的情况下选择哪种模式更合适,这里只所以说更合适是因为选择什么样的开发模式,并不是非此即彼,在实际中我们可以组件使用。

在《Liferay 6.1开发学习(二):创建一个Portlet工程》这篇博客中,对这些模式有过一个大概的介绍,本篇进行一个详细的扩充说明。

Portlet

当我们在Liferay之上进行二次开发,是根据自己的业务需要开发Portlet时,一般选择此模式,也就是普通的插件工程,如果一般没有特殊说明,我们在讨论Liferay插件工程时,即指的此种模式。

在此种模式中我们可以加入Struts框架支持(Struts1、Struts2)、Spring MVC、JSF等支持JSR168和JSR286标准的MVC框架,同时也可以加入hibernate、Spring、CXF等其他后台业务框架。

整个Portlet工程的结构很类似一个标准的Java Web工程,在此工程的代码逻辑等部分,除了展现层,也即MVC框架支持的层面,其他层面的代码(比如Service层、Dao层)和普通的Java Web的处理逻辑都是一样的。

Service Builder Portlet

这个模式是在Liferay IDE 2.0里面才新加的,其实也不是一个新东西,和第一个Portlet模式基本无差异,差异地方就在于使用此模式建立Portlet插件工程时,会在WEB-INF生成一个Service.xml的文件。在第一种Portlet里面,我们也可以加入这个文件。

Hook

关于Hook工程的介绍请参考这篇博客《Liferay 6.1开发学习(九):Hook开发简介》,在这篇文章里面对Hook做了一个大概的介绍。那我们什么情况下选择使用Hook呢?

1、当我们对Liferay本身提供的一些功能想做微小调整的时候,这个是最大的前提,也就是需要对Liferay进行微小的调整,如果是进行大面积的调整时,则一般使用ext或直接基于源码开发。

2、当我们想修改Liferay本身的一些界面上的字样、文字的摆放位置、页面的排版等;

3、当我们对Liferay本身的一些翻译不太满意的时候;

4、当我们对Liferay自带功能(博客、文件媒体库、wiki等)的业务处理逻辑不太满意的时候;

5、当我们对Liferay一些事件处理过程(比如登录前事件、登录后事件、系统初始化前、系统初始化后)想做调整的时候;

以上这些情况都可以使用Hook,举几个实例:

1、我们对登录界面不满意,想做一些个性化的定制,这个时候就可以使用hook来覆盖登录portlet里面的登录界面的JSP即可;

2、比如我们想在Liferay里面加入百度统计(默认只支持google的统计,和6.2加入的pwiki),就可以hook在top_js.jsp,在里面加入相应的百度统计代码即可;

3、比如我们想控制用户登录后的页面跳转逻辑,我们使用hook来覆盖登录后事件即可;

4、比如我们想对验证逻辑进行一些调整,如支持无论用户输入用户ID、屏幕名称、email都可以登录(默认是只能配置一个),这个时候我也们可以hook一下UserLocalService即可;

5、比如我们想在Liferay里面全局引入jquery或者其他的JS框架,也同样的使用hook;

6、比如我们想让Liferay文件媒体库里面文件下载之后带上版本号,我们也可以hook文档管理的Service;;

7、比如我们想在Liferay启动的时候,放一些信息到request里面,我们可以hook初始化前事件。

8、……等等;

Layout Template

这个类型为布局模板,也就是开发我们的Portlet有几行几列的布局。请参考《Liferay 6.1开发学习(七):Layout布局模板开发》,由于这部分比较简单,不再重复。

Theme

Theme也就是我们说的主题开发,如果我们想让Liferay变个样子,或者是想让Liferay运行起来达到我们的界面设计人员所设计的界面,就需要借助于主题。

1、比如经常有人问的,怎么去掉页面下方的“技术支持 Liferay”等,这就可以在主题的portal_normal.vm里面进行修改;

2、比如我们想让dockbar根据不同的角色来显示或者是直接隐藏掉,也可以在Portal_normal.vm里面进行调整。

3、比如我们想定制导航条的显示效果、背景颜色、按钮形状、tab的样式等等都是在Theme里面实现。

总而言之,如果是想让Liferay换个样子,我们就借助于主题。关于主题详细介绍,同样的也参看之前写的《Liferay 6.1开发学习(八):主题开发》。

Ext

在Liferay的早期开发中,主要采用Ext的模式,在Ext模式中我们可以对Liferay进行任意的修改和调整,覆盖Liferay自身的任何类、方法、JS、JSP、css等,上面的几种模式的开发,我们在Ext模式里面都能够实现。

使用Hook能够实现的功能,我们使用Ext模式全部都可以做,但反过来就不可以,也就是Ext能做的事情,Hook不一定能做得了。

那Ext与Hook的明显差异在哪呢?

1、hook工程部署之后不需要重启,ext必须重启应用才会生效;

2、Ext可以覆盖Liferay所有的类,而hook对类的覆盖调整,是基于代理或一些接口来实现的;Ext是直接按原路径覆盖,在类加载的时候根据配置文件,加载相应的ext下面的类;

3、Ext模式相对来说会比较重,而且有较强的入侵性,会在Liferay的Root目录下面复制许多的文件进去;

那什么时候采用Ext,什么时候采用Hook呢?

1、在要修改的内容不多的前提下,我们优先选用Hook,如果Hook不能满足需求,再选用Ext;

2、当我们要修改的内容稍多,只是修改,不涉及对源码的删除时,采用ext;

3、当我们需要调用portal-impl里面的类,或者对这里面的方法进行修改的时候,采用Ext;

4、发现了Liferay的一些影响项目进行的bug,可以采用ext进行修复(其实也就是上面的1的内容,对源码修改的内容不多,同时hook又不能满足需求)。

基于源码开发

最不推荐的模式为直接基于源码开发,源码的编译调试,可以参考这篇文章《Liferay 6.1开发学习(五):编译调试修改源码》。有以下情况时推荐采用基于源码的开发模式:

1、对Liferay进行裁剪,删除自带的Portlet,相关类等;

2、对Liferay本身的功能进行大面积的修改调整。

实际中一般不推荐基于源码的开发,原因有以下几点:

1、工作量比较大,同时需要一个对Liferay的源码结构有一定了解的人;

2、调整源码可能带来一些不确定的Bug;

3、比如现在是对Liferay6.2.0的源码进行了大量的修改,明天Liferay发布了7.0版本,这个时候想升级是很困难的;

总结

在这些开发模式中,前五种基本上是平级的,一般考虑的顺序为Portlet=Theme=Hook>Ext>基于源码的开发。在实际的项目中,一个稍大点的项目上面的开发模式,除了基于源码的开发,其他的一般都会用到。

比如在我们的项目中一般会存在:

1、多个Portlet工程:按大的模块拆分工程,一个Portlet工程下面包含多个portlet。

2、两个theme工程:一个前台主题、一个后台主题。

3、一个Hook工程:用来对一些内容进行Hook,比如登录、引入JS、一些业务逻辑调整、翻译调整等。

4、一个Ext工程(根据实际情况而言,此工程也不是必须的):对一些Liferay本身的功能进行调整,以更方便项目的进行;

可能有同学问了,那这样一个项目下来,岂不是有五六个工程?能不能合成一个呢?当然是可以的,我们可以直接将这些功能都合并到Portlet工程或者theme工程里面。但是一般还是推荐将这些分工,以方便维护。

用户头像

8 条留言  访客:7 条  博主:1 条

  1. 你好.有liferay portal 单点登录的例子吗?

  2. 具体怎么开发咯,怎么把liferay-portal源码导进来eclipse咯

  3. Sass::SyntaxError: File to import not found or unreadable: mixins.
    liferay 6.2 我把ROOT下的jar放到tomcat lib->ext 下后就报错了。
    Sass::SyntaxError: File to import not found or unreadable: mixins.
    Load paths:
    C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/lib/ext/util-java.jar!/html/css/common
    C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/webapps/ROOT/html/themes/classic/css
    C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/lib/ext/util-java.jar!/sass
    C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/temp/liferay/ruby/gems/compass-0.12.2/frameworks/blueprint/stylesheets
    C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/temp/liferay/ruby/gems/compass-0.12.2/frameworks/compass/stylesheets
    Compass::SpriteImporter
    import at C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/temp/liferay/ruby/gems/sass-3.2.12/lib/sass/../sass/tree/import_node.rb:67
    import at C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/temp/liferay/ruby/gems/sass-3.2.12/lib/sass/../sass/tree/import_node.rb:65
    imported_file at C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/temp/liferay/ruby/gems/sass-3.2.12/lib/sass/../sass/tree/import_node.rb:28
    css_import? at C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/temp/liferay/ruby/gems/sass-3.2.12/lib/sass/../sass/tree/import_node.rb:36
    visit_import at C:/liferay/develop toos/liferay-portal-6.2-ce-ga4/tomcat-7.0.42/temp/liferay/ruby/gems/sass-3.2.12/lib/sass/../sass/tree/visitors/perform.rb:217
    send at org/jruby/RubyKernel.java:2097

  4. 胡大:
    我看这里有提到 liferay中加入百度统计,是通过hook来实现的.
    请问,咱们liferay自己有实现这种功能吗?

    • avatar 胡启稳

      liferay本身是国外的嘛,内置是没有支持百度统计的,需要我们自己做一点稍微的修改。方法主要有两种:
      1、是采用hook,来自己修改top_js.jspf文件。
      2、是在自己写的theme里面加入百度统计的相关代码。

      • 胡少帅,我是想问,liferay有自己的记录统计用户访问记录的功能吗?
        而不是liferay加入百度统计google统计.

  5. 胡大,
    我是想问,liferay有自己的记录统计用户访问记录的功能吗?
    而不是liferay加入百度统计google统计.

  6. 我在custom.css里面修改了样式,但是为什么没有效果,

给我留言

您必须 登录 才能发表留言!

Copyright © IT人生录 保留所有权利.   主题设计 知更鸟 滇ICP备16001547号

用户登录

分享到: