第四节  编写自己的Portlet类

Liferay Portal内部集成了78个Portlet，包括直接用PrintWriter输出的、调用JSP输出的、调用Servlet输出的，数据来源有直接从数据库取得的、通过Web Service取得的等等。这里，我们只讲述直接用PrintWriter输出的和调用JSP输出的，目的在于讲述如何编写自己的Portlet类。其他的与此类似，不赘述。

3.4.1  开发环境

IDE：Eclipse V3.0.1

JDK：V1.4.2_06

ANT：V1.6.2

Tomcat：V5.0（集成在Liferay Portal中）

Liferay Portal：liferay-portal-pro-3.6.0-tomcat

3.4.2  准备工作

①、安装JDK V1.4.2_06，在系统环境变量中增加变量JAVA_HOME，指向JDK安装目录。

②、安装ANT，在系统环境变量中增加变量ANT_HOME，指向ANT安装目录。

③、下载并启动Eclipse V3.0.1.

④、下载并解压缩liferay-portal-pro-3.6.0-tomcat.zip到某一文件夹，该文件夹即为{PORTAL_HOME}。

⑤、在Eclipse中新建一个Java项目，命名为TestPortal，路径为D:\TestPortal，将{PORTAL_HOME}\common\ext\portlet.jar以外部jar的形式添加到库中。下文中，D:\TestPortal将以{APP_HOME}代称。在{APP_HOME}下创建文件夹webapp、deploy、bak。项目缺省输出文件夹为{APP_HOME}\webapp\WEB-INF\classes 。

⑥、在{APP_HOME}\webapp\WEB-INF目录下创建web.xml，内容如下：

       TestPortal

⑦、在{APP_HOME}\webapp\WEB-INF下创建tld文件夹，将{PORTAL_HOME}\liferay\WEB-INF\tld/liferay-portlet.tld拷贝到创建的tld文件夹下，备用。

⑧、新建一个Java包com.educhina.portal 。

3.4.3  HelloWorldPortlet

HelloWorldPortlet类计划用单纯的PrintWriter输出Portlet标记片断。在包com.educhina.portal下新建Java类HelloWorldPortlet，这个类必须扩展自javax.Portlet.GenericPortlet类。设计让HelloWorldPortlet支持浏览和编辑两种模式，所以HelloWorldPortlet重写doView和doEdit方法。简单的代码如下：

package com.educhina.portal;

import java.io.IOException;

import javax.Portlet.GenericPortlet;

import javax.Portlet.PortletException;

import javax.Portlet.RenderRequest;

import javax.Portle.RenderResponse;

public class HelloWorldPortlet extends GenericPortlet{

       public void doView(RenderRequest req, RenderResponse res)

throws IOException, PortletException {

              res.setContentType("text/html");

              res.getWriter().println("HelloWorld!");

       }

       public void doEdit(RenderRequest req,RenderResponse res)

throws IOException,PortletException {

              res.setContentType("text/html");

              res.getWriter().println("HelloWorld!");

       }

}

doView和doEidt方法从RenderRequest取得PrintWriter对象，直接输出一个String字符“HelloWorld！”。这个String字符将作为HelloWorldPortlet的片断内容。

3.4.4  HelloJSPPortlet

HelloJSPPortlet类计划调用外部JSP输出。同样的，HelloJSPPortlet也要扩展自GenericPortlet类。HelloJSPPortlet调用getPortletConfig().getInitParameter("..")方法，取得在Portlet。xml中配置的view-jsp和edit-jsp参数值，以此确定JSP页面的具体位置。然后调用PortletRequestDispatcher的include方法，将JSP页面加载到RenderResponse。代码如下：

package com.educhina.portal;

import java.io.IOException;

import javax.Portlet.GenericPortlet;

import javax.Portlet.PortletException;

import javax.Portlet.PortletRequestDispatcher;

import javax.Portlet.RenderRequest;

import javax.Portlet.RenderResponse;

public class HelloJSPPortlet extends GenericPortlet{

public void doView(RenderRequest req, RenderResponse res)

throws IOException, PortletException {

res.setContentType("text/html");

String jspName = getPortletConfig().getInitParameter("view-jsp");

PortletRequestDispatcher rd = getPortletContext().getRequestDispatcher(jspName);

rd.include(req,res);

}

public void doEdit(RenderRequest req,RenderResponse res)

throws IOException,PortletException {

res.setContentType("text/html");

String jspName = getPortletConfig().getInitParameter("edit-jsp");

PortletRequestDispatcher rd = getPortletContext().getRequestDispatcher(jspName);

rd.include(req,res);

}

}

在{APP_HOME}/webapp目录下创建view.jsp和edit.jsp，view.jsp代码如下，edit.jsp类似：

      

This is a Sample JSP Portlet used in viewing model。 Use this as a quick way to include JSPs。