MainServlet
 ActionServlet
  HttpServlet
   GenericServlet
    Object

PortalRequestProcessor
PortletRequestProcessor
 TilesRequestProcessor
  RequestProcessor
   Object

StrutsPortlet
JSPPortlet
 LiferayPortlet
 VelocityPortlet
  GenericPortlet
   Object

Liferay web 应用的文件结构

html
 common
  error.jsp
  forward_common.jsp
  forward_js.jsp
  init.jsp
  themes
   bottom.jsp
   portal.jsp
   portlet.jsp
   portlet_content.jspf
   top_head.jsp
   top_js.jspf
   top_messages.jsp
   ....
 js
  everthing_unpacked.js
  jquery
   cookie.js
   dimentions.js
   hover_intent.js
   jeditable.js
   jquery.js
   json.js
   ...
  liferay
   ajax.js
   animate.js
   auto_field.js
   browser.js
   column.js
   dock.js
   layout.js
   layout_configuration.js
   ldrag.js
   liferay.js
   navigation.js
   popup.js
   portal.js
   portlet.js
   service_unpacked.js
   session.js
   util.js
   ...
 portal
  change_password.jsp
  css_cached.jsp
  error.jsp
  expire_session.jsp
  flash.jsp
  init.jsp
  layout.jsp
  load_render_portlet.jsp
  login.jsp
  render_portlet.jsp
  terms_of_use.jsp
  ...
 portlet
  ...
 taglib
  portlet
  theme
  ui
  init.jsp
 themes
  _styled
  _unstyled
  brochure
  classic
  desktop
  genesis
   _diffs
   css
    base.css
    custom.css
    everthing_unpacked.css
    layout.css
    main.css
    portlet.css
    ...
   images
   javascript
    javascript.js
   templates
    dock.vm
    init_custom.vm
    navigation.vm
    portal_normal.vm
    portal_pop_up.vm
    portlet.vm 

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177431

1. 定义新的JSP Portlet

a) 首先到 ...\portlet\ext中去加入自己要创建的portlet文件夹，例如myappletportlet，在文件夹中创建一个view.jsp，其中的内容可最简单为：

Hello JSPPortlet world!

最好的起始学习方法应该是照葫芦画瓢吧，找一个已有的portlet，看它的结构和代码。

b) 到 ...\WEB-INF\portlet-ext.xml 中加入
<portlet>
 <portlet-name>EXT_2</portlet-name>
 <!-- portlet 的最关键ID -->

 <display-name>My AppletPortlet</display-name>

 <portlet-class>com.liferay.portlet.JSPPortlet</portlet-class>
 <!-- portlet 所属的类 -->

 <init-param>
  <name>view-jsp</name>
  <value>/portlet/ext/myappletportlet/view.jsp</value>
  <!-- MVC中会直接传递到view.jsp -->
 </init-param>
 <expiration-cache>300</expiration-cache>
 <supports>
  <mime-type>text/html</mime-type>
 </supports>
 <portlet-info>
  <title>PENG Portlet</title>
  <!-- Portlet上显示的名字 -->
 </portlet-info>
 <security-role-ref>
  <role-name>Power User</role-name>
 </security-role-ref>
 <security-role-ref>
  <role-name>User</role-name>
 </security-role-ref>
</portlet>

c) 到 ...\WEB-INF\liferay-portlet-ext.xml 中加入

<portlet>
 <portlet-name>EXT_2</portlet-name>
</portlet>

d) 到...\WEB-INF\liferay-display.xml 中加入以下代码，以将EXT_2加入sample分类，到时候在Add Content时可以在这个sample组找到，否则在undefined中找。

<category name="category.sample">
 <portlet id="47"/>
 ......
 <portlet id="EXT_2"/>
</category>

e) 测试。如果上述的修改是直接在tomcat目录中进行的话，重新启动tomcat。如果是在前面提到的自己创建的EXT环境下进行的话，先用ant一下，再启动tomcat。然后http://localhost:8080/，用test@liferay.com/test进去，选择Add Content，应该可以在sample目录下找到前面创建的那个portlet了：PENG Portlet。

2. 定义新的StrutsPortlet。过程要略微复杂一些，谁叫我们要用传说中的MVC呢。先列出几个关键的配置文件：
portlet-ext.xml: 定义portlet(JSR-168 attributes)
liferay-portlet-ext.xml: 注册portlet(Liferay attributes)
struts-config.xml: 定义 page-flow (action mapping)
tiles-defs.xml: 定义 the page layout
更详细的信息可从Liferay的官方网站上获得。

a) 在ext中增加一个叫做Tiles的portlet文件夹，在其中创建一个view.jsp。内容可以简单为：

Hello StrutsPortlet world!

b) Portlet-ext.xml 中加入
<portlet>
 <portlet-name>EXT_3</portlet-name>
 <display-name>Tiles</display-name>
 <portlet-class>
  com.liferay.portlet.StrutsPortlet
  <!—实现JSR-168规范的类 -->
 </portlet-class>

 <init-param>
  <name>view-action</name>
  <value>/ext/tiles/view</value>
   <!-- portal会到struts-config.xml中去寻找/ext/tiles/view -->
 </init-param>
 <expiration-cache>0</expiration-cache>
 <supports>
  <mime-type>text/html</mime-type>
 </supports>
 <resource-bundle>
  com.liferay.portlet.StrutsResourceBundle
 </resource-bundle>
 <security-role-ref>
  <role-name>user</role-name>
 </security-role-ref>
</portlet>

c) liferay-portlet-ext.xml中加入

<portlet>
 <portlet-name>EXT_3</portlet-name>
 <struts-path>ext/tiles</struts-path>
 <!-- 告诉portal所有带有ext/tiles/*路径的请求可以认为是这个portlet的范围 -->
 <use-default-template>false</use-default-template>
 <!-- 因为将采用别的template，所以设置为false。将要使用的template在tiles-defs.xml中定义。-->
</portlet>

d) struts-config-ext.xml中加入

<action path="/ext/tiles/view"
 forward="portlet.ext.tiles.view" />
<!-- Struts 将会在 tiles-defs.xml 中寻找 portlet.ext.tiles.view -->

e) 在tiles-defs-ext.xml 中加入

<definition name="portlet.ext.tiles.view" extends="portlet">
<!-- 定义了哪个 template 将被使用，这里是portlet template。这个template 定义了portlet的borders和buttons（例如minimize, maximize, close 等等）。 -->

<put name="portlet_content" value="/portlet/ext/tiles/view.jsp" />
 <!-- portlet_content 是一个liferay的变量，portal可以使用这个变量来决定在portlet中会呈现什么内容。这里portlet的内容就是view.jsp。 -->
</definition>

f) 测试。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177436

top_js.jspf
------------------

function addPortlet(plid, portletId, doAsUserId) {

  var refreshPortletList = getRefreshPortletList();

  if (refreshPortletList["_" + portletId]) {
    self.location = "<%= themeDisplay.getPathMain() %>/portal/update_layout?p_l_id=" + plid + "&p_p_id=" + portletId + "&doAsUserId=" + doAsUserId + "&<%=

Constants.CMD %>=<%= Constants.ADD %>&referer=<%= HttpUtil.encodeURL(currentURL) %>&refresh=1";
  }
 
  else {
    var loadingDiv = document.createElement("div");
    var container = document.getElementById("layout-column_column-1");

    if (container == null) {
      return;
    }

    loadingDiv.className = "loading-animation";

    container.appendChild(loadingDiv);

    var queryString = "<%= themeDisplay.getPathMain() %>/portal/update_layout?p_l_id=" + plid + "&p_p_id=" + portletId + "&doAsUserId=" + doAsUserId + "&<%=

Constants.CMD %>=<%= Constants.ADD %>&currentURL=<%= HttpUtil.encodeURL(currentURL) %>";

    /* queryString = /c/portal/update_layout?p_l_id=10102&p_p_id=reports&doAsUserId=&cmd=add&currentURL=%2Fweb%2Fguest%2Fhome */
    /* 这就是最终发送往服务器端的数据了，刚好可以与前面所分析的服务器端收到/c/portal/update_layout后的处理流程对应起来了。*/

    addPortletHTML(queryString, loadingDiv);
  }
}

portlet_js.jspf
--------------------

function getRefreshPortletList() {

  <%
  List allPortlets = PortletLocalServiceUtil.getPortlets(company.getCompanyId(), false, false);
 
  List nonAjaxPortlets = new ArrayList();

  for (int i = 0; i < allPortlets.size(); i++) {
    Portlet portlet = (Portlet)allPortlets.get(i);

    if (!portlet.isAjaxable()) {
      nonAjaxPortlets.add(portlet.getPortletId());
    }
  }

  StringMaker portletList = new StringMaker();

  for (int i = 0; i < nonAjaxPortlets.size(); i++) {
    portletList.append("_");
    portletList.append(nonAjaxPortlets.get(i));
    portletList.append(":true");
    portletList.append((i < nonAjaxPortlets.size() - 1) ? "," : "");
  }
 %>

  var refreshPortletList = { <%= portletList.toString() %> };
  return refreshPortletList;
}

function addPortletHTML(url, placeHolder) {

  var addPortletReturn = function(html) {

    var container = placeHolder.parentNode;

    var addDiv = document.createElement("div");

    addDiv.style.display = "none";

    addDiv.innerHTML = html;

    var portletBound = jQuery(".portlet-boundary:first", addDiv).get(0);

    portletBound.parentNode.removeChild(portletBound);

    var portletId = portletBound.id;

    portletId = portletId.replace(/^p_p_id_/,"");

    portletId = portletId.replace(/_$/,"");

    portletBound.portletId = portletId;

    Liferay.Portlet.flagAjax(portletId);

    container.replaceChild(portletBound, placeHolder);

    Liferay.Util.evalScripts(addDiv);

    if (!jQuery.browser.firefox) {
      Liferay.Util.evalScripts(portletBound);
    }

    <c:if test="<%= (layout != null) && (LayoutPermissionUtil.contains(permissionChecker, layout, ActionKeys.UPDATE)) %>">
      if (!portletBound.isStatic) {
        if (themeDisplay.isFreeformLayout()) {
          Liferay.Freeform.add(portletBound);
        }
        else {
          Liferay.Columns.add(portletBound);
        }
      }
    </c:if>

    if (jQuery.browser.firefox) {
      setTimeout("Liferay.Portlet.process(\"" + portletId + "\")", 0);
    }
    else {
      Liferay.Portlet.process(portletId);
    }

    Liferay.Util.addInputType(portletBound.id);
    Liferay.Util.addInputFocus(portletBound.id);

    if (window.location.hash) {
      window.location.hash = "p_" + portletId;
    }
    return portletId;
  };

  /* addPortletHTML()生成一个Ajax Request，收到Ajax Response后调用addPortletReturn。*/
  AjaxUtil.request(url, {
  onComplete: function(xmlHttpReq){
   addPortletReturn(xmlHttpReq.responseText);
  }
  });
}

  /* xmlHttpReq.responseText的内容就是该portlet要嵌入portal中的的HTML代码片段，如下图所示。在经过addPortletReturn()处理后完成portlet的添加工作*/

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177414

增加一个portlet

请求：
Hypertext Transfer Protocol
    POST /c/portal/update_layout HTTP/1.1\r\n
    Referer: http://10.108.10.205:8080/web/guest/home?p_p_id=EXT_1&p_p_action=0&p_p_state=normal&\r\n
    method: POST /c/portal/update_layout HTTP/1.1\r\n
    Content-Type: application/x-www-form-urlencoded\r\n
    Accept-Encoding: gzip, deflate\r\n
    Host: 10.108.10.205:8080\r\n
    Content-Length: 136
    Connection: Keep-Alive\r\n
    Cache-Control: no-cache\r\n
    Cookie: COOKIE_SUPPORT=true; LOGIN=test@liferay.com; SCREEN_NAME=DkOc2AWkcEQ=; GUEST_LANGUAGE_ID=en_US; JSESSIONID=2DFE59B64996E95DE0C64BA609CF79D1\r\n
    \r\n
Line-based text data: application/x-www-form-urlencoded
    p_l_id=10102&p_p_id=EXT_1&doAsUserId=&cmd=add&currentURL=%2Fweb%2Fguest%2Fhome%3Fp_p_id%3DEXT_1%26p_p_action%3D0%26p_p_state%3Dnormal%26

响应：
Hypertext Transfer Protocol
    HTTP/1.1 200 OK\r\n
    Server: Apache-Coyote/1.1\r\n
    Set-Cookie: COOKIE_SUPPORT=true; Expires=Thu, 05-Mar-2009 07:53:59 GMT; Path=/\r\n
    Liferay-Portal: Liferay Enterprise Portal 4.3.3 (Owen / Build 4303 / October 9, 2007)\r\n
    Content-Encoding: gzip\r\n
    Content-Type: text/html;charset=UTF-8\r\n
    Content-Length: 924
    Date: Wed, 05 Mar 2008 07:54:00 GMT\r\n
    \r\n
    Content-encoded entity body (gzip): 924 bytes -> 2534 bytes
Line-based text data: text/html
    <div id="p_p_id_EXT_1_" class="portlet-boundary portlet-boundary_EXT_1_" >\r
    <a name="p_EXT_1"></a>\r
    <div class="portlet" id="portlet-wrapper-EXT_1">\n
    <div class="portlet-topper">\n
    <span class="portlet-title">\n
     Reports\n
    </span>\n
    <div class="portlet-icons" id="portlet-small-icon-bar_EXT_1">\n
        \r
    <a href="javascript: Liferay.PortletCSS.init('EXT_1');" target="_self"><img align="absmiddle" border="0"

src="/html/themes/genesis/images/common/../portlet/portlet_css.png" title="Look and Feel" /></a>\r
    <a href="javascript: self.location = 'http%3A%2F%2F10.108.10.205%3A8080%2Fweb%2Fguest%2Fhome%3Fp_p_id%3D86%26p_p_action%3D0%26p_p_state%3Dmaximized%

26_86_struts_action%3D%252Fportlet_configuration%252Fedit_permissions%26_86_redirect%3D%252
    <span id="p_p_body_EXT_1_min_buttons">\r
    <a href="javascript: minimizePortlet('10102', 'EXT_1', false, '');"><img align="absmiddle" border="0"

src="/html/themes/genesis/images/portlet/minimize.png" title="Minimize" /></a>\r
    </span>\r
    <a href="http://10.108.10.205:8080/web/guest/home?p_p_id=EXT_1&p_p_action=0&p_p_state=maximized&" target="_self"><img align="absmiddle" border="0"

src="/html/themes/genesis/images/common/../portlet/maximize.png" title="Maximize" /></a>\r
    <a href="javascript: closePortlet('10102', 'EXT_1', '');" target="_self"><img align="absmiddle" border="0"

src="/html/themes/genesis/images/common/../portlet/close.png" title="Remove" /></a>\r
    </div>\n
    </div>\n
    <div class="portlet-content">\n
    <div class="portlet-content-container" style="">\r
    <div>\r
    <a href="http://10.108.10.205:8080/web/guest/home?p_p_id=EXT_1&p_p_action=0&p_p_state=maximized&p_p_mode=view&">Test 123</a>\r
    </div>\r
    </div>\r
    </div>\n
    </div>\r
    </div>\r
    <script type="text/javascript">\r
    document.getElementById("p_p_id_EXT_1_").portletId = "EXT_1";\r
    document.getElementById("p_p_id_EXT_1_").columnPos = 0;\r
    if (!Liferay.Portlet.isAjax("EXT_1")) {\r
    Liferay.Portlet.process("EXT_1");\r
    }\r
    jQuery(\r
    function() {\r
    Liferay.Util.portletTitleEdit(\r
    {\r
    obj: jQuery("#p_p_id_EXT_1_"),\r
    plid: "10102",\r
    doAsUserId: "",\r
    portletId: "EXT_1"\r
    }\r
    );\r
    }\r
    );\r
    </script>\r

 
最小化一个portlet

请求：
Hypertext Transfer Protocol
    POST /c/portal/update_layout HTTP/1.1\r\n
    Referer: http://10.108.10.205:8080/web/guest/home\r\n
    method: POST /c/portal/update_layout HTTP/1.1\r\n
    Content-Type: application/x-www-form-urlencoded\r\n
    Accept-Encoding: gzip, deflate\r\n
    User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; Maxthon; .NET CLR 1.1.4322; .NET CLR 2.0.50727)\r\n
    Host: 10.108.10.205:8080\r\n
    Content-Length: 68
    Connection: Keep-Alive\r\n
    Cache-Control: no-cache\r\n
    Cookie: COOKIE_SUPPORT=true; LOGIN=test@liferay.com; SCREEN_NAME=DkOc2AWkcEQ=; GUEST_LANGUAGE_ID=en_US; JSESSIONID=2DFE59B64996E95DE0C64BA609CF79D1\r\n
    \r\n
Line-based text data: application/x-www-form-urlencoded
    p_l_id=10102&p_p_id=EXT_1&p_p_restore=false&doAsUserId=&cmd=minimize

响应：
Hypertext Transfer Protocol
    HTTP/1.1 200 OK\r\n
    Server: Apache-Coyote/1.1\r\n
    Set-Cookie: COOKIE_SUPPORT=true; Expires=Thu, 05-Mar-2009 07:57:17 GMT; Path=/\r\n
    Liferay-Portal: Liferay Enterprise Portal 4.3.3 (Owen / Build 4303 / October 9, 2007)\r\n
    Content-Type: text/html;charset=UTF-8\r\n
    Content-Length: 0
    Date: Wed, 05 Mar 2008 07:57:17 GMT\r\n
    \r\n

恢复一个portlet（从最小化）

请求：
Hypertext Transfer Protocol
    POST /c/portal/update_layout HTTP/1.1\r\n
    Accept: */*\r\n
    Accept-Language: en-us\r\n
    Referer: http://10.108.10.205:8080/web/guest/home\r\n
    method: POST /c/portal/update_layout HTTP/1.1\r\n
    Content-Type: application/x-www-form-urlencoded\r\n
    Accept-Encoding: gzip, deflate\r\n
    User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; Maxthon; .NET CLR 1.1.4322; .NET CLR 2.0.50727)\r\n
    Host: 10.108.10.205:8080\r\n
    Content-Length: 67
    Connection: Keep-Alive\r\n
    Cache-Control: no-cache\r\n
    Cookie: COOKIE_SUPPORT=true; LOGIN=test@liferay.com; SCREEN_NAME=DkOc2AWkcEQ=; GUEST_LANGUAGE_ID=en_US; JSESSIONID=2DFE59B64996E95DE0C64BA609CF79D1\r\n
    \r\n
Line-based text data: application/x-www-form-urlencoded
    p_l_id=10102&p_p_id=EXT_1&p_p_restore=true&doAsUserId=&cmd=minimize

响应：
Hypertext Transfer Protocol
    HTTP/1.1 200 OK\r\n       
    Server: Apache-Coyote/1.1\r\n
    Set-Cookie: COOKIE_SUPPORT=true; Expires=Thu, 05-Mar-2009 07:57:17 GMT; Path=/\r\n
    Liferay-Portal: Liferay Enterprise Portal 4.3.3 (Owen / Build 4303 / October 9, 2007)\r\n
    Content-Type: text/html;charset=UTF-8\r\n
    Content-Length: 0
    Date: Wed, 05 Mar 2008 07:57:17 GMT\r\n
    \r\n

最大化一个portlet

请求：
Hypertext Transfer Protocol
    GET /web/guest/home?p_p_id=EXT_1&p_p_action=0&p_p_state=maximized& HTTP/1.1\r\n       
    Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, application/x-

shockwave-flash, */*\r\n
    Referer: http://10.108.10.205:8080/web/guest/home\r\n
    Accept-Language: en-us\r\n
    Accept-Encoding: gzip, deflate\r\n
    User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; Maxthon; .NET CLR 1.1.4322; .NET CLR 2.0.50727)\r\n
    Host: 10.108.10.205:8080\r\n
    Connection: Keep-Alive\r\n
    Cookie: LFR_SESSION_STATE_10111=1204702463265; COOKIE_SUPPORT=true; LOGIN=test@liferay.com; SCREEN_NAME=DkOc2AWkcEQ=; GUEST_LANGUAGE_ID=en_US;

JSESSIONID=2DFE59B64996E95DE0C64BA609CF79D1\r\n
    \r\n

响应：
Hypertext Transfer Protocol
    HTTP/1.1 200 OK\r\n
    Server: Apache-Coyote/1.1\r\n
    Set-Cookie: COOKIE_SUPPORT=true; Expires=Thu, 05-Mar-2009 07:39:37 GMT; Path=/\r\n
    Liferay-Portal: Liferay Enterprise Portal 4.3.3 (Owen / Build 4303 / October 9, 2007)\r\n
    Content-Encoding: gzip\r\n
    Content-Type: text/html;charset=UTF-8\r\n
    Content-Length: 4473
    Date: Wed, 05 Mar 2008 07:39:47 GMT\r\n
    \r\n
    Content-encoded entity body (gzip): 4473 bytes -> 19199 bytes
Line-based text data: text/html
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r
    <html dir="ltr">\r
    <head>\r
    <title>liferay.com - Welcome</title>\r
    <meta content="text/html; charset=UTF-8" http-equiv="content-type" />\r
    <link rel="Shortcut Icon" href="/html/themes/genesis/images/liferay.ico" _fcksavedurl=""/html/themes/genesis/images/liferay.ico"" />\r
    <link href="/c/portal/css_cached?themeId=genesis&colorSchemeId=01&t=1204702034813" type="text/css" rel="stylesheet" />\r
    <style type="text/css">\r
    </style>\r
    <script type="text/javascript">\r
    var themeDisplay = {\r
    getCompanyId: function() {\r
    return "10094";\r
    },\r
    getDoAsUserIdEncoded: function() {\r
    return "";\r
    },\r
    ................................(省略了整个页面的代码)

恢复一个portle(从全屏)

请求：
Hypertext Transfer Protocol
    GET /web/guest/home?p_p_id=EXT_1&p_p_action=0&p_p_state=normal& HTTP/1.1\r\n
    Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, application/x-

shockwave-flash, */*\r\n
    Referer: http://10.108.10.205:8080/web/guest/home?p_p_id=EXT_1&p_p_action=0&p_p_state=maximized&\r\n
    Accept-Language: en-us\r\n
    Accept-Encoding: gzip, deflate\r\n
    User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; Maxthon; .NET CLR 1.1.4322; .NET CLR 2.0.50727)\r\n
    Host: 10.108.10.205:8080\r\n
    Connection: Keep-Alive\r\n
    Cookie: LFR_SESSION_STATE_10111=1204702790765; COOKIE_SUPPORT=true; LOGIN=test@liferay.com; SCREEN_NAME=DkOc2AWkcEQ=; GUEST_LANGUAGE_ID=en_US;

JSESSIONID=2DFE59B64996E95DE0C64BA609CF79D1\r\n
    \r\n

响应：
Hypertext Transfer Protocol
    HTTP/1.1 200 OK\r\n
    Server: Apache-Coyote/1.1\r\n
    Set-Cookie: COOKIE_SUPPORT=true; Expires=Thu, 05-Mar-2009 07:39:37 GMT; Path=/\r\n
    Liferay-Portal: Liferay Enterprise Portal 4.3.3 (Owen / Build 4303 / October 9, 2007)\r\n
    Content-Encoding: gzip\r\n
    Content-Type: text/html;charset=UTF-8\r\n
    Content-Length: 4473
    Date: Wed, 05 Mar 2008 07:39:47 GMT\r\n
    \r\n
    Content-encoded entity body (gzip): 4473 bytes -> 19199 bytes
Line-based text data: text/html
    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r
    <html dir="ltr">\r
    <head>\r
    <title>liferay.com - Welcome</title>\r
    <meta content="text/html; charset=UTF-8" http-equiv="content-type" />\r
    <link rel="Shortcut Icon" href="/html/themes/genesis/images/liferay.ico" _fcksavedurl=""/html/themes/genesis/images/liferay.ico"" />\r
    <link href="/c/portal/css_cached?themeId=genesis&colorSchemeId=01&t=1204702034813" type="text/css" rel="stylesheet" />\r
    <style type="text/css">\r
    </style>\r
    <script type="text/javascript">\r
    var themeDisplay = {\r
    getCompanyId: function() {\r
    return "10094";\r
    },\r
    getDoAsUserIdEncoded: function() {\r
    return "";\r
    },\r
    ................................(省略了整个页面的代码)

拖动一个portlet

请求：
Hypertext Transfer Protocol
    POST /c/portal/update_layout HTTP/1.1\r\n
    Accept: */*\r\n
    Accept-Language: en-us\r\n
    Referer: http://10.108.10.205:8080/web/guest/home?p_p_id=EXT_1&p_p_action=0&p_p_state=normal&\r\n
    method: POST /c/portal/update_layout HTTP/1.1\r\n
    Content-Type: application/x-www-form-urlencoded\r\n
    Accept-Encoding: gzip, deflate\r\n
    User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; Maxthon; .NET CLR 1.1.4322; .NET CLR 2.0.50727)\r\n
    Host: 10.108.10.205:8080\r\n
    Content-Length: 80
    Connection: Keep-Alive\r\n
    Cache-Control: no-cache\r\n
    Cookie: COOKIE_SUPPORT=true; LOGIN=test@liferay.com; SCREEN_NAME=DkOc2AWkcEQ=; GUEST_LANGUAGE_ID=en_US; JSESSIONID=2DFE59B64996E95DE0C64BA609CF79D1\r\n
    \r\n
Line-based text data: application/x-www-form-urlencoded
    p_l_id=10102&p_p_id=EXT_1&p_p_col_id=column-2&p_p_col_pos=0&doAsUserId=&cmd=move

响应：
Hypertext Transfer Protocol
    HTTP/1.1 200 OK\r\n
    Server: Apache-Coyote/1.1\r\n
    Set-Cookie: COOKIE_SUPPORT=true; Expires=Thu, 05-Mar-2009 07:49:39 GMT; Path=/\r\n
    Liferay-Portal: Liferay Enterprise Portal 4.3.3 (Owen / Build 4303 / October 9, 2007)\r\n
    Content-Type: text/html;charset=UTF-8\r\n
    Content-Length: 0
    Date: Wed, 05 Mar 2008 07:49:39 GMT\r\n
    \r\n

删除一个portlet

请求：
Hypertext Transfer Protocol
    POST /c/portal/update_layout HTTP/1.1\r\n
    Accept: */*\r\n
    Accept-Language: en-us\r\n
    Referer: http://10.108.10.205:8080/web/guest/home?p_p_id=EXT_1&p_p_action=0&p_p_state=normal&\r\n
    method: POST /c/portal/update_layout HTTP/1.1\r\n
    Content-Type: application/x-www-form-urlencoded\r\n
    Accept-Encoding: gzip, deflate\r\n
    User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0; Maxthon; .NET CLR 1.1.4322; .NET CLR 2.0.50727)\r\n
    Host: 10.108.10.205:8080\r\n
    Content-Length: 48
    Connection: Keep-Alive\r\n
    Cache-Control: no-cache\r\n
    Cookie: COOKIE_SUPPORT=true; LOGIN=test@liferay.com; SCREEN_NAME=DkOc2AWkcEQ=; GUEST_LANGUAGE_ID=en_US; JSESSIONID=2DFE59B64996E95DE0C64BA609CF79D1\r\n
    \r\n
Line-based text data: application/x-www-form-urlencoded
    p_l_id=10102&p_p_id=EXT_1&doAsUserId=&cmd=delete

响应：
Hypertext Transfer Protocol
    HTTP/1.1 200 OK\r\n
    Server: Apache-Coyote/1.1\r\n
    Set-Cookie: COOKIE_SUPPORT=true; Expires=Thu, 05-Mar-2009 07:52:25 GMT; Path=/\r\n
    Liferay-Portal: Liferay Enterprise Portal 4.3.3 (Owen / Build 4303 / October 9, 2007)\r\n
    Content-Type: text/html;charset=UTF-8\r\n
    Content-Length: 0
    Date: Wed, 05 Mar 2008 07:52:25 GMT\r\n
    \r\n

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177424

通过分析知道，在Add Content中点击某个portlet的add按钮后，服务器会收到一个/c/portal/update_layout...的请求（这里与生成 Add Content Portlet有区别，在前面文章中提到，那时的请求是一个/c/portal/render_portlet...），服务器在收到请求后前面的步骤同上面分析add content portlet的过程一样。

PortalRequestProcess.process()

String path = processPath(request, response);
//这里path = “/portal/update_layout”.

ActionMapping mapping = processMapping(request, response, path);
//这里找到在struts-config.xml中定义的关于上面path的mapping.

Action action = processActionCreate(request, response, mapping);
//这里生成了UpdateLayoutAction.

ActionForward forward = processActionPerform(request, response, action, form, mapping);

processForwardConfig(request, response, forward);

在struts-config.xml中有定义：
<action path="/portal/update_layout" type="com.liferay.portal.action.UpdateLayoutAction" />

UpdateLayoutAction.execute()

LayoutTypePortlet layoutTypePortlet = themeDisplay.getLayoutTypePortlet();

String cmd = ParamUtil.getString(req, Constants.CMD);

String portletId = ParamUtil.getString(req, "p_p_id");

if (cmd.equals(Constants.ADD))
{  portletId = layoutTypePortlet.addPortletId(userId, portletId); }
else if (cmd.equals(Constants.DELETE)) { layoutTypePortlet.removePortletId(portletId); }
else if (cmd.equals("drag")) { }
else if (cmd.equals("minimize")) { }
else if (cmd.equals("move")) { layoutTypePortlet.movePortletId(userId, portletId, columnId, columnPos); }
else if (cmd.equals("template")) { }

if (ParamUtil.getBoolen(req, "refresh")) {}
else {
  if (cmd.equals(Constants.ADD) && (portletId != null)) {
  Action renderPortletAction = (Action)InstancePool.get(RenderPortletAction.class.getName());
  renderPortletAction.execute(mapping, form, dynamicReq, res);
}

因为cmd=add，所以调用LayoutTypePortlet.addPortletId()来将portletId加入到Layout中，而且最后调用RenderPortletAction.execute()来将这个portlet最终render出来，具体过程如上面关于content portlet的分析。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177387

portal.jsp
--------------
<c:choose>
 <c:when test="<%= themeDisplay.isStateExclusive() %>">
  <%= request.getAttribute(WebKeys.LAYOUT_CONTENT) %>
 </c:when>
 <c:when test="<%= themeDisplay.isStatePopUp() %>">
  <liferay-theme:include page="portal_pop_up.jsp" />
 </c:when>
 <c:otherwise>
  <liferay-theme:include page="portal_normal.jsp" />
 </c:otherwise>
</c:choose>

portal_normal.vm
--------------------------
<html dir="#language ("lang.dir")">

$theme.include($top_head_include)

#css ($css_main_file)
#js ($js_main_file)
$theme.include($bottom_ext_include)
$theme.include($session_timeout_include)
$theme.include($sound_alerts_include)

init.vm
---------
#set ($bottom_ext_include = "$dir_include/common/themes/bottom.jsp")
#set ($content_include = "$dir_include$tilesContent")
#set ($session_timeout_include = "$dir_include/common/themes/session_timeout.jsp")
#set ($sound_alerts_include = "$dir_include/common/themes/sound_alerts.jsp")
#set ($top_head_include = "$dir_include/common/themes/top_head.jsp")
#set ($top_messages_include = "$dir_include/common/themes/top_messages.jsp")

top_head.jsp
------------------
<%@ include file="/html/common/themes/top_js.jspf" %>
<%@ include file="/html/common/themes/top_js-ext.jsp" %>

top_js.jspf
------------
<%
String[] javaScriptFiles = PropsUtil.getArray(PropsUtil.JAVASCRIPT_FILES);
for (int i = 0; i < javaScriptFiles.length; i++) {
%>
  <script src="<%= themeDisplay.getPathJavaScript() %>/<%= javaScriptFiles[i] %>"  type="text/javascript"></script>
<%
}
%>

portal.properties
-------------------
##
## JavaScript
##

    #
    # Set a list of JavaScript files that will be loaded programmatically in
    # /html/common/themes/top_js.jsp.
    #
    # The ordering of the JavaScript files is important. Specifically, all
    # JQuery scripts should go first.
    #
    # The Liferay scripts are grouped in such a way, that the first grouping
    # denotes utility scripts that are used by the second and third groups. The
    # second grouping denotes utility classes that rely on the first group, but
    # does not rely on the second or third group. The third grouping denotes
    # modules that rely on the first and second group.
    #
    javascript.files=\
        \
        #
        # JQuery scripts
        #
        \
        jquery/jquery.js,\
        jquery/cookie.js,\
        jquery/dimensions.js,\
        jquery/hover_intent.js,\
        jquery/interface.js,\
        jquery/interface.patch.js,\
        jquery/j2browse.js,\
        jquery/jeditable.js,\
        jquery/json.js,\
        jquery/media.js,\
        jquery/tabs.js,\
        \
        #
        # Miscellaneous scripts
        #
        \
        misc/class.js,\
        misc/swfobject.js,\
        \
        #
        # Liferay base utility scripts
        #
        \
        liferay/liferay.js,\
        liferay/browser.js,\
        liferay/util.js,\
        liferay/language.js,\
        liferay/layout.js,\
        \
        #
        # Liferay utility scripts
        #
        \
        liferay/ajax.js,\
        liferay/animate.js,\
        liferay/coordinates.js,\
        liferay/ldrag.js,\
        #liferay/leditable.js,\
        liferay/lresize.js,\
        liferay/popup.js,\
        liferay/portal.js,\
        liferay/portlet.js,\
        liferay/publisher.js,\
        \
        #
        # Liferay modules
        #
        \
        liferay/auto_fields.js,\
        liferay/color_picker.js,\
        liferay/columns.js,\
        liferay/dock.js,\
        liferay/dynamic_select.js,\
        liferay/freeform.js,\
        liferay/layout_configuration.js,\
        liferay/messaging.js,\
        liferay/notice.js,\
        liferay/navigation.js,\
        liferay/session.js,\
        liferay/tags_selector.js

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177411

下面以显示 Add Content 为例进行分析，Add Content 窗口其实是一个在 portlet-custom.xml 中定义的名为87的portlet。点击Add Content链接会产生一个Reqest，开始整个处理的流程。

1. Request的生成。

当时页面的源文件中有关的代码为：
<li class="add-content">
<a href="javascript: void(0);" onclick="LayoutConfiguration.toggle('10102', '87', '');">Add Content</a>
</li>

点击add content调用的是LayoutConfiguration.toogle()。

layout_configuratioin.js
var LayoutConfiguration = {
  toggle : function (plid, ppid, doAsUserId) {
  var url = themeDisplay.getPathMain() + "/portal/render_portlet?p_l_id=" + plid + "&p_p_id=" +ppid + "&doAsUserId=" + doAsUserId + "&p_p_state=exclusive";
  AjaxUtil.update(url, popup, {onComplete: function(){
               LayoutConfiguration.init();
               Liferay.Util.addInputType();
               Liferay.Util.addInputFocus();}
  });};
  /*总之是会生成一个Ajax请求发送到服务器，过程以后可以分析 */

用Wireshark捕捉到的Request数据如下，知道请求中含有/c/portal/render_portlet字段，那自然会送入 MainServlet处理了。

2. MainServlet.service()

/* 这里是Request首先到达的地方*/

ServletContext ctx = getServletContext();
req.setAttribute(WebKeys.CTX, ctx);
PortletRequestProcessor portletReqProcessor = PortletRequestProcessor.getInstance(this, moduleConfig);
ctx.setAttribute(WebKeys.PORTLET_STRUTS_PROCESSOR, portletReqProcessor);
callParentService(req, res);
/* 调用ActionServlet.service()，由于在ActionServlet中没有覆盖service方法，所以 MainServlet 的super.service() 追溯到HttpServlet 的service方法 */

3. HttpServlet.service()

if (method.equals(METHOD_GET)) { ,,,
} else if (method.equals(METHOD_POST)) {
  doPost(req, resp);
} else if (method.equals(METHOD_PUT)) {
  doPut(req, resp); 
} else if (method.equals(METHOD_DELETE)) {
  doDelete(req, resp);
} else if (method.equals(METHOD_OPTIONS)) {
  doOptions(req,resp);
} else if (method.equals(METHOD_TRACE)) {
  doTrace(req,resp);
}

/* 在 service 中，根据http的类型，分别调用 doPost, doGet, doPut, ...，由于ActionServlet中实现了doPost等方法，所以MainServlet.service()方法会传递到 ActionServlet中的doPost等方法。*/

4. ActionServlet.doPost()

process(request, response);

/* 在另外ActionServlet的不同方法中，例如doGet()，doPut()，都调用了process()方法。*/

5. ActionServlet.process()

ModuleConfig config = getModuleConfig(request);
RequestProcessor processor = getProcessorForModule(config);
if (processor == null) {
  processor = getRequestProcessor(config);
}
processor.process(request, response);

/* 最终传递到对应的Request Processor 的process()方法中去，也就是PortalRequestProcessor.process() */

6. PortalRequestProcessor.process()

public void process(HttpServletRequest req, HttpServletResponse res)
  throws IOException, ServletException {
  String path = super.processPath(req, res); //path = “/portal/render_portlet”
  ActionMapping mapping = (ActionMapping)moduleConfig.findActionconfig(path);
  super.process(req, res);
  /*由于TilesRequestProcessor中没有定义process()方法，所以调用 RequestProcessor.process() */
}

7. RequestProcessor.process()

public void process(HttpServletRequest request, HttpServletResponse response)
  throws IOException, ServletException {

  String path = processPath(request, response);
  //这里path = “/portal/render_portlet”.

  ActionMapping mapping = processMapping(request, response, path);
  //这里找到在struts-config.xml中定义的关于上面path的mapping.

  Action action = processActionCreate(request, response, mapping);
  //这里生成了RenderPortletAction.

  ActionForward forward = processActionPerform(request, response, action, form, mapping);

  processForwardConfig(request, response, forward);
}

至此，每个由 MainServlet 传递来的 Request 都能到达对应的 Action，例如 LayoutAction，RenderPortletAction，UpdateLayoutAction，由这些 Action 最终完成 Layout 和 Portlet 的呈现。这里对应的action是RenderPortletAction（由下面的struts-config.xml中定义）。

下面以RenderPortletAction为例说明进一步的action过程。在struts-config.xml这个文件中定义了action class, forward path。

<action path="/portal/layout" type="com.liferay.portal.action.LayoutAction">
  <forward name="portal.layout" path="portal.layout" />
</action>

<action path="/portal/update_layout" type="com.liferay.portal.action.UpdateLayoutAction" />

<action path=“/portal/render_portlet” type=“com.liferay.portal.action.RenderPortletAction”>
  <forward name=“/portal/render_portlet” path=“/portal/render_portlet.jsp”/>
</action>
<!-- 这里定义了由RenderPortletAction来处理”/portal/render_portlet”，而且最后要forward到” /portal/render_portlet.jsp”。所以最后会把render_portlet.jsp包含到response的页面当中-- >

那render_portlet.jsp又是如何实现最终把add content这个portlet显示出来的呢，下回接着分析。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177383

render_portlet.jsp
-------------------------

Portlet portlet = (Portlet)request.getAttribute(WebKeys.RENDER_PORTLET);
cachePortlet = PortletInstanceFactory.create(portlet, application);
cachePortlet.render(renderRequestImpl, renderResponseImpl);

CachePortlet.render()

_invoke(req, res, false);
CachePortlet._invoke()
if (action)
  _portlet.processAction(...)
else
  _portlet.render(...);

// 因为87 portlet是一个StrutsPortlet，在这里会调用StrutsPortlet.render()方法，由于StrutsPortlet和 LiferayPortlet中都没有定义render()方法，最终调用的是GenericPortlet.render()方法。

GenericPortlet.render()

response.setTitle(getTitle(request));
doDispatch(request, response);

//由于LiferayPortlet中覆盖了doDispatch()方法，所以调用的是LiferayPortlet.doDispatch()

LiferayPortlet.doDispatch()

  if (mode.equals(PortletMode.VIEW)) {
    doView(req, res);
  }
  else if (mode.equals(LiferayPortletMode.ABOUT)) {
    doAbout(req, res);
  }
  else if (mode.equals(LiferayPortletMode.CONFIG)) {
    doConfig(req, res);
  }
  .......

//由于StrutsPortlet中重载了doView, doAbout等方法，所以调用的是StrutsPortlet中的各种doXXX()方法，下面以doView()为例
// 另外有可能会有别的类型的portlet，例如liferay的JSPPortlet，从而会调用JSPPortlet.doXXX()方法。在 JSPPortlet.doView中，调用include(viewJSP, req, res);而viewJSP = getInitParameter("view-jsp");所以在这个地方就可以把该JSPPortlet定义好的view.jsp直接include 进来，没有如同StrutsPortlet的后续工作。

StrutsPortlet.doView()

include(req, res);

//StrutsPortlet中其他的doXXX()方法都会最后调用include()方法。

StrutsPortlet.include()

PortletRequestProcessor processor = _getPortletRequestProcessor(req);
processor.process(req, res);
PortletRequestProcessor.process(RenderRequest req, RenderResponse res)
//这里PortletRequestProcessor有两个process方法，一个处理RenderRequest，另一个处理ActionRequest。

HttpServletRequest httpReq = PortalUtil.getHttpServletRequest(req);
HttpServletResponse httpRes = PortalUtil.getHttpServletResponse(res);

process(httpReq, httpRes);
// 由于PortletRequestProcessor和TilesRequestProcessor中都没有重载process (HttpServletReq, HttpServletRes)，调用的是RequestProcessor的process()方法。

RequestProcessor.process(HttpServletRequest, HttpServletResponse)

String path = processPath(request, response); //这里是/layout_configuration/view
ActionMapping mapping = processMapping(request, response, path);
processForward(request, response, mapping)
processInclude(request, response, mapping)
ActionForward forward = processActionPerform(request, response, action, form, mapping);
……

protected void doInclude( String uri, HttpServletRequest request, HttpServletResponse response)
{
  RequestDispatcher rd = getServletContext().getRequestDispatcher(uri);
  rd.include(request, response);
}

portlet-custom.xml中定义了：
<portlet>
  <portlet-name>87</portlet-name>
  <display-name>Layout Configuration</display-name>
    <portlet-class>com.liferay.portlet.StrutsPortlet</portlet-class>
    <init-param>
      <name>view-action</name>
      <value>/layout_configuration/view</value>
    </init-param>
    .....
</portlet>

struts-config.xml中定义了action：

<action path="/layout_configuration/view" forward="portlet.layout_configuration.view" />

tiles-def.xml中定义了view.jsp：

<definition name="portlet.layout_configuration.view" extends="portlet.layout_configuration"> 
  <put name="portlet_content" value="/portlet/layout_configuration/view.jsp" />
</definition>

最后完成了万里长征，到达了/layout_configuration/view.jsp。

/layouot_configuration/view.jsp
-------------------------------------------

    <%
     PortletCategory portletCategory = (PortletCategory)WebAppPool.get(String.valueOf(company.getCompanyId()), WebKeys.PORTLET_CATEGORY);

     List categories = ListUtil.fromCollection(portletCategory.getCategories());

     Collections.sort(categories, new PortletCategoryComparator(company.getCompanyId(), locale));

     Iterator itr = categories.iterator();

     while (itr.hasNext()) {
      request.setAttribute(WebKeys.PORTLET_CATEGORY, itr.next());
     %>

      <liferay-util:include page="/html/portlet/layout_configuration/view_category.jsp" />

     <%
     }
     %>

/layouot_configuration/view_category.jsp
-----------------------------------------------------------

<%
itr2 = portlets.iterator();

while (itr2.hasNext()) {
  Portlet portlet = (Portlet)itr2.next();
  divId = new StringMaker();
  divId.append(newCategoryPath);
  divId.append(":");
  matcher = pattern.matcher(PortalUtil.getPortletTitle(portlet, application, locale));
  while (matcher.find()) {
    divId.append(matcher.group());
  }
%>

<div class="layout_configuration_portlet" id="<%= divId %>">
  <table border="0" cellpadding="2" cellspacing="0" width="100%">
    <tr>
      <td width="99%">
        <%= PortalUtil.getPortletTitle(portlet, application, locale) %>
      </td>
      <td align="right">
        <input type="button" value="<liferay-ui:message key="add" />"
         onClick="addPortlet('<%= plid%>', '<%= portlet.getPortletId() %>', '<%= themeDisplay.getDoAsUserId() %>');
         if (<%= !portlet.isInstanceable() %>) {
          var div = document.getElementById('<%= divId %>');
          div.parentNode.removeChild(div);
        };"
 >
      </td>
    </tr>
  </table>
</div>
<%
}
%>

在view_category.jsp 中列出了每个category中所包含的portlet列表，一旦点击了"add"按钮，会调用addPortlet()方法在页面上增加一个 portlet。在view_category.jsp中还实现了输入关键字对portlet进行过滤的功能。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177386

1. 第一步，生成 http://localhost:8080/c
Request:   GET/HTTP/1.1
Response: 
状态：HTTP/1.1 200 OK
内容：... <body onload="javascript:location.replace('/c')"> ...

解释：
在web.xml中有关于首页的定义如下，也就是说当用户敲入http://localhost:8080/所调用的页面。

web.xml
--------
<welcome-file-list>
  <welcome-file>index.html</welcome-file>
  <welcome-file>index.jsp</welcome-file>
</welcome-file-list>

在index.jsp中有如下内容，所以可以知道Response的内容如何得来。

index.jsp
----------
<%@ page import="com.liferay.portal.util.PortalUtil" %>
<html>
<head>
  <title></title>
  <meta content="0; url=<%= PortalUtil.getPathMain() %>" http-equiv="refresh">
</head>
<body onload="javascript:location.replace('<%= PortalUtil.getPathMain() %>')">
</body>
</html>

2. 第二步，生成 http://localhost:8080/c/portal/layout

Request:   GET/c HTTP/1.1
Response:
状态：HTTP/1.1 302 Moved Temporarily
头部：Location: http://10.108.10.205:8080/c/portal/layout

解释：
当服务器收到"GET/c"请求后，根据web.xml中的定义，请求会送入MainServlet进行处理。如何生成"/c/portal/layout"有待分析，以后补充，还好不影响大局。

web.xml
--------
<servlet-mapping>
  <servlet-name>MainServlet</servlet-name>
  <url-pattern>/c/*</url-pattern>
</servlet-mapping>

3. 第三步，生成 http://10.108.10.205:8080/web/guest/home
Request:   GET/c/portal/layout HTTP/1.1
Response:
状态：HTTP/1.1 302 Moved Temporarily
头部：Location: http://10.108.10.205:8080/web/guest/home

解释：
当服务器收到请求后，同样会送到MainServlet处理，然后会传递到LayoutAction, layout.jsp, portlet.jsp, TemplateProcessor, PortletColumnLogic, load_render_portlet.jsp, portlet_js.jspf，等等，很漫长的，也很有确的一个过程，后面会有单独的分析，中间仍有一些不明朗的地方，仍有待挖掘。不过不妨碍理清 Liferay的大致经络。

4. 第四步，生成网页
Request:   GET /web/guest/home HTTP/1.1
Response: 
状态：HTTP/1.1 200 OK
内容：
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\n
    <html dir="ltr">\n
    <head>\n
    <title>liferay.com - Welcome</title>\n
    <meta content="text/html; charset=UTF-8" http-equiv="content-type" />\r
    <link rel="Shortcut Icon" href="/html/themes/classic/images/liferay.ico" _fcksavedurl=""/html/themes/classic/images/liferay.ico"" />\r
    <link href="/c/portal/css_cached?themeId=classic&colorSchemeId=01&t=1203549390654" type="text/css"

rel="stylesheet" />\r
    <style type="text/css">\r
    </style>\r
    <script type="text/javascript">\r
    var themeDisplay = {\r
    getCompanyId: function() {\r
    return "10094";\r
    },\r
......

解释：
在web.xml中有定义，所以"GET /web/guest/home"请求会由FriendlyURLServlet处理。

web.xml
--------
<servlet>
  <servlet-name>FriendlyURLPublicServlet</servlet-name>
  <servlet-class>com.liferay.portal.servlet.FriendlyURLServlet</servlet-class>
  <init-param>
    <param-name>private</param-name>
    <param-value>false</param-value>
  </init-param>
  <load-on-startup>4</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>FriendlyURLPublicServlet</servlet-name>
  <url-pattern>/web/*</url-pattern>
</servlet-mapping>

在FriendlyURLServlet.service()方法中，再次将请求传递到/c/portal/layout，由LayoutAction进行后续处理。

FriendlyURLServlet.service()
-----------------------------
ServletContext ctx = getServletContext();
String mainPath = PortalUtil.PATH_MAIN;
String redirect = mainPath; //redirect = "/c/portal/layout..."
......
RequestDispatcher rd = ctx.getRequestDispatcher(redirect);
rd.forward(req, res);

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177392

1. 首先MainServlet接收这个请求，然后传递到LayoutAction。（具体怎么传递后续会介绍到）
在struts-config.xml中有定义，表明有关"/portal/layout"的请求是由LayoutAction来处理的。而在tiles-def.xml中定义"/portal/layout"最终传递到"/portal/layout.jsp"。

struts-config.xml
------------------------
<action path="/portal/layout" type="com.liferay.portal.action.LayoutAction">
  <forward name="portal.layout" path="portal.layout" />
</action>

tiles-def.xml
------------------
<definition name="portal.layout" extends="portal">
<put name="content" value="/portal/layout.jsp" />
 <put name="selectable" value="true" />
</definition>

2. 下面分析LayoutAction的简要流程

LayoutAction.execute()
--------------------------------
ThemeDisplay themeDisplay = (ThemeDisplay)req.getAttribute(WebKeys.THEME_DISPLAY);
Layout layout = themeDisplay.getLayout();

/* 加入/html/portal/layout/view/portlet.jsp 到网页*/
incluldeLayoutContent(req, res, themeDisplay, layout);

/* 加入/html/portal/layout.jsp 到网页，先portlet.jsp，后layout.jsp*/
return mapping.findForward("portal.layout");

LayoutAction.includeLayoutContent()
-----------------------------------------------------
String path = StrutsUtil.TEXT_HTML_DIR;
/* path = "/html" */

path += PortalUtil.getLayoutViewPage(layout);
/* path = "/html/portal/layout/view/portlet.jsp" */

RequestDispatcher rd = ctx.getRequestDispatcher(path);
rd.include(req, stringServletRes);

可见两个jsp文件是页面的关键所在。

/portal/layout/view/portlet.jsp
-----------------------------------------
<%
String content = LayoutTemplateLocalUtil.getContent(layoutTypePortlet.getLayoutTemplateId(),
   false, theme.getThemeId());
%>
<%= RuntimePortletUtil.processTemplate(application, request, response, pageContext, content) %>

/*****************************************************
其中content的内容通过断点调试可以知道（是什么时候生成的呢？）
<div class="columns-2" id="content-wrapper">
  <table id="layout-grid">
    <tr>
      <td class="lfr-column thirty" id="column-1" valign="top">
        $processor.processColumn("column-1")
      </td>
      <td class="lfr-column seventy" id="column-2" valign="top">
        $processor.processColumn("column-2")
      </td>
    </tr>
  </table>
</div>
*****************************************************/
/* RuntimePortletUtil.processTemplate()函数返回的是一个很长很长的字符串，就是最终用于显示页面上各个portlet的代码，下面有分析 */

RuntimePortletUtil.processTemplate()
------------------------------------------------------
TemplateProcessor processor = new TemplateProcessor(ctx, req, res, portletId);
VelocityContext vc = new VelocityContext();
vc.put("processor", processor);
// Velocity variables
VelocityVariables.insertVariables(vc, req);
vc.put("taglibLiferay", velocityTaglib);
vc.put("theme", velocityTaglib);
StringWriter sw = new StringWriter();
Velocity.evaluate(vc, sw, RuntimePortletUtil.class.getName(), content);

String output = sw.toString();
/*****************************************************
output的初始内容为：
<div class="columns-3" id="content-wrapper">
  <table id="layout-grid">
    <tr>
      <td class="lfr-column thirty" id="column-1" valign="top">
        [$TEMPLATE_COLUMN_column-1$]
      </td>
      <td class="lfr-column thirty" id="column-2" valign="top">
        [$TEMPLATE_COLUMN_column-2$]
      </td>
      <td class="lfr-column thirty" id="column-3" valign="top">
        [$TEMPLATE_COLUMN_column-3$]
      </td>
    </tr>
  </table>
</div>
*****************************************************/

Map columnsMap = processor.getColumnsMap();

while (itr.hasNext()) {
  Map.Entry entry = (Map.Entry)itr.next();
  String key = (String)entry.getKey();
  String value = (String)entry.getValue();
  output = StringUtil.replace(output, key, value);
}

/*****************************************************
如果首页面上有四个portlet，名字为A，B，C，D，其中A在左边一列上，B，C同在中间一列，D在右边一列。则output的内容为：
<div class="columns-3" id="content-wrapper">
  <table id="layout-grid">
    <tr>
      <td class="lfr-column thirty" id="column-1" valign="top">
        <div class="lfr-portlet-column" id="layout-column_column-1">
          [$TEMPLATE_PORTLET_A$]
        </div>
      </td>
      <td class="lfr-column thirty" id="column-2" valign="top">
        <div class="lfr-portlet-column" id="layout-column_column-2">
          [$TEMPLATE_PORTLET_B$]
          [$TEMPLATE_PORTLET_C$] 
        </div>
      </td>
      <td class="lfr-column thirty" id="column-3" valign="top">
        <div class="lfr-portlet-column" id="layout-column_column-3">
          [$TEMPLATE_PORTLET_D$] 
        </div>
      </td>
    </tr>
  </table>
</div>
*****************************************************/

Map portletsMap = processor.getPortletsMap();
itr = portletsMap.entrySet().iterator();
while (itr.hasNext()) {
  StringMaker sm = new StringMaker();
  processPortlet(sm, ctx, req, res, portlet, queryString, columnId, columnPos,columnCount, null);
  output = StringUtil.replace(output, "[$TEMPLATE_PORTLET_" + portlet.getPortletId() + "$]", sm.toString());

/*****************************************************
  这里每迭代一个portlet，output的内容中就添加了该portlet的view.jsp代码段落，而且还会增加portlet的标准头部和边框，如最小化，关闭等按钮及其对应的JavaScript代码。
*****************************************************/
}

return output;
/* 这个output就是在portlet.jsp中要显示的内容 */

portal.jsp
------------
<c:choose>
  <c:when test="<%= themeDisplay.isStateExclusive() %>">
    <%= request.getAttribute(WebKeys.LAYOUT_CONTENT) %>
  </c:when>
  <c:when test="<%= themeDisplay.isStatePopUp() %>">
    <liferay-theme:include page="portal_pop_up.jsp" />
  </c:when>
  <c:otherwise>
    <liferay-theme:include page="portal_normal.jsp" />
  </c:otherwise>
</c:choose>

在Liferay中没有发现portal_normal.jsp的踪影，发现portal_normal.vm似乎有点相关。portal_normal粉墨登场。

portal_normal.vm
-------------------------
#parse ($init)
<html dir="#language ("lang.dir")">
<head>
  <title>$company_name - $the_title</title>
    $theme.include($top_head_include)
    #css ($css_main_file)
    #js ($js_main_file)
    #if ($company_logo != "")
      <style type="text/css">
        #banner .logo {background: url($company_logo) no-repeat;
               height: ${company_logo_height}px;
               width: ${company_logo_width}px; }
      </style>
    #end
</head>

<body class="$css_class">
$theme.include($top_messages_include)
<div id="wrapper">
  <div id="banner">
    <div id="banner-inner">
      <h1 class="logo">
        <a href="$company_url">$company_name</a>
      </h1>
      <div id="page-search">
        $theme.journalContentSearch()
      </div>
      #parse ("$full_templates_path/dock.vm")
        #if ($update_available_url)
          <div class="popup-alert-notice">
            <a class="update-available" href="$update_available_url">#language("updates-are-available-for-liferay")</a>
          </div>
        #end
        #if ($has_navigation)
          #parse ("$full_templates_path/navigation.vm")
        #end
      </div>
    </div>

    #if ($selectable)
      $theme.include($content_include)
    #else
      <div id="content-wrapper" class="login">
        $portletDisplay.recycle()
        $portletDisplay.setTitle($the_title)
        $theme.wrapPortlet("portlet.vm", $content_include)
      </div>
    #end

    <div id="footer">
      <p class="language">$theme.language()</p>
    </div>
</div>

$theme.include($bottom_ext_include)
$theme.include($session_timeout_include)
$theme.include($sound_alerts_include)

</body>
</html>

可见关键是一些Velocity变量的值，例如$top_head_include。

init.vm
----------
#set ($bottom_ext_include = "$dir_include/common/themes/bottom.jsp")
#set ($content_include = "$dir_include$tilesContent")
#set ($session_timeout_include = "$dir_include/common/themes/session_timeout.jsp")
#set ($sound_alerts_include = "$dir_include/common/themes/sound_alerts.jsp")
#set ($top_head_include = "$dir_include/common/themes/top_head.jsp")
#set ($top_messages_include = "$dir_include/common/themes/top_messages.jsp")

可见$top_head_include就是top_head.jsp。

top_head.jsp
-------------------
<%@ include file="/html/common/themes/top_js.jspf" %>
<%@ include file="/html/common/themes/top_js-ext.jsp" %>
portal/portal-web/docroot/html/common/themes/top_js.jspf
<%
  String[] javaScriptFiles = PropsUtil.getArray(PropsUtil.JAVASCRIPT_FILES);
  for (int i = 0; i < javaScriptFiles.length; i++) {
%>
<script src="<%= themeDisplay.getPathJavaScript() %>/<%= javaScriptFiles[i] %>" type="text/javascript"></script>
<%
}
%>

那javascriptFiles又如何得到的呢？

portal.properties
------------------------
javascript.files=\
        jquery/jquery.js,\
        jquery/cookie.js,\
     
        jquery/tabs.js,\
        \
        liferay/liferay.js,\
        liferay/browser.js,\
        liferay/util.js,\
        liferay/language.js,\
        liferay/layout.js,\
        \
        liferay/ajax.js,\
        liferay/animate.js,\
        liferay/auto_fields.js,\
        liferay/color_picker.js,\
        liferay/columns.js,\
        liferay/dock.js,\
        liferay/dynamic_select.js,\
        liferay/freeform.js,\
        liferay/layout_configuration.js,......

另外还有一个很重要的properties文件值得关注：language.properties。好累啊，还有很多细节可以继续挖掘，还涉及到Velocity的一些变量的操作，休息下先。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=2177391

第 5 步 安装 Liferay Tomcat bundle

将 liferay-portal-tomcat-5.5-jdk5-4.3.4.zip 解压到指定目录，如“D:\liferay\tomcat”，运行 bin 中的 startup.bat 就可以开启 tomcat 服务器，并且运行 liferay portal web 应用。 在浏览器中输入 http://localhost:8080/，用户名为：test@liferay.com，密码为：test。

安装文件及版本
* JDK: jdk-1_5_0_14-windows-i586-p.exe
* JIKES: jikes-1.22-1.windows.zip
* ANT: apache-ant-1.7.0-bin.zip （在liferay portal 的 build-common.xml 中说明了要 1.7.0 以上）
* LIFERAY: liferay-portal-tomcat-5.5-jdk5-4.3.4.zip
* LIFERAY SOURCES: liferay-portal-src-4.3.3.zip
* ECLIPSE: Eclipse wtp-all-in-one-sdk-R-1.0.2-200604280245-win32.zip
  (将新安装的 ant1.7.0 拷贝到 Eclipse 的 plug-in 中，覆盖老的 ant1.6.5， 解决无法在Eclipse中启用 ANT 的问题)

第 1 步 安装 JDK
运行 jdk-1_5_0_14-windows-i586-p.exe，安装完成后创建一个新的系统环境变量 JAVA_HOME，值为 JDK 安装所在目录，例如 "D:\Program Files\Java\jdk1.5.0_14". 在 PATH 系统环境变量中增加 JDK 的 bin 所在位置：%JAVA_HOME%\bin;
（右键点击我的电脑，选择：属性 | 高级 | 环境变量 | 新建）

第 2 步 安装 ANT
将 apache-ant-1.7.0-bin.zip  文件解压到目的地，例如 "D:\liferay\apache-ant-1.7.0"，创建环境变量 ANT_HOME，为 ANT 的安装目录。在 PATH 环境变量中增加 ANT 的 bin 所在位置：%ANT_HOME%\bin

第 3 步 安装 JIKES
将 jikes-1.22-1.windows.zip文件解压到目的地，例如 "D:\liferay\jikes-1.22"，创建环境变量 JIKES_HOME，为 JIKES 的安装目录，在 PATH 环境变量中增加 JIKES 的 bin 所在位置：%JIKES_HOME%\bin

第 4 步 验证
在 command line 中分别运行 java –version，ant –version，jikes –version，如果输出结果正确，则说明安装配置正确。

当我们再对 liferay 源代码进行研究或者对某个类进行修改的时候很不方便，所以我们需要搭建一个开发环境，这样在修改 liferay 源代码的时候就更加方便。下面我们会一步步搭建 liferay 的开发环境。

一、 准备工作

1 、下载下列文件，下载步骤这里省略：

      jdk-1_5_0_06-windows-i586-p.exe

      liferay-portal-tomcat-jdk5-4.0.0.zip

      liferay-portal-src-4.0.0.zip

      liferay-portal-sql-4.0.0.zip

2 、安装 JDK ，具体的安装及配置过程这里省略。

3 、我们假定 Eclipse 及 Tomcat 插件都已安装，若还没有安装，请参考相关文档准备好开发工具，这里省略该步骤。

4 、如果对 liferay 安装过程有疑问，可参考作者的另一篇文章。

      Liferay Portal学习笔记（一）：安装

二、 搭建开发环境

来定制文章内容的时候，仅有的几种页面布局并不能满足我们的需求，所以我们需要开发能够满足特定需求的页面布局。
    我们将开发一个具有下图风格的页面布局，该布局中我们指定了7个区域来分别装配portlet实现独特的页面风格。

一、编写模板文件
    我们将该页面风格名称定义为1_2_3_2 Columns，在Liferay/html/layouttpl/custom目录下新建1_2_3_2_columns.tpl文件，内容如下：

<div id="layout-content-outer-decoration">
<div id="layout-content-inner-decoration">
    <div id="layout-content-container">
      <table border="0" cellpadding="0" cellspacing="0" width="100%">
        <tr>
          <td colspan="3" valign="top">
            $processor.processColumn("column-1")
          td>
        tr>
        <tr>
          <td width="79%" valign="top">
              <table border="0" cellpadding="0" cellspacing="0" width="100%">
                <tr>
                <td width="26%" valign="top">
                  $processor.processColumn("column-2")
                td>
<td class="layout-column-spacer" width="1%">
                    <div>&nbsp;div>
                  td>
                <td width="26%" valign="top">
                  $processor.processColumn("column-3")
                td>
                  <td class="layout-column-spacer" width="1%">
                    <div>&nbsp;div>
                  td>
                <td width="26%" valign="top">
                  $processor.processColumn("column-4")
                td>
                tr>
              table>
            td>
          <td class="layout-column-spacer" width="1%">
            <div>&nbsp;div>
          td>
          <td width="20%" rowspan="2" valign="top">
            $processor.processColumn("column-5")
          td>
        tr>
        <tr>
          <td colspan="2">
            <table border="0" cellpadding="0" cellspacing="0" width="100%">
              <tr>
                <td width="50%" valign="top">
                  $processor.processColumn("column-6")
                td>
                <td width="50%" valign="top">
                  $processor.processColumn("column-7")
                td>
              tr>
            table>
            td>
        tr>
      table>
    div>
div>
div>

    文件中前三行定义的

    我们需要在 liferay-layout-templates.xml 文件中配置我们自定义的页面布局文件 1_2_3_2_columns.tpl ，为了和系统自带的布局文件区分开，我们创建扩展文件 liferay-layout-templates-ext.xml ，在该文件中指定我们的页面布局文件，当然也可以在 liferay-layout-templates.xml 文件直接增加定义。

liferay-layout-templates-ext.xml ：

xml version = " 1.0 " ?>
DOCTYPE layout - templates PUBLIC  " -//Liferay//DTD Layout Templates 4.0.0//EN "   " http://www.liferay.com/dtd/liferay-layout-templates_4_0_0.dtd " >

< layout - templates >
     < custom >
         < layout - template id = " 1_2_3_2_columns "  name = " 1-2-3-2 Columns " >
             < template - path >/ html / layouttpl / custom / 1_2_3_2_columns.tpl template - path >
         layout - template >
     custom >
layout - templates >

参数 id 定义该 template 的 ID 号， name 定义该 template 在 Add Content 中显示的名称， template-path 定义该 template 的路径名。

三、定制页面
    定制好页面风格后，需要重新启动TOMCAT，登陆系统，进入GUEST频道，点击Add Content ，在Template中将会显示我们自定义的页面布局名称1-2-3-2 Columns，选择该Template，然后在页面中添加Journal Content，按照我们自定义的布局将portlet拖拉到合适的位置，再为每个Journal Content指定Article，最后就完成了各种风格页面的定制过程。使用这个的方法，我们可以定制各种满足不同需求的页面。

的版本跟踪和发布流程的功能。
   

Liferay Portal的CMS功能是通过Journal Portlet实现的，在介绍怎样使用Journal Portlet之前，有必要理解structures、templates和articles的概念，它们是Journal portlet功能的基础。

l         Structures：定于了content的类型和数量，content的类型包括text、text area、images、selection lists等

l         Templates：确定content怎样排列或摆放

l         Articles：确定每个content包含的实际的text和images

  
    我们以下图为例定义一个content，分为三个步骤：

第一步、创建Structure，包含一下元素：一个text元素名为“headline”（对应图片1区域）、三个text area元素为名称分别为“body-text”（对应4区域）“caption-1”（对应2区域）“caption-2”（对应6区域）、两个image元素名称分别为“image-1”（对应3区域）和“image-2”（对应5区域）

添加完这些元素后的界面如下：

点击Launch Editor按钮，可以看到XML定义，也可以在此增删或修改元素及类型，内容如下：

<root>
  <dynamic-element name='headline' type='text'>dynamic-element>
  <dynamic-element name='body-text' type='text_area'>dynamic-element>
  <dynamic-element name='caption-1' type='text_area'>dynamic-element>
  <dynamic-element name='caption-2' type='text_area'>dynamic-element>
  <dynamic-element name='image-1' type='image'>dynamic-element>
  <dynamic-element name='image-2' type='image'>dynamic-element>
root>

第二步、创建 Template ，添入 ID 、 Name 、 Description 信息后，在 Structure 一栏选择上一步创建的 Structure （这里为 test ）

然后点击 Launch Editor 按钮，打开 Template 编辑窗口，按照所需要的格式定义 Template ，如下：

xml version = " 1.0 " ?>

< xsl:stylesheet xmlns:xsl = " http://www.w3.org/1999/XSL/Transform "  version = " 1.0 " >   
   < xsl:output method = " html "  omit - xml - declaration = " yes " />   
   < xsl:template match = " / " >  
     < table cellpadding = " 0 "  cellspacing = " 0 "  border = " 0 "  width = " 100% " >  
       < tr >  
         < td colspan = " 2 " >
           < xsl:value - of
 disable - output - escaping = " yes "  select = " root/dynamic-element[@name='headline']/dynamic-content " />
         td >
       tr >
       < tr >
         < td >
           < img >  
             < xsl:attribute name = " src " >  
               < xsl:value - of 
disable - output - escaping = " yes "  select = " root/dynamic-element[@name='image-1']/dynamic-content " />  
             xsl:attribute >  
           img >
         td >
         < td >
           < xsl:value - of 
disable - output - escaping = " yes "  select = " root/dynamic-element[@name='caption-1']/dynamic-content " />
         td >
       tr >
       < tr >
         < td colspan = " 2 " >
           < xsl:value - of 
disable - output - escaping = " yes "  select = " root/dynamic-element[@name='body-text']/dynamic-content " />
         td >
       tr >
       < tr >
         < td >
           < xsl:value - of 
disable - output - escaping = " yes "  select = " root/dynamic-element[@name='caption-2']/dynamic-content " />
         td >
         < td >
           < img >  
             < xsl:attribute name = " src " >  
               < xsl:value - of 
disable - output - escaping = " yes "  select = " root/dynamic-element[@name='image-2']/dynamic-content " />  
             xsl:attribute >  
           img >
         td >
       tr >
     table >  
   xsl:template >  
xsl:stylesheet >

下面对该文件进行说明：

1 、这里的 @name=’ 名称 ’ 必须要和第一步中创建 Structure 中的元素名称一致，页面格式根据需求使用 HTML 语言定义即可。

2 、对 text 、 text area 类型的元素输出时的格式如下：

disable-output-escaping="yes" select="root/dynamic-element[@name='caption-2']/dynamic-content"/>

1、  对 image 类型的元素输出时的格式如下：

disable-output-escaping="yes" select="root/dynamic-element[@name='image-2']/dynamic-content"/>

的定制。

通过以上三个步骤，我们就实现了定制content的功能。使用Journal Portlet，我们可以定制任何不同风格的content来展示必要的信息。

1）下载并安装 JDK1.5

1、  下载并安装 Windows Platform J2SE(TM) Development Kit 5.0 Update ，下载网址 http://java.sun.com/j2se/1.5.0/download.jsp

2、  在控制面板 --> 系统 --> 高级选项 --> 环境变量，新增一个用户变量 JAVA_HOME 并指向 JDK 的安装目录

2）   下载并安装 Liferay Portal

1.         下载并安装 Liferay Portal Professional 4.0.0 (Bundled with Tomcat and JDK 5.0), 下载网址 http://www.liferay.com/web/guest/download

2.         解压缩到一个目录，并确保硬盘上有足够的空间，我们称这个目录为 TOMCAT_HOME

3）   启动 TOMCAT

到 TOMCAT/bin 目录下，运行 startup.bat 。

你的 Apache Tomcat server 能够编译并运行 Liferay Portal 。默认情况下， portal 使用自带的 HSQL 数据库。在浏览器中输入 http://localhost:8080 ，将会看见 portal 首页。

二、  专业安装

1）   下载并安装 JDK1.5

1、  下载并安装 Windows Platform J2SE(TM) Development Kit 5.0 Update ，下载网址 http://java.sun.com/j2se/1.5.0/download.jsp

2、  在控制面板 --> 系统 --> 高级选项 --> 环境变量，新增一个用户变量 JAVA_HOME 并指向 JDK 的安装目录

2）   下载并安装 TOMCAT

1、  下载 apache-tomcat-5.5.17.zip 并解压缩到一个目录，我们称这个目录为 TOMCAT 。

3） 下载并安装 Liferay Portal

1、  下载 liferay-portal-4.0.0.war, 下载网址 http://www.liferay.com/web/guest/download

2、  解压缩 liferay-portal-4.0.0.war 到 TOMCAT 目录下并改名为 liferay ，然后将 liferay/WEB-INF/lib 下除 util-taglib.jar 外的其他 jar 包剪切到 TOMCAT/common/lib/ext 下

3、  在 TOMCAT/conf/Catalina/localhost 目录下，删除该目录下已有的文件，然后新建 ROOT.xml 文件（这里的 ROOT 必须是大写）

ROOT.xml ：

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

        < Resource

              name = " jdbc/LiferayPool "

              auth = " Container "

              type = " javax.sql.DataSource "

              driverClassName = " org.hsqldb.jdbcDriver "

              url = " jdbc:hsqldb:test "

              username = " sa "

              password = ""

              maxActive = " 20 "

        />

        < Resource

              name = " mail/MailSession "

              auth = " Container "

              type = " javax.mail.Session "

              mail.transport.protocol = " smtp "

              mail.smtp.host = " localhost "

        />

        < Realm 

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

              appName = " PortalRealm "

              userClassNames = " com.liferay.portal.security.jaas.PortalPrincipal "

              roleClassNames = " com.liferay.portal.security.jaas.PortalRole "

              debug = " 99 "

              useContextClassLoader = " false "

        />

Context >

4、 在TOMCAT/conf目录下，新建jaas.config文件

jaas.config ：

PortalRealm {

 com.liferay.portal.security.jaas.PortalLoginModule required;

};

5、  修改 TOMCAT/conf 目录下 catalina.properties 文件中的下面一段：

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

6、  修改 TOMCAT/bin 目录下 catalina.bat 文件，增加下面内容：

rem ----- Execute The Requested Command ---------------------------------------

set JAVA_OPTS=-Xms128m -Xmx512m -Dfile.encoding=UTF8 -Duser.timezone=GMT+08 -Djava.security.auth.login.config=%CATALINA_HOME%/conf/jaas.config

7、  到 TOMCAT/bin 目录下，运行 startup.bat 。在浏览器中输入 http://localhost:8080 ，将会看见 portal 首页。

三、  连接数据库

1） 连接 HSQLDB

修改 TOMCAT/conf/Catalina/localhost/ROOT.xml 文件并将 SQL SERVER 驱动包 hsql.jar 拷贝到 TOMCAT/common/lib/ext 下

              name="jdbc/LiferayPool"

              auth="Container"

              type="javax.sql.DataSource"

              driverClassName="org.hsqldb.jdbcDriver"

              url="jdbc:hsqldb:test"

              username="sa"

              password=""

              maxActive="20"

       />

2）   连接 SQL SERVER

修改 TOMCAT/conf/Catalina/localhost/ROOT.xml 文件并将 SQL SERVER 驱动包 jtds-1.2.jar 拷贝到 TOMCAT/common/lib/ext 下

              name="jdbc/LiferayPool"

              auth="Container"

              type="javax.sql.DataSource"

              driverClassName="net.sourceforge.jtds.jdbc.Driver"

              url="jdbc:jtds:sqlserver://localhost:1433;DatabaseName=lportal4"

              username="sa"

        password="sa"

        maxActive="100"

       />

Tomcat 5.5.2 下部署 Liferay 4.4.1

1、 下载Tomcat 5.5.2

2、 下载liferay-portal-tomcat-5.5-jdk5-4.4.1.zip 在www.sourceforge.org 上找

3、 解压

4、 修改%tomcat_home%"bin"catalina.bat

在rem ----- Execute The Requested Command ---------------------------------------下面加入：

set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx1024m -XX:MaxPermSize=128m -Dfile.encoding=UTF8 -Duser.timezone=GMT -Djava.security.auth.login.config="%CATALINA_HOME%/conf/jaas.config"

5、 拷贝liferay-portal-tomcat-5.5-jdk5-4.4.1"common到%tomcat_home%"下

6、 拷贝liferay-portal-tomcat-5.5-jdk5-4.4.1"conf"Catalina"localhost下的ROOT.xml到%tomcat_home%"conf"Catalina"localhost下

7、 修改%tomcat_home%"conf"catalina.properties在common.loader最后面加上,${catalina.home}/common/lib/ext/*.jar使tomcat启动时候默认加载common"lib"ext下的jar包

8、 拷贝liferay-portal-tomcat-5.5-jdk5-4.4.1"conf"jaas.config到%tomcat_home%"conf"jaas.config

9、 拷贝D:"Java"liferay-portal-tomcat-5.5-jdk5-4.4.1"server"lib"*.jar到%tomcat_home%"server"bin下

10、              到这里配置完成，可以把liferay-portal-tomcat-5.5-jdk5-4.4.1"webapps下的ROOT拷贝到%tomcat_home%"webapps下，也可以到官方网站上下载liferay-portal-4.4.1.war进行部署

11、              启动%tomcat_home%"bin"startup.bat

12、              http://localhost:8080

13、              默认用户名test@liferay.org

14、              默认密码 test