在Liferay Portal Professional里实现一个使用SOAP的portlet

使用的主要工具有：liferay-tomcat-3.1.0 axis-1.1。

下载得到这两个工具的zip文件夹，分别解压到两个目录里，

在环境变量里把TOMCAT_HOME, AXIS_HOME分别指向这两个文件夹根目录。

具体配置方法分别参考

Liferay

Axis

实现功能：在portlet里用SOAP访问Web Service，把得到的结果显示在Portal界面

一、配置Axis Server端

1．简单的服务程序，类似hello world，如下

package com.kevinGQ.service

HelloService.java

public class HelloService

{

public String sayHello(String name)

{

System.out.println("HelloService");

return "Axis say hello to "+name;

}

};

先把%AXIS_HOME%/webapps/axis文件夹放到%TOMCAT_HOME%/webapps/下，把编译好的HelloService.class放到axis/WEB-INF/classes里。

在server-config.wsdd里添加如下XML片断

</service>

二、写portlet的三个JSP文件（参照liferay里的weather portlet）

1. init.jsp

<%@ include file="/html/common/init.jsp" %>

<portlet:defineObjects/>

PortletPreferences prefs = renderRequest.getPreferences();

String[] names = prefs.getValues("names", new String[0]);

2. view.jsp

<%@ include file="/html/portlet/hello/init.jsp" %>

<%@ page import="com.kevinGQ.portlet.hello.util.*" %>

<%@ page import="com.kevinGQ.portlet.hello.model.Hello" %>

Welcome!

<tr>

<tr>

<td>

for(int i = 0; i < names.length; i++)

{

Hello hello = HelloUtil.getHello(names[i]);

<tr>

<td>

</td>

if(hello != null){

<%= hello.getHello() %>

}else{

<%= "null" %>

}

</font>

</td>

</tr>

}

</table>

</td>

</tr>

</table>

</td>

</tr>

</table>

3 edit.jsp

<%@ include file="/html/portlet/hello/init.jsp" %>

<form action="<portlet:actionURL><portlet:param name="struts_action" value="/hello/edit"/></portlet:actionURL>" method="post" name="<portlet:namespace />fm">

<input name="<portlet:namespace /><%= Constants.CMD %>" type="hidden" value="<%= Constants.UPDATE %>">

<tr>

<c:if test="<%= SessionMessages.contains(renderRequest, portletConfig.getPortletName() + \".doEdit\") %>">

<tr>

<td>

</td>

</tr>

<tr>

<br>

</tr>

</c:if>

<tr>

<td>

</td>

</tr>

<tr>

<td>

<textarea cols="70" name="<portlet:namespace/>names" rows="10" wrap="soft"><%= StringUtil.merge(names, "\n") %></textarea>

</td>

</tr>

<tr>

<td>

<br>

</td>

</tr>

<tr>

<input type="button" value="<bean:message key="save-settings" />" onClick="submitForm(document.<portlet:namespace />fm);">

</td>

</tr>

</table>

</td>

</tr>

</form>

</table>

三、相关的java文件

1． HelloUtil.java

package com.kevinGQ.portlet.hello.util;

import com.kevinGQ.portlet.hello.model.Hello;

import com.liferay.portal.util.WebCacheException;

import com.liferay.portal.util.WebCachePool;

import com.liferay.portal.util.WebCacheable;

import com.liferay.cache.model.Cache;

public class HelloUtil {

public static Hello getHello(String name)

throws WebCacheException{

WebCacheable wc = new HelloConverter(name);

Cache cache = WebCachePool.get(

HelloUtil.class.getName() + name, wc);

return (Hello)cache.getObject();

}

2. HelloConverter.java 实现SOAP调用的主要类，加粗的代码尤为重要，不写的话Axis Server端将会抛出错误。

package com.kevinGQ.portlet.hello.util;

import org.apache.axis.client.Call;

import org.apache.axis.client.Service;

import javax.xml.rpc.ParameterMode;

import org.apache.axis.encoding.XMLType;

import com.kevinGQ.portlet.hello.model.Hello;

import com.liferay.portal.util.WebCacheable;

import com.liferay.util.ConverterException;

import com.liferay.util.Time;

public class HelloConverter implements WebCacheable{

HelloConverter(String name){

_name = name;

}

public Object convert(String arg0) throws ConverterException {

Hello hello = new Hello();

try{

String endpoint = "http://localhost:80/axis/services/HelloService";

Service service = new Service();

Call call = (Call)service.createCall();

call.setSOAPActionURI("http://localhost:80/axis/services/HelloService#sayHello");

call.setTargetEndpointAddress(new java.net.URL(endpoint));

call.setOperationName("sayHello");

call.addParameter("param1", XMLType.XSD_STRING, ParameterMode.IN);

call.setReturnType(XMLType.XSD_STRING);

String ret = (String) call.invoke(new Object[]{_name});

hello.setHello(ret);

}catch(Exception e){

throw new ConverterException(_name+" "+e.toString());

}

return hello;

}

public long getRefreshTime(){

return _refreshTime;

}

private long _refreshTime = Time.DAY;

private String _name;

}

3. Hello.java

package com.kevinGQ.portlet.hello.model;

import java.io.Serializable;

public class Hello implements Serializable{

public Hello(){

//empty

}

public Hello(String hello){

_hello = hello;

}

public String getHello(){

return _hello;

}

public void setHello(String hello){

_hello = hello;

}

private String _hello;

}

4. EditPreferencesAction.java 对portlet的preferences进行处理的类

package com.kevinGQ.portlet.hello.action;

import javax.portlet.ActionRequest;

import javax.portlet.ActionResponse;

import javax.portlet.PortletConfig;

import javax.portlet.RenderRequest;

import javax.portlet.RenderResponse;

import javax.portlet.PortletPreferences;

import javax.portlet.ValidatorException;

import org.apache.struts.action.ActionForm;

import org.apache.struts.action.ActionForward;

import org.apache.struts.action.ActionMapping;

import com.liferay.portal.struts.PortletAction;

import com.liferay.portal.util.Constants;

import com.liferay.util.ParamUtil;

import com.liferay.util.StringUtil;

import com.liferay.util.servlet.SessionErrors;

import com.liferay.util.servlet.SessionMessages;

public class EditPreferencesAction extends PortletAction{

public void processAction(

ActionMapping mapping, ActionForm form, PortletConfig config,

ActionRequest req, ActionResponse res)

throws Exception{

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

if(!cmd.equals(Constants.UPDATE)){

return;

}

PortletPreferences prefs = req.getPreferences();

String[] names = StringUtil.split(

ParamUtil.getString(req, "names"), "\n");

prefs.setValues("names", names);

try {

prefs.store();

}

catch (ValidatorException ve) {

SessionErrors.add(req, ValidatorException.class.getName(), ve);

return;

}

SessionMessages.add(req, config.getPortletName() + ".doEdit");

}

public ActionForward render(

ActionMapping mapping, ActionForm form, PortletConfig config,

RenderRequest req, RenderResponse res)

throws Exception {

return mapping.findForward(getForward(req, "portlet.hello.edit"));

}

以上四个类经过编译后，放到％TOMCAT_HOME%/liferay/WEB-INF/classes/,如果没有classes文件夹，可以自己新建一个。

四．相关部署描述文件的修改

1、修改portlet.xml

添加如下片断

<portlet-name>70</portlet-name>

<display-name>Hello To</display-name>

<portlet-class>com.liferay.portlet.StrutsPortlet</portlet-class>

<init-param>

<name>edit-action</name>

<value>/hello/edit</value>

</init-param>

<init-param>

<name>view-action</name>

<value>/hello/view</value>

</init-param>

<expiration-cache>300</expiration-cache>

<mime-type>text/html</mime-type>

<portlet-mode>edit</portlet-mode>

</supports>

<resource-bundle>com.liferay.portlet.StrutsResourceBundle</resource-bundle>

<portlet-preferences>

<name>names</name>

<value>Kevin</value>

</preference>

</portlet-preferences>

<security-role-ref>

<role-name>Power User</role-name>

</security-role-ref>

<security-role-ref>

<role-name>User</role-name>

</security-role-ref>

</portlet>

2、修改struts-config.xml

在<action-mapping>标签下添加

</action>

3、修改liferay-portal.xml

在<portlets>标签下添加

4、修改liferay-display.xml

在<display>标签下添加

</category>

5、修改tiles-defs.xml

在<tiles-definitions>标签下添加

</definition>

</definition>

6、修改language.properties文件

由于liferay-tomcat-3.1.0里该文件是封装在portal-ejb.jar文件里，所以需要在％TOMCAT_HOME%/liferay/WEB-INF/下创建content文件夹，并在里面创建properties.languange文件

javax.portlet.title.70=HelloTo

category.myportlet=MyPortlet

要实现portlet的国际化，还需要创建一系列的properties文件，比如说简体中文的porperties_zh_CN.properties不过里面的中文用unicode编写，就不在这里说明了。

以上是我的实践所得，所有代码经过实验证实可行，这个例子简单而又有代表性，自己动手写写，受益匪浅。