久久久久亚洲AV成人无码,亚洲国产成人高清在线观看 ,国产亚洲?V无码?V男人的天堂

��L��q�行Java Portlets--开发基于JSR 168的开发和部��v(�?

junky — Fri, 15 Jun 2007 02:39:00 GMT

　　Portlet是生成片�D�（遵守特定规范的标记语�a��Q�如HTML、XML�Q�的片段�Q�的Web�l��g。片�D�再合成一个完整的文档。本文介�l�了关于Java Portlet的Java Specification Request (JSR) 168规范。它说明了如何��用BEA WebLogic Workshop 8.1 SP2来创建Java Portlet�Q�以及如何将�q�些portlet部��v到BEA WebLogic Portal 8.1 Sp2上。我��介�l�一些关键概念，如门戗��桌面和portlet�Q��ƈ详细描述多种portlet模式和窗口状态。我�q�将介绍如何使用Workshop来设计、实现、配�|�和执行portlet�?br>

　　JSR 168定义了有关Java Portlet的规范。门��h��一个Web应用�E�序和一个portlet的聚合。Portlet容器�q�行portlet�Q��ƈ��理它们的生命周期。JSR 168定义了portlet与portlet容器之间的契�U�，它没有定义portlet容器与门户之间的契约。门��L��实现留给了门户供应商�?br>
　　BEA WebLogic门户
　　BEA WebLogic Portal (8.1 SP2)的当前版本支持不同类型的portlet�Q�JSP/HTML portlet、Java PageFlow portlet、Struts portlet和Java portlet�Q�将来还会支持其他portlet�Q�如Web Services for Remote Portlets (WSRP)。我们将着重介�l�Java portlet�?br>
　　WebLogic Portal提供了JSR 168中未描述的门户功能，包括但不限于�Q�书和页面中portlet的组�l�、多渠道支持和��用skin、skeleton和shell定制�?br>
　　��Z��能够�l�箋下去�Q�在�q�行下一部分之前�Q�请先完成以下内容：
　　　·使用WebLogic Domain Configuration Wizard创徏一个门户域�Q�如JSR168PortalDomain�Q��?
　　　·使用WebLogic Workshop创徏一个��用上面所建立域的门户应用�E�序�Q�如JSR168PortalApp�Q��?
　　　·在门户应用程序内创徏一个门户Web��目�Q�如JSR168PortalWebProject�Q��?
　　　·在门户Web��目中创��Z��个WebLogic Portal .portal文�g�Q�如JSR168.portal�Q��?
　　　·启动服务器实例�?

　　创徏您的�W�一个Java Portlet
　　下面的步骤描�q�C��如何创徏您的�W�一个JSR 168 portlet�?br>　　·在门户Web��目�Q�如JSR168PortalWebProject�Q�中�Q��用WebLogic Workshop为portlet�Q�入FirstPortlet�Q�创��Z��个新文�g夏V�?
　　·在新文�g夹内使用Wizard通过创徏相应�?portlet文�g创徏一个新portlet�Q�如Firstportlet�Q��?br>　　·选择portlet�c�d��为Java Portlet�?
　　·指定标题�Q�如First�Q��?
　　·指定定义标签�Q�如first�Q��?br>　　·指定�c�d��U�ͼ�如com.malani.examples.portlets.jsr168.FirstPortlet�Q��?
　　·打开门户�Q�如JSR168.portal�Q��?
　　·��portlet�Q�如Firstportlet�Q�拖攑ֈ�门户中的��面上（如JSR168.portal�Q��?
　　·�q�行.portal文�g�q�行��试�?

　　您的�W�一个JSR 168 portlet已经成功�q�行了！但向导在背后作了些什么呢�Q?br>　　·它创��Z��一个特定于WebLogic Workshop和WebLogic Portal�?portlet文�g�?portlet文�g构成了与特定于Workshop和WebLogic Portal�?portal文�g的契�U��?
　　·向导创徏了一�?java文�g�Q�如com.malani.examples.portlets.jsr168.FirstPortlet.java�Q�，该文件放�|�在WEB-INF/src目录中�?br>　　·向导创徏了一个WEB-INF/portlet.xml配置文�g�Q��ƈ为portlet在文件中插入了一个条目。该portlet的条目看上去如下�Q?br>

Description goes here
first
com.malani.examples.portlets.jsr168.FirstPortlet

First

　　Java Portlet�c?/strong>
　　在该�C�Z��中，向导生成的Portlet Java文�g扩展了javax.portlet.GenericPortlet�c�R��GenericPortlet�c�d��C��javax.portlet.Portlet接口。图1是一个Unified Modeling Language (UML)�c�d��Q�描�q�C��q�些关系。通过直接实现portlet接口�Q�可以编写一个portlet。然而，GenericPortlet是一个创建portlet的更方便�Ҏ��。首先，我们看一下portlet生命周期、portlet模式和window状态�?

�?1

　　Portlet生命周期
　　��Z��成功地创建portlet�Q�您必须�늅�portlet生命周期。javax.portlet.Portlet接口中的�Ҏ��定义了该生命周期�Q�这些生命周期方法是init()、render()、processAction()和destroy()。当部��vportlet的实例时调用init()�Ҏ��。它用于获得所需的�Q何昂贵资源（如后台连接）�Q��ƈ执行其他一�ơ性活动。当portlet的实例被撤销部��v�Ӟ��使用destroy()�Ҏ��来释放这些资源�?br>
　　Portlet规范清晰区别render��h��和动作请求。图2描述了portlet��h��和响应的一个UML�c�d��。门户页面上的render��h��会导致对所��面上的每个portlet上调用render()�Ҏ��Q�当用户在特定portlet上调用某个动作（通常是HTML表单提交�Q�时�Q�将会调用该portlet的processAction()�Ҏ��。这��P��用户的动作请求�{换�ؓprocessAction()�Ҏ��的一�ơ调用和render()�Ҏ��的多�ơ调用�?/p>

�?2

　　�?是一个序列图�Q�说明了调用processAction()�Ҏ��的效果，以及为同一��面上的portlet�q�行后箋render()�Ҏ��的调用。关于更多信息，请参阅关于处理动作的一节�?/p>

�?3

　　有两�U�重载的init()�Ҏ��Q�一个没有参敎ͼ�另一个有一个javax.portlet.PortletConfig�cȝ��实例。注意：关于init(PortletConfig)有一个特�D�的caveat。调用super.init(aPortletConfig)��p�|��导致一个NullPointerException。所包含的源代码�C�Z��中的Init portlet说明了这�U�行为（源代码可以在www.sys-con.com/weblogic/source.cfm中找刎ͼ��?br>
　　Portlet模式
　　JSR 168定义了三�U�Portlet模式�Q�VIEW、EDIT和HELP。一个portlet实例在�Q何时候都可以恰��y在一�U�　portlet模式下。其他自定义portlet模式�Q�如配置和源�Q�都是可能的。VIEW模式是默认的模式。Portlet规范��EDIT模式允许portlet用户定制portlet实例�Q�以及HELP模式昄��关于portlet的用法信息。Portlet必须支持VIEW模式�Q�但在portlet中对EDIT模式和HELP模式的支持是可选的。例如，portlet First portlet�C�Z��不支持EDIT模式和HELP模式�?br>
　　window状�?/strong>
　　JSR 168定义了三�U�Window状态：NORMAL、MINIMIZED和MAXIMIZED。Portlet实例��M��时候都可以恰好是一�U�window状态。其他自定义window状态（如半��）也是可能的。在NORMAL状态下�Q�portlet占了屏幕区的一��部分。屏�q�状态与其他portlet�׃�n。在MINIMIZED状态下�Q�portlet的内容被隐藏。在MAXIMIZED状态下�Q�portlet的内容占屏幕区的大部分。其他共享同一��面的portlet在MAXIMIZED状态下被隐藏。例如，portlet First�C�Z��支持所有三�U�window状态�?br>
　　GenericPortlet�c?/strong>
　　您创建的大多数portlet��会扩展javax.portlet.GenericPortlet�c�，而不是直接实现javax.portlet.Portlet接口。GenericPortlet�c�d��C��render()�Ҏ��。如果portlet的window状态被最��化�Q�那么render()�Ҏ��不能做�Q何事情。如果portlet的window状态不是最��化�Q�那么render()�Ҏ��讄��在portlet.xml文�g中指定的标题�Q��ƈ调用doDispatch()�Ҏ��。根据Portlet模式�Q?doDispatch()�Ҏ��适当地调用doView()、doEdit()和doHelp()�Ҏ��。这��P��׃��GenericPortlet�c�d��助实现render()�Ҏ��Q��ƈ且提供doView()、doEdit()和doHelp()�Ҏ��来覆盖，因此GenericPortlet�c�L��Portlet接口更便于扩展�?

　　考虑一下First portlet�C�Z��。FirstPortlet�c�L��展了GenericPortlet�Q�FirstPortlet改写了doView()�Ҏ��?br>
public void doView(RenderRequest request, RenderResponse response)
throws PortletException, IOException
{
response.setContentType("text/html");
response.getWriter().write("
Hello World
");
}

　　注意�Q�调用setContentType()�Ҏ��前调用getWriter()�Ҏ��会导致java.lang.IllegalStateException�?br>
　　实现Portlet模式
　　VIEW模式是强制的�Q�但EDIT和HELP模式是可选的。�ؓ了实现EDIT和HELP portlet模式�Q�需要在portlet�c�M��实现适当的doEdit()和doHelp()�Ҏ��。请参考包含在源代码示例（本文的源代码可以在www.sys-con.com/wldj/sourcec.cfm扑ֈ��Q�中的portlet Mode。此外，必须在portlet.xml中如下配�|�各模式�Q?br>

text/html
edit
help

　　注意�Q�修改portlet.xml配置文�g�Q�但不实现portlet�c�M��的相应方法，会导致javax.portlet.PortletException�?br>
　　实现window状�?/strong>
　　JSR 168没有描述��用window状态支持的�Ҏ��。然而，WebLogic Portal实现了对它们的禁用。�ؓ了禁用portlet对window状态的支持�Q�需要在weblogic-portlet.xml文�g中排除window状态：

state

text/html
minimized
maximized

　　请参考源代码�C�Z��中的portlet State�?br>
　　包含JavaServer Pages (JSPs)
　　考虑portlet First的doView()�Ҏ��Q�该�Ҏ��获得了Writer的实例，�q�直接输出HTML片段。由于多�U�原因（如�ؓ了达到Java逻辑与HTML视图表现的分��）�Q�往往不推荐输出直接的HTML片段。推荐的�Ҏ��是��用JSP来显�C��图。portlet�c�M��的方法执行业务逻辑、设�|�render参数以及包含JSP。�ؓ了包含一个特定的JSP�Q�应首先获得PortletContext。从PortletContext实例中，通过调用getRequestDispatcher()�Ҏ��获得一个PortletRequestDispatcher的实例。通过调用include()�Ҏ��来包含JSP。例如：

// execute the necessary logic here...
PortletRequestDispatcher aDispatcher =
getPortletContext().getRequestDispatcher(
"/IncludePortlet/includeView.jsp"
);
aDispatcher.include(aRequest, aResponse);

　　注意�Q�在执行render()�Ҏ��Ӟ��portlet可能只��用一个PortletRequestDispatcher对象�?br>　　请参考包含在源代码中的portlet Include。JSP��面�Q�如includeView.jsp�Q�不包含根HTML标签�Q�如�?lt;title>�?lt;body>�Q�，因�ؓ�q�些标签由门��h��架提供。JSP��面只包含显�C�portlet所必需的HTML片段�?br>
　　处理动作
　　在一个标准的Web应用�E�序中，一个HTML表单提交��导致执行一些业务逻辑。业务处理的�l�果�Q�要么作为属性而被讄��在请求或会话中�ƈ转发�Q�要么包含到下一个JSP�?br>
　　在一个JSR 168 portlet中，一个HTML表单的动作URL应该是什么样呢？JSR 168定义了一个JSP标签库，�U�Cؓportlet taglib。HTML表单的动作URL可以使用actionURL portlet标签生成。例如（请参考favoriteColorEdit.jsp文�g�Q�：

...

　　提交该HTML表单��会��D��调用portlet的processAction(ActionRequest aRequest, ActionResponse aResponse)�Ҏ��。像通常一��P��可以通过调用request对象的getParameter()�Ҏ��来获得表单参数。注意：通过提交表单调用动作�Q�但portlet中却没有processAction()�Ҏ��Q�将会导致javax.portlet.PortletException�?br>
　　processAction()�Ҏ��讄��response对象中的倹{��不要��用ActionRequest或ActionResponse对象的setAttribute()�Ҏ��。��g��会从processAction()传递到render()�Ҏ��Q�而且在JSP中是不可用的。相反要使用ActionResponse对象的setRenderParameter()�Ҏ��。这些render参数��对所有后�l�render��h��可用�Q�这一点与典型的Web应用�E�序��h��属性很不相同。典型的Web application��h��属性只对于一个请求可用。另一斚w��Q�render��h��参数对于许多后箋render��h��可用。render参数保持可用直到��D��动作的重新执行显式地修改或删除�?br>
　　考虑portlet FavoriteColor。它在VIEW模式昄��了一个用户偏好的颜色�Q�但是可以在EDIT模式下更攏V��在EDIT模式下提交偏好的颜色选择��调用processAction()�Ҏ��。该�Ҏ��获得偏好的颜色请求参敎ͼ��q�将其设�|��ؓrender参数。这��P��偏好的的颜色render参数��在所有后�l�render��h��中都可用�?br>
　　所呈现的参数是怎样昄��在JSP上的呢？应��用来自portlet标签库的defineObjects标签来定义portlet对象。该标签使renderRequest、renderResponse和portletConfig portlet对象在页面中可用。参数通过调用renderRequest对象的getParameter()�Ҏ��来显�C�。请参考与所包含的源代码�C�Z��中的favoriteColorView.jsp�?br>
　　portlet FavoriteColor也展�C�Z��其他概念。第一个是如何在processAction()�Ҏ��中用�~�程的方法改变portlet模式。调用ActionResponse对象的setPortletMode()�Ҏ��来修改portlet模式。第二个概念是如何��用一个HTML链接来修改portlet模式。该链接使用来自portlet标签库的renderURL标签生成。根据希望的portlet模式指定portletMode属性的倹{��请参考源代码�C�Z��中的FavoriteColorPortlet�c�d��favoriteColorView.jsp��面�?

　　Portlet Preferences
　　Portlet Preferences�Q�Portlet首选项�Q�是portlet的基本配�|�数据。一个preference是一�?#8220;名称和�?#8221;寏V��名�U�的�c�d��是一个字�W�串�Q�而值的�c�d��是字�W�串或字�W�串数组。Portlet Preference不适于存储��L��数据。portlet容器为portlet preferences提供持久性。在WebLogic Portal中，preference的持久性只在下面两个条仉��为真时才起作用：
　　·门户�q�行在桌面中�Q�而不是DOT门户模式�?br>　　·用户已经��d��?br>
　　桌面与DOT门户模式
　　在WebLogic Workshop中创�?portal文�g�Ӟ��像书、页面和portlet�{�项都可以被拖放�?portal文�g中，.portal文�g能够直接从Workshop内运行。然而，某些功能�Q�如preferences的存储，在这�U�DOT门户模式下运行时是不可用的（DOT门户模式也称为单文�g模式�Q�Single File Mode�Q�）�?

　　其他模式�U�Cؓ桌面模式。创��Z��个门��h��使用Portal Administrator。在门户内，一个桌面被创徏。像图书、页面和portlet�{�项被创建，�q�放�|�在桌面中。在�q�种模式下，某些功能�Q�像preferences的存储，是可用的�Q�桌面模式也被称为流模式�Q�Streamed Mode�Q�）�?br>
在��l�讨论前�Q�先创徏一个桌面：
　　启动Portal Administration�Q�譬如，http://localhost:7001/JSR168PortalAppAdmin/�Q�。一�U�启动Portal Administration的方法是直接从Workshop中启动。选择Portal菜单�Q�选中Portal Administration菜单��V�?
　　·��d��q�Portal Administration�?br>　　·创徏一个新门户�Q�譬如，JSR168�Q��?
　　·在门户中�Q�创��Z��个新桌面�Q�如d1�Q��?
　　·��LoginPortlet��d��到桌面的一个页面中�?
　　·��ContactPortlet��d��到桌面的一个文件中�?

　　Portlet Preferences�C�Z��
　　Contact portlet演示了Portlet Preferences。Portlet Preferences可以是静态的或动态的。静�?preferences与portlet一起在portal.xml文�g中指定。例如，ContactPortlet��h��一个成为contact-preference�?preferences。contact-preference的默认��g��被指定：

contact-preference
Email

　　动�?preferences不在portlet.xml配置文�g中预定义。当portlet�q�行�Ӟ��q�些preferences被存储和��d��。在�q�行期间�Q�一个javax.portlet.PortletPreferences接口的实例包含这些preferences。该实例通过调用PortletRequest对象的getPreferences()�Ҏ��获得。特定preferences的值通过调用preferences实例上的getValue()�Ҏ��来获得�?

　　调用preferences实例的setValue()�Ҏ��会更��C��个preferences倹{��然而，需要一个额外的步骤来提交这些修攏V��preferences实例的store()�Ҏ��被调用来使preferences持久化。preferences只能在processAction()�Ҏ��中进行修攏V��如果在processAction()�Ҏ��中没有调用store()�Ҏ��Q��Q何对preferences实例的修攚w��会被丢弃。注意：��如前面提到的，如果用户没有��d��或门户处于DOT门户模式�Q�那么调用store()�Ҏ��会��D��一个运行时异常�?br>
　　在portlet和servlet之间有很多相似点。然而，它们也存在着重要区别。portlet规范建立在servlet规范之上。portlet容器存在于servlet容器中。就像servlet部��v在一个Web应用�E�序中，portlet也是如此。Servlet和Web应用�E�序使用portlet.xml文�g�q�行配置。一个servlet��h��昑ּ�的生命周期：init()、doGet()、doPost()�{�。类似地�Q�一个portlet也具有显式的生命周期�Q�doView()、doEdit()、processAction()�{�。servlet和portlet�cȝ��Ҏ��必须以安全线�E�的方式�~�码�?br>
　　然而，也存在着重要的区别。Servlet被允许进行include、forward和redirect操作�Q�然而portlet只被允许�q�行include操作。Servlet能够呈现一个完整的��面�Q�但portlet只提交页面片�D�c��portlet��h��严格定义的portlet模式和Window状态，�q�方面不像servlet。Portlet��h��更正式的��h��Q�对render��h��和动作请求进行处理，它们也具有preferences。portlet�q�不是servlet�Q?br>
　　�l�束�?/strong>
　　本文通过使用一个简单的向导描述portlet的创��开始，�q�说明了portlet的生命周期以及portlet�c�d��现的内部工作方式�Q�描�q�C��portlet.xml配置文�g和相应的weblogic-portlet.xml配置文�g的结构和语义。对各种概念�Q�如portlet模式和window状态，本文也进行了解释。本文演�C�Z��portlet标签库的用法和portlet中的表单处理。最后，我介�l�了如何使用portletpreferences。理解了本文所介绍的这些知识和概念�Q�您��可以在创徏和部�|�自��q��强大portlet的道路上前进了�?br>
　　致谢
　　感谢Subbu Allamaraju、Max Cooper、Steve Ditlinger、David Lu、Roshni Malani和Alex Toussaint�Q�他们仔�l�阅��M��q�篇文章�Q��ƈ提供了有价值的反馈意见�?br>
　　参考资�?/strong>
　　· 要讨��文章、�ƈ提问问题�Q�从�q�里开始： www.bartssandbox.com。需要免�Ҏ��员资根{�?
　　· 下蝲、阅读JSR 168�Q?a target=_blank>www.jcp.org/en/jsr/detail?id=168
　　· WebLogic Portal文档的�v始点�Q?a target=_blank>e-docs.bea.com/wlp/docs81/index.html
　　· 建立Workshop Help的Java Portlet部分�Q?a target=_blank>e-docs.bea.com/workshop/docs81/doc/en/core/index.html
　　· 用WebLogic Portal 8.1开发JSR 168 Portlet�Q?a target=_blank>dev2dev.bea.com/products/wlportal81/articles/JSR168.jsp
　　· Web Services for Remote Portlets (WSRP)规范�Q?a target=_blank>www.oasis-open.org/committees/tc_home.php?wg_abbrev=wsrp
　　· ��试一下WSRP�Q?a target=_blank>dev2dev.bea.com/codelibrary/code/wsrp_supportkit.jsp
　　· Single File Mode和Streamed Rendering Mode�Q?a target=_blank>单击�q�里�Q?br>　　· 有关Portlet规范上的文章�Q?br>- 介绍Portlet规范�Q�第1部分�Q?br>www.javaworld.com/javaworld/jw-08-2003/jw-0801-portlet_p.html
-介绍Portlet规范�Q�第2部分�Q?br>www.javaworld.com/javaworld/jw-09-2003/jw-0905-portlet2_p.html
　　· 对JSR 168白皮书的介绍�Q�单击这里！
　　· Java Passion Portlet演讲�W�记�Q?a target=_blank>www.javapassion.com/j2eeadvanced/Portlet4.pdf

　　源代�?/strong>
　　源代�?Zip文�g
　　英文原文�Q?a target=_blank>http://www.sys-con.com/story/?storyid=45565&DE=1

作者简�?/span>

Prakash Malani Prakash Malani 在架构、设计和开发��Y件方面经验丰富。他在许多应用领域从事过软�g开发，比如�׃��、金融、零售、医学、通信和交互式电视。他喜欢实践和研�I�先�q�的技术，比如Java 2 Enterprise Edition (J2EE)、Unified Modeling Language (UML)和eXtensible Markup Language (XML)。他�q�在加利��尼亚州立理工大学�L莫那校区�{�机构讲授最佛_��践和设计模式。他在业界的著名出版物上发表�q�许多文章，比如JavaWorld和WebLogic Developers Journal。当前，他正在帮助组�l�Los Angeles BEA Users Group (LABEAUG)�?/td>

作者其它文�?/span>

WebLogic域配�|�策�?/a>
BeanUtils: 威力和代�?/a>
配置weblogic 8.1和hibernate 3.0 �W�一部分
配置WebLogic 8.1和Hibernate 3.0�Q�第二部�?/a>
使用面向斚w��~�程(AOP)实现Gang of Four (GoF)设计模式
是否要��用门户代替POWA来开发web应用�E�序�Q?/a>

junky 2007-06-15 10:39 发表评论

junky — Wed, 06 Jun 2007 05:50:00 GMT

HOWTO�Q?/span>liferay权限开发（一�Q?/span>

权限控制�?/span>liferay4.0以后增加的新�Ҏ��。在liferay中开发权限是一件很�Ҏ��的事情，基本上都是通过定义xml来实现�?/span>

首先�Q�我们来看看�l�自��q��portlet加上权限控制�Q�主要要完成以下四步操作�Q?/span>DRAC�Q?/span>:

1. Define all resources and their permissions.

先定义所有所需要的权限�Q�包�?/span>portlet resource�?/span>model resource�Q?/span>

2. For all the resources defined in step 1, register them into the permission system. This is also known

simply as “adding resources.”

当定义完权限后，我们需要把权限的定义注册到权限�pȝ��中，��x��权限相关信息保存到数据库�?/span>

3. Associate the necessary permissions to these resources.

把所需�?/span>permission兌��?/span>resources�?/span>

4. Check permission before returning resources.

在相应的位置加上权限��验的�Ҏ��

在解析上面四个步骤以前，有两个定义是非常重要的：

1�Q?span>               Resource�Q�在portal�pȝ��中，可以��单的认�ؓResource是一个个可以操作的实体对象。�D个例子：一�?/span>resources包括portlets�Q�如�Q?/span>Message Boards�Q?/span>Calendar�Q?/span> etc�Q�，java�c�（如：Message Board Topics�Q?/span>Calendar Events�Q?/span> etc�Q�还�?/span>flies�Q�如�Q?/span>documents�Q?/span>images�Q?/span>etc�Q?/span>

2�Q?span>               Permission�Q�一个个可运行的权限动作�Q�都已经�?/span>resourcez中定义了。�D个例子：“查看calendar�?/span>portlet”�q�个权限动作已经通过resource�?/span>liferay的权限系�l�中定义

下面来简单解析一下开发权限的四个步骤�Q?/span>

一�Q?/span>Defining Resources and Actions

       默认的权限定义的xml文�g�?/span>portal/portal-ejb/classes/resource-actions�?/span>

我们来看�?/span>calendar的权限定�?/span>

xml 代码

<resource-action-mapping>

    <portlet-resource>

       <portlet-name>8portlet-name>

       <supports>

           <action-key>ADD_EVENTaction-key>

           <action-key>CONFIGURATIONaction-key>

           <action-key>VIEWaction-key>

       supports>

       <community-defaults>

           <action-key>VIEWaction-key>

        community-defaults>

       <guest-defaults>

           <action-key>VIEWaction-key>

       guest-defaults>

       <guest-unsupported>

           <action-key>ADD_EVENTaction-key>

       guest-unsupported>

    portlet-resource>

    <model-resource>

       <model-name>com.liferay.portlet.calendar.model.CalEventmodel-name>

       <portlet-ref>

           <portlet-name>8portlet-name>

       portlet-ref>

       <supports>

           <action-key>DELETEaction-key>

           <action-key>PERMISSIONSaction-key>

           <action-key>UPDATEaction-key>

           <action-key>VIEWaction-key>

        supports>

       <community-defaults>

           <action-key>VIEWaction-key>

       community-defaults>

       <guest-defaults>

           <action-key>VIEWaction-key>

       guest-defaults>

       <guest-unsupported>

           <action-key>UPDATEaction-key>

       guest-unsupported>

    model-resource>

resource-action-mapping>


首先�Q�我们的权限定义�?/span>root Element�?/span><resource-action-mapping>�Q�所有的权限定义都必��d��含在里面

接着�Q�我们可以看�?/span>liferay的权限定义分<portlet-resource>�?/span><model-resource>两种�Q?/span>portlet-resource中定义的�Q�我们可以在�q�里看到�Q?/span>

主要可以控制portlet的查看，配置权限�Q�还有就是可以控制按钮一�c�设�|�的权限

model-resource的权限控制到每条记录�?/span>

xml 代码

<community-defaults>

           <action-key>VIEWaction-key>

community-defaults>

�q�里告诉我们当一�?span>community拥有�q�个portlet的时候所��h��的权限�?/span>

<guest-defaults>

           <action-key>VIEWaction-key>

guest-defaults>

�?/span>guest用户可以看到�q�个portlet的时候默认具有的权限�Q�这里都为查看�?/span>

<guest-unsupported>

           <action-key>ADD_EVENTaction-key>

guest-unsupported>

�q�里�?/span>guest用户不提供的权限

上面的这些设�|�的权限都可以在�q�行的时候修�?/span>

ADD_EVENT�q�类的定义，都已�l�在ActionKeys中有对应的常量定义，在二�ơ开发的时候可以��承这个类来加入自定义的权限内�?/span>

在定义完权限�?/span>resource后，我们需要在default.xml中加入对应的path

xml 代码

<resource-action-mapping>

    <resource file="resource-actions/portal.xml" />

    <resource file="resource-actions/calendar.xml" />

    <resource file="resource-actions/communities.xml" />

    <resource file="resource-actions/imagegallery.xml" />

    <resource file="resource-actions/wiki.xml" />

    <resource file="emsp-resource-actions/default.xml" />

resource-action-mapping>

Default.xml的�\径在portal(-ext).properties中可以配�|?/span>

resource.actions.configs=resource-actions/default.xml

完成的上�q�工作后�Q�我们需要在liferay的权限系�l�中把这些信息注册到数据库中�Q�待�l�）

junky 2007-06-06 13:50 发表评论

liferay portlet配置文�g介绍

junky — Thu, 31 May 2007 06:09:00 GMT

关键�? liferay 配置文�g

portlet.xml

portlet定义描述文�g�Q�它描述portlet的类型，支持Mode, preferenes和role�{�，遵��@JSR168标准实现�Q�以便于�U�L��Q�需要针�Ҏ��的做一些小改过�Q��?/font>

下面是一个简单的定义:

〈portlet�?br> 〈portlet-name�?�?portlet-name�?br> 〈display-name〉My Account�?display-name�?br> �?-- portlet的实现类 --�?br> 〈portlet-class〉com.liferay.portlet.StrutsPortlet�?portlet-class�?br> 〈init-param�?br>   〈name〉view-action�?name�?br>   〈value�?my_account/view�?value�?br> �?init-param�?br> 〈expiration-cache�?�?expiration-cache�?br> 〈supports�?br>   〈mime-type〉text/html�?mime-type�?br> �?supports�?br> 〈resource-bundle〉com.liferay.portlet.StrutsResourceBundle�?resource-bundle�?br> �?portlet�?/font>

在JSR168标准中，定义了view/edit/help三种模式�Q?br>liferay对其�q�行了扩展，增加了config/about/preview/print�{�模式�?/font>

liferay-portlet.xml

liferay的portlet定义描述文�g�Q�是liferay对portlet.xml的扩展描�q�ͼ�允许我们对portlet的呈现、功能和行�ؓ�q�行更深入的定制�?br>它与com.liferay.portal.model.Portlet�c�d��应，

下面是一个较��l�的liferay-portlet定义�Q?br> 〈portlet�?br> 〈portlet-name�?9�?portlet-name�?br>                �?-- struts路径 --�?br> 〈struts-path〉message_boards�?struts-path�?br>                �?-- 配置路径 --�?br> 〈configuration-path�?message_boards/edit_configuration�?configuration-path�?br>                �?-- lucene索引�c?--�?br> 〈indexer-class〉com.liferay.portlet.messageboards.util.Indexer�?indexer-class�?br>                �?-- url处理�c?--�?br> 〈portlet-url-class〉com.liferay.portlet.messageboards.MBFriendlyPortletURL�?portlet-url-class�?br>                �?-- 友好url插�g�c?--�?br> 〈friendly-url-plugin-class〉com.liferay.portlet.messageboards.MBFriendlyURLPortletPlugin�?friendly-url-plugin-class�?nbsp;
〈preferences-unique-per-layout〉false�?preferences-unique-per-layout�?br> 〈use-default-template〉false�?use-default-template�?br> 〈restore-current-view〉false�?restore-current-view�?br> 〈private-request-attributes〉false�?private-request-attributes�?br> �?portlet�?/font>

portlet�c�M��常用的属�?

// strtus 路径�Q�对portlet的请求应该限制在�q�个路径�?
private String _strutsPath;

// 配置路径�Q�即action定义
private String _configurationPath;

// portlet实现�c?br>private String _portletClass;

// lucene索引�c?br>private String _indexerClass;

// scheduler�c?br>private String _schedulerClass;

// portletURL处理�c?br>private String _portletURLClass;

// friendURL插�g
private String _friendlyURLPluginClass;

// 默认的preferences
private String _defaultPreferences;

// preferences的验证类
private String _prefsValidator;

// 是否实例化，为true时可��d��多个portlet到layout�?br>private boolean _instanceable;

// 是否为系�l�portlet�Q?br>private boolean _system;

// 初始化参�?br>private Map _initParams;

// portlet支持的模�?br>private Map _portletModes;

// portlet支持的语�a�
private Set _supportedLocales;

// PortletInfo
private PortletInfo _portletInfo;

// 是否静态portlet, 静态portlet不能�U�d��.
private boolean _staticPortlet;

// 是否为开始的静态portlet.
private boolean _staticPortletStart;

portlet解析

com.liferay.portal.service.impl.PortletLocalServiceImpl

public void initEAR(String[] xmls) {
String scpId = PortletServiceImpl.class.getName() + "." + _SHARED_KEY;

Map portletsPool = (Map)SimpleCachePool.get(scpId);

if (portletsPool == null) {
   portletsPool = CollectionFactory.getSyncHashMap();
   SimpleCachePool.put(scpId, portletsPool);
}

try {
   List servletURLPatterns = _readWebXML(xmls[4]);

   Set portletIds =
    _readPortletXML(xmls[0], portletsPool, servletURLPatterns);
   portletIds.addAll(
    _readPortletXML(xmls[1], portletsPool, servletURLPatterns));

   Set liferayPortletIds =
    _readLiferayPortletXML(xmls[2], portletsPool);
   liferayPortletIds.addAll(
    _readLiferayPortletXML(xmls[3], portletsPool));

   // Check for missing entries in liferay-portlet.xml
   // ��查在liferay-portlet中丢��q��portlet实体...

   // Remove portlets that should not be included
   // �U�d��不应该包括的portlet实体...
}
catch (Exception e) {
   _log.error(StackTraceUtil.getStackTrace(e));
}
}

// 解析portlet.xml
private Set _readPortletXML(
   String servletContextName, String xml, Map portletsPool,
   List servletURLPatterns)
throws DocumentException, IOException {

Set portletIds = new HashSet();

if (xml == null) {
   return portletIds;
}

SAXReader reader = SAXReaderFactory.getInstance();

Document doc = reader.read(new StringReader(xml));

Element root = doc.getRootElement();

Set userAttributes = new HashSet();

Iterator itr1 = root.elements("user-attribute").iterator();
// 用户属性处�?..

itr1 = root.elements("portlet").iterator();

while (itr1.hasNext()) {
   Element portlet = (Element)itr1.next();

   String portletId = portlet.elementText("portlet-name");

   if (servletContextName != null) {
    portletId =
     portletId + Portlet.WAR_SEPARATor + servletContextName;
   }

   portletId = PortalUtil.getJsSafePortletName(portletId);

   if (_log.isDebugEnabled()) {
    _log.debug("Reading portlet " + portletId);
   }

   portletIds.add(portletId);

   Portlet portletModel = (Portlet)portletsPool.get(portletId);

   if (portletModel == null) {
    portletModel = new Portlet(
     new PortletPK(portletId, _SHARED_KEY));

    portletsPool.put(portletId, portletModel);
   }

   if (servletContextName != null) {
    portletModel.setWARFile(true);
   }

   if (servletURLPatterns != null) {
    portletModel.setServletURLPatterns(servletURLPatterns);
   }

   portletModel.setPortletClass(portlet.elementText("portlet-class"));

   Iterator itr2 = portlet.elements("init-param").iterator();
   // 初始化参数处�?..

   Element expirationCache = portlet.element("expiration-cache");
   // cache�q�期处理...

   itr2 = portlet.elements("supports").iterator();
   // 支持模式处理...

   Set supportedLocales = portletModel.getSupportedLocales();
     // 支持语言处理...

     // 资源
   portletModel.setResourceBundle(
    portlet.elementText("resource-bundle"));

   Element portletInfo = portlet.element("portlet-info");
     // portlet-info处理...

   Element portletPreferences = portlet.element("portlet-preferences");
   // preferences处理...

   Set unlikedRoles = portletModel.getUnlinkedRoles();
   itr2 = portlet.elements("security-role-ref").iterator();
   // role处理...

   portletModel.getUserAttributes().addAll(userAttributes);
}

return portletIds;
}

// 解析liferay-portlet.xml
private Set _readLiferayPortletXML(
   String servletContextName, String xml, Map portletsPool)
throws DocumentException, IOException {

Set liferayPortletIds = new HashSet();

if (xml == null) {
   return liferayPortletIds;
}

SAXReader reader = SAXReaderFactory.getInstance();

Document doc = reader.read(new StringReader(xml));

Element root = doc.getRootElement();

Map roleMappers = new HashMap();

Iterator itr1 = root.elements("role-mapper").iterator();
// role-mapper处理...

Map customUserAttributes = new HashMap();

itr1 = root.elements("custom-user-attribute").iterator();
// 定制用户属性处�?..

Map friendlyURLPlugins = _getFriendlyURLPlugins();

itr1 = root.elements("portlet").iterator();

while (itr1.hasNext()) {
   Element portlet = (Element)itr1.next();

   String portletId = portlet.elementText("portlet-name");

   if (servletContextName != null) {
    portletId =
     portletId + Portlet.WAR_SEPARATor + servletContextName;
   }

   portletId = PortalUtil.getJsSafePortletName(portletId);

   if (_log.isDebugEnabled()) {
    _log.debug("Reading portlet extension " + portletId);
   }

   liferayPortletIds.add(portletId);

   Portlet portletModel = (Portlet)portletsPool.get(portletId);

   if (portletModel != null) {
    // 讄��portlet属�?..

    // 处理FriendURL插�g
    portletModel.setFriendlyURLPluginClass(GetterUtil.getString(
     portlet.elementText("friendly-url-plugin-class"),
     portletModel.getFriendlyURLPluginClass()));

    if (Validator.isNull(
      portletModel.getFriendlyURLPluginClass())) {

     friendlyURLPlugins.remove(portletId);
    }
    else {
     friendlyURLPlugins.put(
      portletId, portletModel.getFriendlyURLPluginClass());
    }

    // �l�定role.
    portletModel.getRoleMappers().putAll(roleMappers);
    portletModel.linkRoles();

    portletModel.getCustomUserAttributes().putAll(
     customUserAttributes);
   }
}

return liferayPortletIds;
}

从上面的代码可看出，liferay��portlet的描�q�定义存储在一个Map�?

liferay-display.xml

portlet的类别定义文�Ӟ��下面是一个简单的例子:

〈category name="category.admin"�?br> 〈portlet id="9" /�?br> 〈portlet id="40" /�?br> 〈portlet id="79" /�?br> 〈portlet id="80" /�?br> �?category�?/font>

要注意的是，在portlet.xml/liferay-portlet.xml/liferay-display.xml三个文�g中的portlet-name, portlet-id必须是一致的�?/font>

liferay-layout-templates.xml

layout模板定义文�g.

liferay-look-and-feel.xml

主题定义文�g.

portlet的web.xml

如果以war的方式发布portlet�Q�那么它的web.xml也要�q�行一些特定的说明,

下面是liferay中sample-jsp-portlet�C�Z��的web.xml:
〈web-app�?br> 〈display-name〉sample-jsp-portlet�?display-name�?br> 〈context-param�?br> 〈param-name〉company_id�?param-name�?br> 〈param-value〉liferay.com�?param-value�?br> �?context-param�?br> 〈listener�?br> 〈listener-class〉com.liferay.portal.kernel.servlet.PortletContextListener�?listener-class�?br> �?listener�?br> 〈servlet�?br> 〈servlet-name〉sample_jsp_portlet�?servlet-name�?br> 〈servlet-class〉com.liferay.portal.kernel.servlet.PortletServlet�?servlet-class�?br> 〈init-param�?br>   〈param-name〉portlet-class�?param-name�?br>   〈param-value〉com.sample.jsp.portlet.JSPPortlet�?param-value�?br> �?init-param�?br> 〈load-on-startup�?�?load-on-startup�?br> �?servlet�?br> 〈servlet-mapping�?br> 〈servlet-name〉sample_jsp_portlet�?servlet-name�?br> 〈url-pattern�?sample_jsp_portlet/*�?url-pattern�?br> �?servlet-mapping�?br> 〈taglib�?br> 〈taglib-uri〉http://java.sun.com/portlet�?taglib-uri�?br> 〈taglib-location�?WEB-INF/tld/liferay-portlet.tld�?taglib-location�?br> �?taglib�?br>�?web-app�?br>上面的listener是必��ȝ��Q�它用于通知liferay�q�行热部�|?
portlet-class指定Portlet的实现类�Q�它必须遵��@JSR168标准�Q�直接或间接的从javax.portlet.GenericPortlet�l�承�?br>
相关文章:

liferay中的囄��处理
使用liferay中的struts+tiles来开发portlet(一)
Liferay中外部war方式整合portlet的处理流�E?/a>
liferay中layout的处�?/a>

junky 2007-05-31 14:09 发表评论

关于Liferay的配�|�文�?—�?��Z��Struts开发Portlet

junky — Thu, 31 May 2007 06:00:00 GMT

�l�合Liferay实例sample-struts-portlet�Q�基于Struts开发Portlet一般具有以下配�|�文�Ӟ��

liferay-display.xml
liferay-portlet.xml
portlet.xml
struts-config.xml
tiles-defs.xml
web.xml

�Q?�Q�liferay-display.xml �Q�定义Portal 中Portlet ��理的目录结构）
        配置在Portlet 的显�C�名�U�ͼ�以及该portlet 在显�C�列表中所在的目录。值得注意的是该处�q�没有直接给出在Portlet 昄��列表中的昄��名字�Q�而是�l�出了Portlet ID�Q�根据在porlet.xml 中portlet ID与Name 的关联，可得到该Portlet 的显�C�名字�?br>






        效果�Q?/span>��d��porlet 内容�Ӟ��也就是在点击“add content” �Ӟ��名叫sample_struts_portlet 的portlet ��在目录中的test ��下昄��?br>
�Q?�Q�liferay-portlet.xml �Q�定义基于Liferay Portal 下的Portlet 的特有属性）
    该配�|�文件定义portlet 属性和角色�Q�该配置文�g对基于JSR168�?portlet.xml 的属性进行扩展�?br>



            sample_struts_portlet


                  com.liferay.portal.apache.bridges.struts.LiferayStrutsPortletURLImpl

          true
          true



            administrator
          Administrator


            guest
            Guest


            power-user
            Power User


            user
            User



    效果�Q?/span>该portlet �?span style="COLOR: rgb(0,0,0)">com.liferay.portal.apache.bridges.struts.LiferayStrutsPortletURLImpl �cȝ��实例�q�行处理�Q�允�怋�用模版和实时��h��面。可配置administrator�Q�guest�Q�power-user�Q�user 四种角色对其拥有不同的权限�?/span>

�Q?�Q�portlet.xml �Q�Portlet 的标准属性，该配�|�文件中的各��属性符合JSR168 标准�Q��ƈ非Liferay专用�Q?/span>
       该配�|�文件设�|�Portlet的各个属性，该各��属性在Portlet初始化时得以加蝲�?/span>


        sample_struts_portlet


        Sample Struts Portlet


        org.apache.portals.bridges.struts.StrutsPortlet



            ServletContextProvider

            com.liferay.util.apache.bridges.struts.LiferayServletContextProviderWrapper


            EditPage
            /portlet_action/sample_struts_portlet/edit


            HelpPage
            /portlet_action/sample_struts_portlet/help


            ViewPage
            /portlet_action/sample_struts_portlet/view


        0



            text/html
            edit
            help



            Sample Struts Portlet
            Sample Struts Portlet
            Sample Struts Portlet




            administrator


            guest


            power-user


            user



效果�Q?/span>定义了Portlet 的基本信息，展现方式�Q�以及对该Portlet 可能分配权限的用戯��艌Ӏ?span style="COLOR: rgb(0,0,0)">

�Q?�Q�struts-config.xml �Q�该配置文�g为Struts 的配�|�文�Ӟ��q��Liferay 专用�Q?/span>














































效果�Q?/span>此处可与其它��Z��Struts 应用开发同样配�|�，与Liferay �怺�独立�?br>

�Q?�Q�tiles-defs.xml �Q�该配置文�g是利用Tile �q�行��面的布局��理�Q��ƈ非Liferay 专用�Q?/span>












效果�Q?/span>此处可与其它��Z��Tiles 应用开发同样配�|�，与Liferay �怺�独立�?br>

�Q?�Q�web.xml �Q�该配置文�g为Tomcat 的应用配�|�文�Ӟ��q��Liferay 专用�Q?/span>


    sample-struts-portlet


        company_id
        liferay.com



        com.liferay.portal.kernel.servlet.PortletContextListener



        sample_struts_portlet
        com.liferay.portal.kernel.servlet.PortletServlet

            portlet-class
            org.apache.portals.bridges.struts.StrutsPortlet

        0


        PortletActionServlet
        com.liferay.util.apache.bridges.struts.LiferayPortletServlet

            config
            /WEB-INF/struts-config.xml

        1


        TestSessionServlet
        com.sample.struts.servlet.TestSessionServlet
        2



        sample_struts_portlet
        /sample_struts_portlet/*


        PortletActionServlet
        /portlet_action/*


        TestSessionServlet
        /test_session/*



        http://java.sun.com/portlet
        /WEB-INF/tld/liferay-portlet.tld


        http://struts.apache.org/tags-bean
        /WEB-INF/tld/struts-bean.tld


        http://portals.apache.org/bridges/struts/tags-portlet-html
        /WEB-INF/tld/struts-portlet-html.tld


        http://struts.apache.org/tags-logic
        /WEB-INF/tld/struts-logic.tld


        http://struts.apache.org/tags-nested
        /WEB-INF/tld/struts-nested.tld


        http://struts.apache.org/tags-tiles
        /WEB-INF/tld/struts-tiles.tld


效果�Q?/span>此处可与其它��Z��Tomcat 应用开发同样配�|�，但与Liferay 不完全独立�?/span>

junky 2007-05-31 14:00 发表评论

Liferay的授权与内容��理(�?

junky — Thu, 31 May 2007 05:55:00 GMT

Liferay的授权与内容��理

本节主要内容�?span>Liferay的授权操作以及内容管理，在介�l�授权早作的同时��结合上一��的内容�Q�探讨程序背后的执行��程�Q�也会凸现出在进行自��q��portlet开发时所要注意的权限相关代码�Q��ؓportlet的开发打下基��?/span>

liferay-portal-4.1.2的权限管理主要有2部分构成�Q?span>

1�Q?/span>user的部门归�?/span>

2�Q?/span>对单�?span>portlet的授�?/span>

��用户登陆�pȝ��后，��进入超�U�用��L��理界面�Q�管理界面��d��?span>Guest�?span>Private�?span>CMS�?span>Support 四层�l�成�Q�即�?span>Myplace中的4�U�视�?span>, 现对其进行介�l?span>.

Guest视图�Q?/span>主要��理普通用��L��所讉K��的主��内容，在此视图中可以管理展现在主页上的各个portlet�Q�管�?span>portlet中展现的内容以及portlet的展现�Ş式以及方位�?span>Portlet的内容管理放在稍后的视图中详�l�讲解，portlet的方位以及显�C��Ş式后可以通过��面上直接的拖放�q�行讄��?/span>

      默认情况下，我们所列的portlet��是匿名用户所看到的门��P��在每�?span>portlet的设�|�中�Q�我们还看到了权限的讄��Q�可以将�q�个portlet的配�|�，查看�{�权限（每个portlet的权限不相同�Q�每个都有配�|�、查看权限，但是有个复杂�?span>portlet如用��L��理的��有更多的如��d��用户、删除用��L��权限�Q�授予用��P��q�里权限的授予分6�U�，直接授予用户�Q�授予组�l�、授予地炏V��授予用��L��、授予社��和授予客�h�Q�用��L��和社��是自定义的�Q��?span>Liferay的用��h��制�ؓ公司—地点—组�l�—个人，所以授予某一高��的组�Q�下挂的用户��都会自动获得权限。在我的应用中，我将WIKI加入了门户首��，同时��察看与删除授予匿名用户�Q�所以，首页��拥有了一个大家参与修改的区域WIKI了！

Private 视图�Q�这个是��用户的私人界面，�q�里特别分析了几个简�?span>portlet的权限管理的实现�?/span>

HelloWorldPortlet�?/span>位置Test�Q?span>>helloworld �q�个portlet是最��单的一个展�C�，而且仅仅只有view的功能，所以这个权限管理就是能否在用户的视图中昄��p��了，代码中的权限代码无，只是�?span>layout调用HelloWorldPortlet。注�Q�这里是通过讄��直接调用HelloWorldPortlet�Q�没有经�q?span>Struts框架�Q�所以代码直接��?span>GenericPortlet�Q�不能由路径讉K��?/span>

Announcements�?/span>位置�Q�这�?span>portlet中访问�\径由struts配置文�g指定�Q�这�?span>portlet代码ViewAction�l�承PortletAction�Q?span>PortletAction�l�承的是Struts Action.�?span>portlet.xml中，

view-action

/wiki/view

指定了这�?span>portlet�?span>view所调用的�\径，portal容器会根�?span>struts的配�|�调用指定的Action。在�q�行action调用�Ӟ��很显焉��过�?span>Liferay扩展�?/span>PortalRequestProcessor�Q�上一��提刎ͼ��Q�也��p��行了权限��查。配�|?/span>Announcements的�\径在liferay�Q?span>portlet.xml中配�|�，�?span>/announcements/edit_configuration�Q�同栯��也是一�?span>struts路径�Q�她的权限管理也�?span>view一��P��?/span>PortalRequestProcessor中完成�?/span>

IFramePortlet�?/span>�q�个portlet也是一个简单标�{��使用例子。在�q�个portlet中，�?strong>HelloWorldPortlet相同�Q�也没有Struts的�\径配�|�，而是直接�?span>portlet.xml中定义了接受��h��?span>Action�Q�所�l�承�?span>StrutsPortlet�׃��不是�?span>struts Action而是GenericPortlet扩展而来�Q�所以在讉K��的时候没有通过PortalRequestProcessor�Q�所以其内部明确调用�?span>liferay的权限管理代码：

PermissionChecker checker =

             PermissionThreadLocal.getPermissionChecker();

�׃��面我们所分析的几个简单的portlet来看�Q�以后在�q�行portlet开发时�?span>2�U�选择�Q�当逻辑比较��时�Q�我们可以象IFramePortlet一��P��通过�?span>StrutsPortlet的��承完成。当业务逻辑比较复杂�Ӟ��多个路径�Q�，采用Struts�q�行路径配置�Ӟ��最好同Announcements一��P��通过�l�承PortletAction来将自��n开发的portlet�U�_��liferay的权限管理框架中�?/span>

CMS视图�Q?/span>明显�Q�这个层�q�行文档��理�Q�用�q?span>Guest视图��可以知道门��L��所有的新闻文章都在journal中进行管理，对它的��用网上有很多很有用的文章�Q�多用几�ơ也��q��悉了�Q�强大的文本、图像编辑功能可以就�q��用而不再用自己�~�码�Q�肯定也是很愉快的了�Q�）

Support视图�Q?/span>�q�个视图也是其他用户�Q�非��理员用��P��登陆后的定制��面�Q�由��理员进行定�Ӟ��主要操作和上面一致�?/span>

junky 2007-05-31 13:55 发表评论

Liferay 安全��理(�?

junky — Thu, 31 May 2007 05:45:00 GMT

企业应用整合成�ؓ了越来越多的企、事业单位的当务之急，我所处环境也不可避免的遇到这个棘手的问题�Q�各�U�技术的交集使得portal技术有了大显��n手之处。可�?span>IBM�?span>BEA的高额费用让我们望而却步，自然�Q�开源的portal成�ؓ了首选，Liferay是开源社区里一个非常活跃的��目�Q�）而且重要的是其技术架构如�?span>1�Q�也和我们现在的技术�\�U�相�q�，所以我们决定采�?span>Liferay�Q�版本：liferay-portal-src-4.1.2�Q?/span>作�ؓ基础来进行应用开发和�pȝ��整合�?/span>

�? Liferay技术架�?/strong>



要用好这个基��q�_��Q�必��要对她的自�w�实现原理有个比较清晰的认识�Q�以下文章�ؓ我在研究Liferay原理时所做的一些笔讎ͼ�现整理和分��n�Q�由于笔记带有强烈的个�h思想�Q�有错误再所隑օ��Q�希望能对进一步的分析做�ؓ铺垫�Q�更�Ƣ迎批评指正�Q��?/span>

Liferay Portal

Liferay �?span>JAAS权限��理

Liferay的业务逻辑��理

Liferay二次开�?/span>

Liferay WSRP

Liferay的权限管理实��C��一个典型的JAAS��理�{�略�Q�所以在分析其本�w�前�Q�在此首先介�l?span>JAAS的验证原理和Tomcat上如何开发标�?span>JAAS应用�?/span>

JAAS验证原理

JAAS的核心类和接口可以被分�ؓ三种�c�d��Q�大多数都在javax.security.auth包中。在J2SE 1.4中，�q�有一些接口的实现�c�d��com.sun.security.auth包中�Q�如下所�C�：

& #61557;       普通类 Subject�Q?/span>Principal�Q?/span>Credential(凭证)

　Subject�c�M��表了一个验证实体，它可以是用户、管理员�?/span>Web服务�Q�设备或者其他的�q�程。该�c�d��含了三中�c�d��的安全信息：

1)        �w�䆾�Q?/span>Identities�Q�：�׃��个或多个Principal对象表示

2)        公共凭证�Q?/span>Public credentials�Q�：例如名称或公共密�?/span>

3)        �U�有凭证�Q?/span>Private credentials�Q�：例如口��o或私有密�?/span>

　　Principal对象代表�?/span>Subject对象的��n份。它们实��C��java.security.Principal�?/span>java.io.Serializable接口。在Principal�c�M��Q�最重要的方法是getName�Q�）。该�Ҏ��q�回一个��n份名�U�。在Subject对象中包含了多个Principal对象�Q�因此它可以拥有多个名称。由于登录名�U�、��n份证号和Email地址都可以作为用��L��w�䆾标识�Q�可见拥有多个��n份名�U�的情况在实际应用中是非常普遍的情况�?/span>

在上面提到的凭证�q�不是一个特定的�c�L��借口�Q�它可以是�Q何对象。凭证中可以包含��M��特定安全�pȝ��需要的验证信息�Q�例如标�{�（ticket�Q�，密钥或口令�?/span>Subject对象中维护着一�l�特定的�U�有和公有的凭证�Q�这些凭证可以通过Subject �Ҏ��getPrivateCredentials�Q�）�?/span>getPublicCredentials�Q�）获得。这些方法通常在应用程序层中的安全子系�l�被调用�?/span>

& #61557;       验证 LoginContext�Q?/span>LoginModule�Q?/span>CallBackHandler�Q?/span>Callback

验证�Q?/span>LoginContext

　　在应用程序层中，你可以��?/span>LoginContext对象来验�?/span>Subject对象�?/span>LoginContext对象同时体现�?/span>JAAS的动态可插入性（Dynamic Pluggability�Q�，因�ؓ当你创徏一�?/span>LoginContext的实例时�Q�你需要指定一个配�|��?/span>LoginContext通常从一个文本文件中加蝲配置信息�Q�这些配�|�信息告�?/span>LoginContext对象在登录时使用哪一�?/span>LoginModule对象�?/span>

　　下面列出了在LoginContext中经�怋�用的三个�Ҏ��Q?/span>

& #61550;         login () �q�行��d��操作。该�Ҏ��Ȁ�z�M��配置中制定的所�?/span>LoginModule�?/span> 象。如果成功，它将创徏一个经�q�了验证�?/span>Subject对象�Q�否则抛�?/span>LoginException异常�?/span>

& #61550;         getSubject () �q�回�l�过验证�?/span>Subject对象

& #61550;         logout () 注销Subject对象�Q�删除与之相关的Principal对象和凭�?/span>

　　验证�Q?/span>LoginModule

　　LoginModule是调用特定验证机制的接口�?/span>J2EE 1.4中包含了下面几种LoginModule的实现类�Q?/span>

& #61550;         JndiLoginModule 用于验证�?/span>JNDI中配�|�的目录服务

& #61550;         Krb5LoginModule 使用Kerberos协议�q�行验证

& #61550;         NTLoginModul 使用当前用户�?/span>NT中的用户信息�q�行验证

& #61550;         UnixLoginModule 使用当前用户�?/span>Unix中的用户信息�q�行验证

　　同上面这些模块绑定在一��L��q�有对应�?/span>Principal接口的实现类�Q�例�?/span>NTDomainPrincipal�?/span>UnixPrincipal。这些类�?/span>com.sun.security.auth包中�?/span>

　　LoginModule接口中包含了五个�Ҏ��Q?/span>

1)        initialize () 当创��Z��LoginModule实例时会被构造函数调�?/span>

2)        login () �q�行验证,通常会按照登录条件生成若�q�个Principal对象

3)        commit () �q�行Principal对象��验，按照预定�?/span>Principal条�g��?/span>Login生成�?/span>Principal对象�Q�所有需要的条�g均符合后�Q�把若干个生成的Principal对象付给Subject对象�Q?/span>JAAS架构负责回传�l?/span>LoginContext.

4)        abort () 当�Q何一�?/span>LoginModule对象验证��p�|旉��会调用该�Ҏ��。�Q何已�l�和Subject对象�l�定�?/span>Principal对象都会被解除绑定�?/span>

5)        logout () 删除�?/span>Subject对象兌��?/span>Principal对象和凭证，消除Subject,Principal�{�认证对象�?/span>

　验证�Q?/span>CallbackHandler�?/span>Callback

　　CallbackHandler�?/span>Callback对象可以�?/span>LoginModule对象从系�l�和用户那里攉��必要的验证信息，同时独立于实际的攉��信息时发生的交互�q�程�?/span>

　　

　　JAAS�?/span>javax.sevurity.auth.callback包中包含了七�?/span>Callback的实现类和两�?/span>CallbackHandler的实现类�Q?/span>ChoiceCallback�?/span>ConfirmationCallback�?/span>LogcaleCallback�?/span>NameCallback�?/span>PasswordCallback�?/span>TextInputCallback�?/span>TextOutputCallback�?/span>DialogCallbackHandler�?/span>TextCallBackHandler�?/span>Callback接口只会在客��L��会被使用到。我��在后面介绍如何�~�写你自��q��CallbackHandler�c�R�?/span>

授权 Policy�Q?/span>AuthPermission�Q?/span>PrivateCredentialPermission

要了�?span>Liferay�Q?span>tomcat版本�Q�的权限��理�Q�必��首先了�?span>JAAS�?span>tomcat上的应用�?/span>

u         Tomcat服务�?span>JAAS配置�Ҏ��

　　和在应用�E�序�q�行JAAS不同的是�Q�配�|?/span>JAAS�Ҏ��会有很不一栗��我们��用的�?/span>Tomcat 5.0.x 应用服务器，它的JAAS配置�Ҏ��有数�U�，分别�?/span>

& #61557;       JAASRealm

& #61557;       JDBCRealm

& #61557;       DataSourceRealm

& #61557;       JNDIRealm

& #61557;       MemoryRealm

JAASRealm

1.         把自定义 LoginModule�?/span>User�?/span>Role�{�相关类攑օ�Tomcat �?/span> classpath

2.         把自定义login.config JAAS配置文�g配置�q?/span>JVM环境�Q�例如： JAVA_OPTS=-DJAVA_OPTS=-Djava.security.auth.login.config==$CATALINA_HOME/conf/jaas.config

3.         讄�� web.xml里的 security-constraints 标签讑֮�需要保护的资源

4.         �?/span>$CATALINA_HOME/conf/server.xml�?/span>engine标签里设�|?/span>JAASRealm标签

以下�?/span>JAASRealm标签的详�l�说�?/span>

属�?/span>

描述

className

只需要指�?/span> org.apache.catalina.realm.JAASRealm

debug

讄��debug�U�别�Q�默认�ؓ不设�|?/span>0

appName

JAAS配置文�g应用�?/span>

userClassNames

自定�?/span>user Principals

roleClassNames

自定�?/span> role Principals

useContextClassLoader

默认�?/span>true, ��Z��向后兼容�c�装载方式，使用Tomcat4以上版本ContextLoader装蝲方式

以下是完整的tomcat服务器配�|�例子：

�?/span>%TOMCAT_HOME%/config/server.xml 中添加以下段�?/span>



                appName="MyFooRealm"

    userClassNames="org.foobar.realm.FooUser"

     roleClassNames="org.foobar.realm.FooRole"

                      debug="99"/>

上面介绍�?span>tomcat的应用，�?span>liferay�Q?span>tomcat版本�Q�也是利用了�q�种标准�?span>tomcat�?span>JAAS实现�?/span>

与权限管理、用戯��证的主要�c�d��为：

com.liferay.portal.security.auth.*

com.liferay.portal.service.permission

com.liferay.portal.struts.PortalRequestProcessor

Liferay关于JAAS的实现包都在com.liferay.portal.security.auth.*下，�?span>$catalina_home/conf/jaas.conf中定义了Liferay实现�?span>loginModule�Q�在我��用的版本中，PortalLoginModule��首先通过对象池取��Z��个自定义Liferay用户自定义的实现�Q�即也可以在portal中再�ơ自定义loginModule。显�Ӟ��如果没有自定义的实现�Q�将�Ҏ��用户所使用的服务器自动�q�行选择默认实现�?/span>

Liferay自��n所实现�?/span>user Principals�?span>role Principals也仅仅是保存了用��L��userid�Q�以其作��w�标识，在登陆成功时赋予了所有用�?#8220;users”角色�Q?/span>

PortalRole role = new PortalRole("users");

getSubject().getPrincipals().add(role);

Liferay�?span>PortalRequestProcessor扩展�?span>TilesRequestProcessor�Q�实��C��自定义的��h��处理��程。在��h��程中复写了processRoles�Q�）�Q�在�q�个函数中进行了用户权限的判断，从而达��C��?span>web资源的保护�?/span>

Permission�?span>Liferay定义的用戯��问的权限判断�Q�由processRoles调用�q�行讉K��控制�?/span>

值得一提的是，Liferay本��n也含有登陆模块，�q�个登陆模块所做的主要工作为通过认证��定用户的登陆信息正��，�q��过用户的登陆信息取得用�?span>userid存放�?span>session中，�?span>JAAS的登陆模块提供基��Q�即通过登陆的正��用�?span>id与密码）。登陆的用户默认�?span>LDAP登陆�Q�但是�ؓ默认��用�Q�所以用戯��?span>Liferay都通过一个数据库的认证实现在loginAction中进行的用户判断�Q�取��Z��userid�?span>password存放�?span>session中�?/span>

整个�q�程如下�Q?/span>

如上图所�C�，触发JAAS的登陆模块的是在登陆成功后�{向了/c/portal/protected�Q�而此路径�?span>tomcat的安全域�Q�所�?span>tomcat��调用用戯��定义的登陆模块进行用戯��证，通过认证后通过对用戯��色的�Ҏ��Q�来判断用户是否允许讉K��?/span>

�? Liferay认证��程



副录�Q�帮助进行相关类查看

SecureFilter->�q�行讉K��地址限制和是使用安全�q�接转换�?/span>

PropsUtil�?span>�?/span>portal-ejb.jar里的portal.property

MainServlet 扩展Struts�?span>action Serverlet�Q�进行映��?/span>

junky 2007-05-31 13:45 发表评论

Single SignOn - Integrating Liferay With CAS Server

junky — Tue, 29 May 2007 09:07:00 GMT

Introduction

The following are a set of instructions for integrating Liferay Portal with CAS Server to setup single sign on (SSO) between Liferay and an existing web application.

Setting up CAS server

We will begin with setting up JA-SIG CAS server on Tomcat 5.x.x.

Download cas-server WAR from Liferay's download page or the whole distribution from here and drop the cas-web.war file into Tomcat's webapps dir. In a production environment The CAS server should really run on its own tomcat instance but for testing purposes we'll drop it in the same instance as our Liferay portal.

We'll need to edit the server.xml file in tomcat and uncomment the SSL section to open up port 8443.

Setting up the CAS client

Next we need to download the Yale CAS client from here. Get cas-client-2.0.11. Place the casclient.jar in ROOT/web-inf/lib of the Liferay install.

Generate the SSL cert with Java keytool

Now that we have everything we need, it's time to generate an SSL cert for our CAS server. Instructions and more information on SSL certs can be found here

But I found some typos and errors on that page. So following the instructions below should get you what you need.

In any directory ( I use my root ) enter the command:

keytool -genkey -alias tomcat -keypass changeit -keyalg RSA

Answer the questions: (note that your firstname and lastname MUST be hostname of your server and cannot be a IP address; this is very important as an IP address will fail client hostname verification even if it is correct)

Enter keystore password: changeit What is your first and last name? [Unknown]: localhost What is the name of your organizational unit? [Unknown]: What is the name of your organization? [Unknown]: What is the name of your City or Locality? [Unknown]: What is the name of your State or Province? [Unknown]: What is the two-letter country code for this unit? [Unknown]: Is CN=localhost, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown correct? [no]: yes

Then enter the command:

keytool -export -alias tomcat -keypass changeit -file %FILE_NAME%

I use server.cert for %FILE_NAME%. This command exports the cert you generated from your personal keystore (In windows your personal keystore is in C:\Documents and Settings\\.keystore)

Finally import the cert into Java's keystore with this command. Tomcat uses the keystore in your JRE (%JAVA_HOME%/jre/lib/security/cacerts)

keytool -import -alias tomcat -file %FILE_NAME% -keypass changeit -keystore %JAVA_HOME%/jre/lib/security/cacerts

Startup the CAS server

Now you are ready to startup your CAS server. Simply startup Tomcat and access CAS with https://localhost:8443/cas You should see the CAS login screen and no errors in your catalina logs.

Setting up Liferay Portal

web.xml

Note: If you are using Liferay 4.2, this filter is already defined. All you have to do is modify the URL parameters, if your CAS server is at a different location.

It's time to move on to configuring Liferay. In the web.xml file you will need to add a new filter and its mapping directly above the first existing auto login filter mapping. This new filter we just added will redirect all login attempts to the CAS server. If your hostname is different you can modify the init-params accordingly.

CAS Filter edu.yale.its.tp.cas.client.filter.CASFilter edu.yale.its.tp.cas.client.filter.loginUrl https://localhost:8443/cas-web/login edu.yale.its.tp.cas.client.filter.validateUrl https://localhost:8443/cas-web/proxyValidate edu.yale.its.tp.cas.client.filter.serviceUrl http://localhost:8080/c/portal/login

If you use a ...serviceUrl param like above, after logging in with CAS, the browser will be redirected back to that serviceUrl. However, you can change it to the following and it will redirect back to the full URL that was originally requested. This allows you to have a deep link (e.g. to a certain layout with parameters for a portlet even) that is preserved through the CAS login process:

edu.yale.its.tp.cas.client.filter.serverName localhost:8080

CAS Filter /c/portal/login

Then add the following to the rest of the auto login filters

Auto Login Filter /c/portal/login FORWARD INCLUDE REQUEST

system-ext.properties

Note: this is only needed in Liferay 4.2

Set the com.liferay.filters.sso.cas.CASFilter setting to true.

Place the following in system-ext.properties:

# # The CAS filter will redirect the user to the CAS login page for SSO. See # http://www.ja-sig.org/products/cas for more information. # com.liferay.filters.sso.cas.CASFilter=true

portal-ext.properties

Put this in portal-ext.properties.

## ## Auto Login ##

# # Input a list of comma delimited class names that implement # com.liferay.portal.security.auth.AutoLogin. These classes will run in # consecutive order for all unauthenticated users until one of them return a # valid user id and password combination. If no valid combination is # returned, then the request continues to process normally. If a valid # combination is returned, then the portal will automatically login that # user with the returned user id and password combination. # # For example, com.liferay.portal.security.auth.BasicAutoLogin reads from a # cookie to automatically log in a user who previously logged in while # checking on the "Remember Me" box. # # This interface allows deployers to easily configure the portal to work # with other SSO servers. See com.liferay.portal.security.auth.CASAutoLogin # for an example of how to configure the portal with Yale's SSO server. # #auto.login.hooks=com.liferay.portal.security.auth.BasicAutoLogin auto.login.hooks=com.liferay.portal.security.auth.BasicAutoLogin,com.liferay.portal.security.auth.CASAutoLogin

Comment the first auto.login.hooks property and uncomment the second to add CASAutoLogin to the list of AutoLogin implementations.

Startup Liferay and Test

Startup the portal and when the homepage loads up hit the login link. If all goes well you should be redirected to the CAS server's login screen. Login to CAS with liferay.com.1 as your username and liferay.com.1 as your password. You should now be logged into the portal.

Next steps

If the above test worked, you already have a CAS server installed and integrated with Liferay. The next steps are more related to properly configuring the CAS server than with Liferay. That's out of the scope of this article but we'll give a very brief summary.

By integrating the CAS server Liferay, is no longer responsible for authenticating the users, it just trusts that the CAS server authenticates them properly. The CAS server has configurable strategies for authenticating users. So far the default one has been used, which just authenticates the user if the user and password are the same. That's completely unsecure so other options need to be considered before installing in a production environment. Some reasonable options would be:

To authenticate with LDAP: The CAS server includes an authentication handler for LDAP. You can read about it in http://www.ja-sig.org/products/cas/server/ldapauthhandler/index.html. If this option is chosen it is recommended that you also configure Liferay to authenticate against LDAP using the instructions in: LDAP. Then you'll need to provide some way to synchronized the users between LDAP and Liferay's database. Two options are:

Set up the automatic importer (see LDAP, available since v4.2)
Develop an extension to CASAutoLogin that upon successful login, if the user does not exist it is created with the user from LDAP (see this mb thread for details)

To authenticate with the portal's database: It is possible to develop your own CAS authentication handler that uses the information present in Liferay's database. One way of doing this would be using Liferay's services to authenticate the user.
To authenticate against another user store: in this case you'll also need to write your own CAS authentication handler and also provide Liferay some way to add the user entries in its own database.

Some other steps that you might want to follow are:

Modify the look and feel of the CAS server pages to match those provided by the portal: http://www.ja-sig.org/products/cas/server/views/index.html
Clustering: http://www.ja-sig.org/products/cas/server/cluster/index.html
Set up real certificates

Also, check the references at the end of the article for more information.

Troubleshooting

If you created a cert with the %FILE_NAME%, you'll probably run into problems. Here are 2 commands to delete the tomcat alias from the keystore so you can start fresh:

keytool -delete -alias tomcat -keystore %JAVA_HOME%/jre/lib/security/cacerts keytool -delete -alias tomcat -file server.cert

You may not be able to get https://localhost:8443/cas up and running after the cert key generation. If so, skip the test and try it after you've finished all the steps. If you can't login at that point, you've probably generated your cert incorrectly.
I've had problems with certs on IE7, make sure you try it out on Firefox and Opera.

Your certificate must be trusted. If you created a self-signed certificate, you must add it to your truststore. I mistakenly thought I could define the truststore settings on my Tomcat SSL Connector. That didn't work because CAS was redirecting (after logging in) to a non-SSL page. Since the HTTP connector didn't know to trust the self-signed certificate, I got the 'sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target' error. My solution was to follow the guidelines in the JSSE Reference Guide and define the truststore in the JAVA_OPTS (-Djavax.net.ssl.trustStore=/path/to/custom/truststore). I created both a custom keystore (needed by the SSL Connector and specified either in the Connector config or the JAVA_OPTS) and custom truststore.

References

Lifecast: CAS Setup - Integrate Liferay Portal with a CAS server to access multiple applications with a single sign on.

A short article regarding CAS, Active Directory and an example : http://www-128.ibm.com/developerworks/web/library/wa-singlesign/

Retrieved from "http://wiki.liferay.com/index.php/Single_SignOn_-_Integrating_Liferay_With_CAS_Server"

junky 2007-05-29 17:07 发表评论

junky — Mon, 28 May 2007 02:01:00 GMT
文档说明

参与人员�Q?br>
作�?�|�名联络
柯自�?eamoi   educhina eamoi@163.com�Q�技术） zcke0728@hotmail.com�Q�版权）


发布记录�Q?br>
版本日期作�?说明
1.0 2005-10-20 柯自�?创徏�Q�第一�?


链接�Q?br>
�c�d�� |�址
Blog http://www.tkk7.com/eamoi/
MSN-Space http://spaces.msn.com/members/eamoi/

OpenDoc版权说明�Q?br>本文档版权归原作者所有�?br>在免贏V��且无�Q何附加条件的前提下，可在�|�络媒体中自�׃��播�?br>如需部分或者全文引用，请事先征求作者意见�?br>如果本文�Ҏ��有些许帮助，表达谢意的最好方式，是将您发现的问题和文档改�q�意见及时反馈给作者。当�Ӟ��倘若有时间和能力�Q�能为技术群体无偿�A献自��q��所学�ؓ最好的回馈�?br>
�?.. 5
�W�一部分 Liferay Portal 架构解析... 6
�W�一�?Liferay Portal. 6
�W�一�?Portal规范... 6
1.1.1 JSR168. 6
1.1.2 WSRP. 6
�W�二�?什么是Portal7
1.2.1 Portal 服务�?.. 7
1.2.2 Portlet容器... 7
�W�三�?什么是Portlet8
1.3.1 Portlet8
1.3.2 Portlet与Servlet的关�p?.. 8
1.3.3 Portlet的生命周�?.. 9
�W�四�?Liferay Portal工作原理... 9
1.4.1 Portlet 样式以及�H�口状�?.. 10
1.4.2 Portal��面... 11
�W�二章Liferay Portal的��?.. 13
�W�一�?Liferay Portal安装... 13
�W�二�?Liferay Portal的用��L��?.. 14
2.2.1 定义用户... 14
2.2.2 ��d��用户... 15
2.2.3 修改用户... 15
2.2.4 定义用户�l?.. 18
2.2.5 新增、重命名用户�l?.. 19
2.2.6 修改用户�l?.. 19
2.2.7 定义角色... 21
2.2.8 新增、重命名角色... 21
2.2.9 修改用户�l�角�?.. 21
2.2.10 定义Portlet的角�?.. 22
�W�三�?Liferay Portal内容和布局... 24
2.3.1 什么是布局... 24
2.3.2 什么是内容... 26
2.3.3 内容布局与Portlet的关�p?.. 27
2.3.4 选择内容和布局... 28
�W�四�?Liferay Portal的桌�?.. 28
2.4.1 什么是桌面... 28
2.4.2 定义个性化的桌�?.. 29
�W�五�?Liferay Portal的品�?.. 29
2.5.1 什么是品质... 30
2.5.2 品质和Portlet、Portal的关�p?.. 30
2.5.3 定义个性化的品�?.. 30
�W�六�?Liferay Portal的部�|�描�q�文�?.. 31
2.6.1 web.xml31
2.6.2 portlet.xml32
2.6.3 liferay-Portlet.xml33
2.6.4 liferay-display.xml34
2.6.5 liferay-layout-templates.xml35
2.6.7 liferay-look-and-feel。xml35
�W�二部分 Liferay Portal 二次开�?.. 36
�W�三章开发自��q��Portlet. 36
�W�一�?重要的基�c�：GenericPortlet36
�W�二�?Portlet标签... 37
3.2.1 defineObjects标签... 37
3.2.2 renderURL标签... 37
3.2.3 actionURL标签... 38
3.2.4 param标签... 38
3.2.5 namespace标签... 38
�W�三�?Portal的对�?.. 38
3.3.1 Request对象... 39
3.3.2 Response对象... 41
3.3.3 PortletConfig对象... 41
3.3.4 Session对象... 41
3.3.5 Preference对象... 43
�W�四�?�~�写自己的Portlet�c?.. 44
3.4.1 开发环�?.. 44
3.4.2 准备工作... 44
3.4.3 HelloWorldPortlet46
3.4.4 HelloJSPPortlet47
�W�五�?修改Web部��v描述文�g... 48
�W�六�?创徏Liferay Portal部��v描述文�g... 49
�W�三部分 Liferay Portal部��v... 54
�W�四章部�|�自��q��Portlet. 54
�W�一�?手动部��v... 54
�W�二�?Ant自动部��v... 55
�W�三�?加入Liferay Portal自有列表... 55
�W�四�?普通Java Web应用转化为Portlet应用... 56
�W�四部分附录... 58
�W�五章相兌��?.. 58
�W�一节资源网�?.. 58
�W�二�?�C�Z��... 58
�W�六章参考资�?.. 59
后序

�W�一部分 Liferay Portal 架构解析
本部分主要内�?br>Portal 服务�?Portal 容器 Portlet
�W�一�?Liferay Portal
作�ؓ一个开源Portal产品�Q�Liferay Portal提供对多个独立系�l�的内容集成�Q�帮助多个组�l�实现更有效的合作。与其他商业的Portal产品相比�Q�Liferay Portal有着一�p�d��的优良特性，而且不需要付贏V�?br>�W�一�?Portal规范
随着Portal的兴��P��来��多的公司开始涉��Portal产品开发，�q�组建各自的Portal�l��g和基于其的��品，比如IBM、BEA、MicroSoft、SAP、Apache�{�。各个厂商的接口互不兼容�Q�给软�g开发商以及开发�h员带来诸多不�ѝ�?br>1.1.1 JSR168
为此�Q�JCP�l�织发布了JSR168(Java Specification Request)�Q�Portlet Specification V1.0�Q�用来提供不同的Portal和Portlet之间的互通性。只要开发的Portlet遵��@JSR168�Q�则��可以在所有遵循JSR168的Portal上部�|�运行�?br>JSR168中定义了Portal的实现规范和接口�Q��ƈ对理想的Portlet�q�行了详�l�的规划和描�q��?br>1.1.2 WSRP
WSRP是OASIS Web Service for Remote Portlet的羃写。WSRP是Web Service的一�U�新的商业应用，一�U�新的标准，主要用来��化Portal对于各种资源或者程序整合的复杂度，可以避免�~�程带来的整合麻烦和问题。而且Portal��理员可以从��量的WSRP服务中选择需要的功能用以整合到目前所用的Portal中。它有三�U�角�Ԍ��
①、生产�?à 提供Portlet
②、消费�?à 使用Portlet
③、终端用�?à 最�l�用�?br>它的特点在于生��者将消费者所需要的信息通过WSRP�q�回�l�消费者，�q�些信息是相�Ҏ��记片断，例如HTML、XHTML�{�，可以直接嵌入用户的页面中�Q�而不用像Web Service一样开发用��L��接口�?br>实现�q�个规范�Q�Portal可以跟各式各��L��数据源打交道�Q�彻底终�l�信息孤岛的�H�境�?br>�W�二�?nbsp; 什么是Portal
Portal是基于Web的，�?#8220;应用整合”�?#8220;消除信息孤岛”为最�l�目的，提供单点��d��、内容聚合、个性化门户定制�{�功能的�l�合信息�pȝ��?br>完整的Portal通常由Portal服务器、Portlet容器、Portlet构成�?br>1.2.1 Portal 服务�?br>Portal服务器是容纳Portlet容器�Q�支持Portlet呈现的普通或者特�D�Web服务器。Portal服务器通常会提供个性化讄��、单点登录、内容聚合、信息发布、权限管理等功能�Q�支持各�U�信息数据来源，�q�将�q�些数据信息攑֜��|�页中组合而成�Q�提供个性化的内容定�Ӟ��不同权限的浏览者能够浏览不同的信息内容。通常�Q�Portal提供以下功能:
单点��d��Q�Portal通常采用ACL、SSL、LDAP�{�业界标准的安全技术，提供�Ҏ��有现有应用系�l�的安全集成�Q�只需在Portal的唯一入口上登录一�ơ，��可以访问所有应用系�l�和数据。对于安全性要求较高的应用�pȝ��Q�如电子商务�q�_��、交易系�l�等�Q�通过扩展接口传递用戯��n份信息，如数字证书信息、数字签名信息等�Q�进行二�ơ��n份认证，保证单点登陆的安全性�?br>权限控制:�pȝ��采用LDAP对用戯��源进行统一的管理，同时提供二次开发接口，可以与其他应用系�l�的用户��理模块�Ҏ��Q��ƈ能随相关业务�pȝ��实时更新讉K��权限。通过完善的授权机制及存取控制�Q�用戯��问权限控制到字段�U�别�Q�确保用户只能访问具有权限的应用�pȝ��及相关信息�?br>内容��理: 实现应用�pȝ��之间实时交换信息。采用多�U�缓存机�Ӟ��保证内容交换的性能和准��性。采用基于XML的Rich Site Summary (RSS)标准�Q�迅速在各应用系�l�之间传播最新变化�?br>信息发布: 实现信息门户内容的动态维护。动态网站系�l�可与OA协同办公�pȝ��、知识管理系�l�等集成�Q�网站信息须�l�OA�pȝ��的审�Ҏ��E�流转通过后或知识��理�q�_��讄��h��外部�׃�n权限后才可正式发布，真正实现内外信息发布的同步�?br>文�g��理: �pȝ��实现无缝集成多种数据源，包括�Q�数据库、文档（Office文档、PDF、AutoCAD、甚至ZIP文档�Q�、Web�|�页、FTP站点�{�，�q�对数据按业务要求和职务特点加以分析整理�Q�通过�l�一Web界面��d��推�?Push)至用��L��门户桌面�Q�帮助用户做出及时、正��的决策�?br>1.2.2 Portlet容器
Portlet容器提供Portlet执行的环境，包含很多Portlet�q�管理它们的生命周期�Q�保存Portlet的定制信息�?br>一个Portal容器接收到来自Portal的请求后�Q�接着��这个请求传递给存在Portal容器的Portlet 执行。Portlet容器没有义务�ȝ��合Portlet 产生的信息內容，�q�个工作必须由Portal来处理。Portal�?Portal容器可以攑֜�一赯��为同一个系�l�的�l��g�Q�或者分开成�ؓ两个独立的组件�?br>Portlet容器是普通Web Servlet容器的扩展，所以一个Portlet容器可以构徏于一个已�l�存在的Servlet容器或者可能实现全部Web Servlet容器的全部功能。无论Portlet容器怎么实现�Q�它的运行环境��L��假定它支持Servlet2.3规范�?br>通常�Q�Portlet容器扩展自普通的Servlet容器�?br>
�W�三�?nbsp; 什么是Portlet
Portlet是Portal中最重要的组�Ӟ��负责在Portal中呈��C��息内容，有相应的生命周期。通过自定义Portlet�Q�用户很�Ҏ��定义个性化的Portal��面。Portlet由Portlet容器负责��理、处理请求�ƈ�q�回动态页面，可以作�ؓPortal的可��x��即用的界面组件�?br>1.3.1 Portlet
一个Portlet是以Java技术�ؓ技术的Web�l��g�Q�由Portlet容器所��理�Q�专门处理客��L��信息��h��以及产生各种动态的信息内容。Portlet 为可插式的客��L��面组�Ӟ��提供呈现层成��Z��个信息系�l��?br>�q�些由Portlet产生的内容也被称为片�D�，而片�D�|��h��一些规则的标记( HTML、XHTML、WML )�Q�而且可以和其他的片段�l�合而成一个复杂的文�g。一个或多个 Portlet 的内容聚合而成��Z��?Portal �|�页。�?Portlet 的生命周期是�?Portlet 容器所��理控制的�?br>客户端和Portlet的互动是由Portal通过典型的请�?响应方式实现�Q�正常来��_��客户会和Portlet所产生的内容互动，举例来说�Q�根据下一步的�q�接或者是��认送出的表单，�l�果 Portal��会接收到Portlet的动作，��这个处理状况�{向到目标Portlet。这些Portlet 内容的��生可能会因�ؓ不同的��用者而有不同的变化，完全是根据客户对于这个Portlet的设�|��?br>1.3.2 Portlet与Servlet的关�p?br>Portlet被定义成��Z��个新的组�Ӟ��h��新的明确的界面与行�ؓ。�ؓ了尽可能与现有的 Servlet �l�合辑ֈ�重复使用的目的，Portlet 的规范利用了 Servlet 的规范，许多观念都很�怼�的，�l�合 Portlet、Servlet �?Jsp 在同一个网站系�l�中�Q�我们称为Portlet 应用。在同一�?Portlet 应用中，他们��分享同一个类加蝲�?ClassLoader)�Q�上下文(Context) �?Session�?
①、Portlet �?Servlet 的相��g��?br>@ Portlet 也是 Java 技术的 web �l��g
@ Portlet 也是有特定的 container 在管�?br>@ Portlet 可以动态��生各�U�内�?br>@ Portlet 的生命周期由 container 所��理
@ Portlet 和客��L��的互动是通过 request/response 的机�?
②、Portlet �?Servlet 也有一些不�?br>@ Portlet 只��?markup 信息片段�Q�不是完整的�|�页文�g。�?Portal 会将所有的 Portlet markup 信息片段攑ֈ�一个完整的 Portal �|�页�?br>@ Portlet 不会�?URL 有直接的关系
@ 客户端必��通过 portal �pȝ��才能�?Portlet 互动
@ Portlet 有一些定义好�?request 处理�Q�action request 以及 render request�?br>@ Portlet 默认定义 Portlet modes 及窗口状态可以指出在�|�页中该 Portlet 的哪个功能正在执行及现在�?状态�?br>@ Portlet 可以在同一�?portal �|�页之中存在多个�?
③、Portlet 有一些附加的功能�?Servlet 所没有�?br>@ Portlet 能够存取及储存永久配�|�文件及定制资料�?br>@ Portlet 可以存取使用者数�?br>@ Portlet ��h�� URL 的重写功能在文�g中去动态徏立连�l�，允许 portal server 不用�ȝ��道如何在�|�页的片 �D�之中徏立连�l�及动作�?br>@ Portlet 可以储存临时性的数据�?Portlet session 之中�Q�拥有两个不同的范围�Q?br>application-wide scope �?Portlet private scope �?br>④、Portlet 不具有一些功能，但是 Servlet 却有提供
@ Servlet ��h��讄��输出的文字编�? character set encoding)方式
@ Servlet可以讄�� HTTP 输出�?header
@ Servlet才能够接收客户对�?portal 发出�?URL ��h��
1.3.3 Portlet的生命周�?br>一个Portlet有着良好的生命周期管理，定义了怎样装蝲�Q�实例化和初始化�Q�怎样响应来自客户端的��h��及怎样送出服务。这个Portlet生命周期由Portlet接口的init�Q�processAction�Q�render和destroy�Ҏ��来表达�?br>载入和实例化:Portlet容器负责载入和实例化Portlet。当Portlet容器�q�行Portlet应用或者�g�q�到Portlet需要服务��用者的��h��Ӟ��Portlet��׃��被蝲入�ƈ实例化。蝲入Portlet�c�d��Q�Portlet�c�随卌��实例化�?br>初始�?Portlet�c�d��例化后，Portlet容器�q�需要初始化Portlet。以调用Portlet��d��应客��L��的请求。Portlet容器呼叫Portlet接口中的init�Ҏ��初始化Portlet。扩展自PortletConfig的类可以取出定义在部�|�描�q�文件中的初始化参数�Q�以及Resource Bundle�?br>初始化异�?�?Portlet初始化期��_��Portlet可能会丟�?UnavailableException �?PortletException 异常。此�Ӟ��Portlet容器不能�?Portlet�|�入已启动的服务�Q��ƈ�?Portlet容器必需释放�q�个 Portlet�?destory�Ҏ��不能被呼叫，因�ؓ初始化被认�ؓ执行��p�|。发�?��p�|后，Portlet容器会尝试着重新实例化及初始�?Portlet。这个异常处理的规则是：�׃��个UnavailableException 指定一个不能执行的最��时��_��当此异常发生�Ӟ��Portlet容器必需�{�到指定旉��q�去后才产生�q�且初始化一个新�?Portlet�?br>在初始化�q�程中所丟出�?Runtime Exception异常�Q�被当作 PortletException 来处理�?br>�W�四�?Liferay Portal工作原理
Portal�pȝ��Ҏ��需要由一个或者多个Portal��面�l�成�Q�每个Portal��面包含零个或者多个的Portlet。每个Portlet呈现自己的信息内容，以此实现内容聚合。通过定义每个Portlet的可用权限，实现个性化的桌面信息定制�?br>1.4.1 Portlet 样式以及�H�口状�?/p>
JCP�l�织提出的JSR168规范定义了Portlet的实现标准。每个Portlet对外表现��Z��个小�H�口�Q�有自己的默认样式和�H�口状态。如上图�Q�Portlet有自��q��标题�Q�浏览状态下支持�~�辑、关闭、上�U�R��下�U�R��最大化、最��化功能�Q�编辑状态下支持�q�回和关闭功能。从各种数据来源提取的信息以Portlet内容的�Ş式呈现在Portal中�?br>Portlet样式指出 Portlet正处于什么模式，Portlet通常会根据所处的模式而执行不同的工作�q��生不同的内容�?br>Portlet模式�?Portlet军_��它该昄��什么内容和执行什么动作。调用一�?Portlet的时候，Portlet 容器会提供一�?Portlet模式�l�那�?Portlet。当在处理一个请求动作时�Q�Portlet 的模式是可以用程序来改变的�?br>JSR168规范定义了三个Portlet模式�Q?��览、编辑和帮助�Q�Liferay Portal支持其中的全部三个模式。同时Portal是可以根据��用者的角色�Q�来军_��是要提供(昄��)哪几�?Portlet 模式�l��用者操作�?br>例如�Q�匿名��用者可以操作浏览和帮助�{?Portlet 模式的内容，而只有授权过的��用者可以操作编辑这�?Portlet 模式所提供的内�Ҏ��动作�?br>在浏览这个Portlet模式里，所被期望要提供的功能是产生标记语言来表现此�?Portlet的状态�?举例来说�Q?Portlet�?��览模式可以包含一个或多个画面让��用者可以浏览与互动�Q?或是一些不需要与使用者互动的静态内宏V�?
   在编辑这个Portlet模式里， Portlet 需要提供内容和逻辑来让使用者定�?Portlet 的行为。典型的��_��~�辑模式�?Portlet 会设定或更新 Portlet 的参数设定倹{�?br>在帮助这个模式里�Q�Portlet应该提供有关�q�个 Portlet的帮助信息。这个帮助信息可以是有关�q�个 Portlet的简单且条理清楚的视�H�说明或是详�l�的说明整个来龙去脉。所有的Portlet�q�不需要都提供帮助�q�个模式�?br>一�?Portlet可以�Ҏ��H�口状态来军_��在一个页面里该占多少�I�间。当调用一�?Portlet�Ӟ�� Portlet容器需要告诉该 Portlet目前的窗口状态�?此时 Portlet可以�Ҏ��H�口状态来军_��它该对多��信息作处理。在处理��h��的过�E�中�Q?Portlet可以通过�E�序的方式来改变�H�口状态�?br>1.4.2 Portal��面

每个Portal��面包含零个或者多个Portlet��窗口，构成一个完整的信息呈现��面。Portal在启动之后根据Portlet配置文�g�{�信息，�l�Portlet的标题等属性赋��|��赋予Portlet�~�辑、关闭等各种控制按钮�Q��Portlet成�ؓ一个标准的Portlet�H�口。Portlet合�ƈ�q�些Portlet�H�口�Q�组成一个完整的文档�Q�即Portal��面。每个Portlet都处于相应的布局当中�Q�呈��C��先定义的内容�Q�表现Portal公共的品质。而且Portlet可以在不同的布局之间切换。Portlet响应客户端的��h��Q��ƈ��请求提交到相应的URL�q�行逻辑处理�?br>Portlet开发完毕之后，部��v到Portal服务器，由Portal服务器负责组�l�、权限控制和呈现。Portal��面创徏�q�程如下:
Portlet �?Portlet容器内执行，Portlet容器接收 Portlet产生的内宏V��通常 Portlet容器��这些内�Ҏ��交给 Portlet服务器，Portlet服务器依照这些内容徏立Portal��面�Q�然后将它传�l�客��L��呈现。具体流�E�如下图:

Portal��面的请求过�E�如�?
使用者经由客��L��讑֤��Q�例如浏览器�Q�存�?Portal�Q�Portal �Ҏ��接收到的��h��军_��哪些 Portlet 需要被执行以满��需求。Portal 通过Portlet容器呼叫 Portlet�Q�然后由 Portlet产生的片�D�徏立Portal��面�Q�再传回客户端呈现给使用者。具体流�E�如下图:

�W�二章Liferay Portal的��?br>       Liferay Portal分�ؓProfessional �?Enterprise两个版本�?br>Liferay Portal支持多个应用服务器和Servlet容器。Liferay Portal Ent版本需要一个健壮的J2EE服务器，而Pro版本只要一个普通的Servlet服务器就可以�q�行。如果需要运行EJB�Q�徏议��用Pro版本。两个版本的源码和应用接口都是一��L��?br>默认的，Pro版本分别集成Tomcat / Jetty / Resin作�ؓWeb服务器，采用Struts作�ؓWeb框架�Q�实现轻量��的系�l�架构。Enterprise集成JBoss作�ؓWeb服务器，采用Spring作�ؓWeb框架�Q�兼��EJB�?br>Liferay Portal默认集成HSQL数据库，来持久化保存用户自定义的数据。通过修改集成在Liferay Portal的Tomcat的部�|�描�q�文�Ӟ��用户可以更改数据源。Liferay Portal官方�|�站提供了数据库表的生成脚本�?br>下面以Pro版本(Tomcat服务�?��Z��Q�讲�q�Liferay Portal的用��L��略、内容布局、桌面和品质�?br>�W�一�?Liferay Portal安装
�׃��Liferay Portal Pro版本集成了Tomcat服务器V5�Q�所以只要把应用包下载解压就可以直接�q�行�?br>1、从 http://www.iferay.om/web/guest/downloads/portal_pro 下蝲Pro版本zip包，解压到目录{PORTAL_HOME}�Q?目录�l�构相对普通的Tomcat增加了Liferay文�g夏V��Liferay是默认的Web应用�?br>2、正��安装JDK1.4或者JDK1.5�Q��ƈ在环境变量里面正��配�|�JAVA_HOME变量�?/p>

3、从命��o行启动{PORTAL_HOME}/bin/startup.bat�Q�启动Liferay Portal�?br>4、在��览器地址栏输�?a href="http://localhost/">http://localhost �Q�访问Portal首页�?br>5、用Login�?a href="mailto:test@liferay.com">test@liferay.com密码为test的用��L��录Portal�pȝ��Q�得到的是一个Demo的首��c�?/p>

如果启动呈现异常�Q�请查看Tomcat控制台查扑֎�因�?br>Liferay Portal启动之后�Q�HSQL数据库自动启动�?br>��d��pȝ��后，点击右上�?#8220;My Account”链接�Q�在“Display”选项卡中��Language改�ؓ“Chinese(China)”�Q�以便中文化Portal界面�?br>�W�二�?Liferay Portal的用��L��?br>Liferay Portal通过定义严�}的用��L��略、灵�zȝ��可个性化定制的内容和布局以及丰富可定制的品质�{�略�Q�实现灵�zȝ��可定制的产品理念�?br>Liferay Portal采用用户�Q�用��L��Q�角�Ԍ��Portlet的关联方式来实现用户权限的管理。用户录属于用户�l�（也可以单独存在）�Q�该用户�l�具有某�U�（多种�Q�角�Ԍ��角色分配�l�用��L��Q�也可以直接分配�l�用戗��而操作某个Portlet 需要具有其指定的角艌Ӏ�下面通过实例操作�Q�来了解和体验一下Liferay Portal的用��L��理策略�?br>2.2.1 定义用户
Liferay Portal的用��L��理在�pȝ��理的Portlet中。缺省只有系�l�管理员才能使用。登录Portal后，可以在默认的桌面上找�?#8220;�pȝ��理”Portlet。如果没有，从页面底部的选择框中选择“�pȝ��理”��d��上。也可以通过右上�?#8220;CMS”桌面�?#8220;内容和布局”��面扑ֈ��理入口�?br>�?#8220;�pȝ��理”Portlet中选择“用户”��，�q�入用户��理界面�?/p>

2.2.2 ��d��用户
�?.2.1-2所�C�页面右边�ؓ“新增用户”列，填入你所要增加的用户名称�Q�姓氏，用户标识�Q�可自动生成�Q�，邮�g地址�Q�密码（可自动生成）�{�。可以修改该用户所��h��的用��L��和角色信息（也可创徏之后再修改）。用��h��识必��L��pȝ��唯一的，所以请��保你所输入的用��h��识与已有的不冲突�?br>点击“新增用户”�Q�我们成功增加一位用��h��C�Zؓ“educhina”的用��P��如图2.2.1-2所�C�。左侧列表中新增一��?#8220;educhina eamoi”。然后我们就可修改这位用��L��用户�l�，角色�Q�个人档案等信息了�?br>2.2.3 修改用户
选择用户列表中一��，然后点击底部的三个编辑按钮，��可以分别编辑该用户的用��L��、角艌Ӏ�档案等信息了�?br>       此处我们选择用户“educhina eamoi”�Q�然后选择“�~�辑档案”�Q�出现档案编辑页面。如�?.2.3-3所�C�。填写你惌��修改的信息，点击对应�?#8220;更新”按钮卛_��完成修改。需要注意的是整个档案页面分成几个部分，需要分别修�Ҏ��新�?br>选择用户“educhina eamoi”�Q�然后选择“�~�辑角色”�Q�进入角色编辑页面，如图2.2.3-4所�C�。左侧列表框为当前该用户所��h��的角�Ԍ��右侧列表为所有可用的角色。要赋给用户新角�Ԍ��则从右侧选择一��Ҏ��多项�Q�通过中间的�{�U�L��钮，从右侧添加至左侧。要删减用户角色�Q�则从左侧移�?

junky 2007-05-28 10:01 发表评论

Tomcat下配�|�liferay portal �Q�专业配�|�）

junky — Mon, 28 May 2007 02:00:00 GMT
1. 下蝲安装JDK 1.4.2。设�|�环境变量命名�ؓ%JAVA_HOME% �q�让它指向你的目录�?br>2. 下蝲安装Tomcat5.0.x
3. 创徏 /conf/Catalina/localhost/liferay.xml


   driverClassName
   org.hsqldb.jdbcDriver


   url
   jdbc:hsqldb:test


   username
   sa


   password



   maxActive
   20



   mail.smtp.host
   localhost


   className="org.apache.catalina.realm.JAASRealm"
  appName="PortalRealm"
  userClassNames="com.liferay.portal.jaas.PortalPrincipal"
  roleClassNames="com.liferay.portal.jaas.PortalRole"
  debug="99"
  useContextClassLoader="false"
/>

4. 下蝲 liferay-portal-pro-3.6.1.war�?br>5. �~�辑 /conf/catalina.properties�?br>common.loader=
    ${catalina.home}/common/classes,\
    ...\在这�D�|��后加�?br>    ${catalina.home}/common/lib/ext/*.jar
6. 创徏/conf/Catalina/localhost/tunnel.xml�?br>
   className="org.apache.catalina.realm.JAASRealm"
  appName="PortalRealm"
  userClassNames="com.liferay.portal.jaas.PortalPrincipal"
  roleClassNames="com.liferay.portal.jaas.PortalRole"
  debug="99"
  useContextClassLoader="false"
/>

7. 创徏/conf/jaas.config�?br>PortalRealm {
    com.liferay.portal.jaas.PortalLoginModule required;};
8. �~�辑/bin/catalina.bat
在rem ----- Execute...中加入：
set JAVA_OPTS=%JAVA_OPTS% -Djava.security.auth.login.config=%CATALINA_HOME%/conf/jaas.config
9. 解压liferay-portal-pro-3.6.1.war�Q�创建到%CATALINA_HOME%/liferay目录��C��Q?CATALINA_HOME%��Z�Q意目录，最好不带中文）
10. �U�d��%CATALINA_HOME%/liferay/WEB-INF/lib 下除util-taglib.jar之外的所�?jar包放�?common/lib/ext�?br>11. 启动Tomcat�Q�在��览器地址栏上输入http://localhost��p��看见��d��界面�Q�用户名输入�Q?/font>test@liferay.com,密码�Q�test.

疑难�Q?br>1. 此方法只适应Tomcat5.0.x �?jdk1.4.2�Q�其他版本搭配，�q�不一定��用；
2. liferay-portal-pro-3.6.1.war用WinRAR解压卛_��Q?br>3. 在安装Tomcat时应注意�Q�不要让别的�E�序占用�?080端口�Q�如果占用，可以在安装的时候修改端口，也可以修�?br>/conf/server.xml�Q��port="8082"或其他端口�?br>    port="8080"               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" redirectPort="8443" acceptCount="100"
               debug="0" connectionTimeout="20000"
               disableUploadTimeout="true" />
4.安装完毕�Q�打开地址时可能报 java.lang.OutOfMemoryError�Q�设�|�JVM的内存�ؓ-Xmx512m�?br>附原安装文�g�Q?/font>

Tomcat 5.0.x/5.5.x

Expert

Download and install JDK 1.4.2 . Set an environment variable

If you are using Tomcat 5.5.x, you must download and install
JDK 5.

Download and install Tomcat.

You can download Tomcat 5.0.x or Tomcat 5.5.x. This
documentation assumes that you are using Tomcat
5.0.x but will also give special instructions for usage with
Tomcat 5.5.x.

Create /conf/Catalina/localhost/liferay.xml to set up the
portal web application.

    path=""
    docBase="../liferay"
    debug="0"
    reloadable="true"
    crossContext="true">

For Tomcat 5.5.x, edit /conf/Catalina/localhost/ROOT.xml.
You must also remove the reference to
path="" in the XML.

Download liferay-portal-pro-3.6.1.war.

Populate your database with the portal schema and default
data.

Edit /conf/catalina.properties.

common.loader=
    ${catalina.home}/common/classes,\
    ...\
    ${catalina.home}/common/lib/ext/*.jar

Configure data sources for your database. Make sure the JDBC
driver for your database is accessible by Tomcat.

Create a mail session bound to mail/MailSession. You only
need to set the locations of the IMAP, POP3,
and SMTP servers.

Edit /conf/Catalina/localhost/liferay.xml and configure a
mail session. For Tomcat 5.5.x, edit
/conf/Catalina/localhost/ROOT.xml.

            name="mail/MailSession"
        auth="Container"
        type="javax.mail.Session"
    />


            mail.store.protocol
            imap


            mail.transport.protocol
            smtp


            mail.imap.host
            localhost


            mail.pop3.host
            localhost


            mail.smtp.host
            localhost



Configure JAAS.

Edit /conf/Catalina/localhost/liferay.xml and configure a
security realm. For Tomcat 5.5.x, edit
/conf/Catalina/localhost/ROOT.xml.

            className="org.apache.catalina.realm.JAASRealm"
        appName="PortalRealm"

userClassNames="com.liferay.portal.jaas.PortalPrincipal"
        roleClassNames="com.liferay.portal.jaas.PortalRole"
        debug="99"
        useContextClassLoader="false"
    />

Repeat this step for a file called
/conf/Catalina/localhost/tunnel.xml if you want to enable
Liferay's
HTTP tunneling.

Create /conf/jaas.config.

PortalRealm {
    com.liferay.portal.jaas.PortalLoginModule required;};

Edit /bin/catalina.bat so that Tomcat can reference the
login module.

...

rem ----- Execute...

set JAVA_OPTS=%JAVA_OPTS%
-Djava.security.auth.login.config=%CATALINA_HOME%/conf/jaas.
config

Deploy liferay-portal-pro-3.6.1.war.

Unpack liferay-portal-pro-3.6.1.war to
%CATALINA_HOME%/liferay.

Move every jar except util-taglib.jar from
%CATALINA_HOME%/liferay/WEB-INF/lib to /common/lib/ext.
This step is only necessary if you plan to hot deploy
portlet WARs.

Start Tomcat.

If you get a java.lang.OutOfMemoryError exception while
starting up Tomcat, give your JVM more memory
by setting -Xmx512m.

Open your browser to http://localhost. Click on My Liferay
at the upper right hand corner to enter the
login screen. Your login is test@liferay.com and your
password is test.

junky 2007-05-28 10:00 发表评论

junky — Mon, 28 May 2007 01:59:00 GMT
     摘要: �?�? 1 概述... 3 2 基本概念... 3 2.1 Portal定义... 3 2.2 Portlet定义... 4 2.3 Portal��面的元�?.. 5 2.4 Portlet生命周期... 6 2.5 Portlet标签�?.. 7 2.6 JSR168和WSRP. 7 3 Portal的功�?.. 8 4 部分开源Portal�?..  阅读全文

junky 2007-05-28 09:59 发表评论

属�?/span>	描述
className	只需要指�?/span> org.apache.catalina.realm.JAASRealm
debug	讄��debug�U�别�Q�默认�ؓ不设�\|?/span>0
appName	JAAS配置文�g应用�?/span>
userClassNames	自定�?/span>user Principals
roleClassNames	自定�?/span> role Principals
useContextClassLoader	默认�?/span>true, ��Z��向后兼容�c�装载方式，使用Tomcat4以上版本ContextLoader装蝲方式

久久久久亚洲AV成人无码,亚洲国产成人高清在线观看 ,国产亚洲?V无码?V男人的天堂

��L���q�行Java Portlets--开发基于JSR 168的开发和部��v(�?

liferay portlet配置文�g介绍

portlet.xml

liferay-portlet.xml

portlet�c�M��常用的属�?

liferay-display.xml

liferay-layout-templates.xml

liferay-look-and-feel.xml

portlet的web.xml

关于Liferay的配�|�文�?—�?��Z��Struts开发Portlet

Liferay的授权与内容���理(�?

Liferay 安全���理(�?

Single SignOn - Integrating Liferay With CAS Server

Introduction

Setting up CAS server

Setting up the CAS client

Generate the SSL cert with Java keytool

Setting up Liferay Portal

web.xml

system-ext.properties

portal-ext.properties

Startup Liferay and Test

Next steps

Troubleshooting

References

Tomcat下配�|�liferay portal �Q�专业配�|�）

��L��q�行Java Portlets--开发基于JSR 168的开发和部��v(�?

Liferay的授权与内容��理(�?

Liferay 安全��理(�?