IBM Portal 开发系列讲座：

开发登录并读取OA用户邮箱信息的portlet

IBM China SoftWare Development Lab 郑文平

内容简介：

我们用ibm自带的开发工具WSAD（已安装portlet toolkit包），开发一个Portlet，实现以下功能：
l 用户从这个portlet登录，登录成功后读取该用户在OA服务器上的邮件系统，并返回个人邮件信息、欢迎信息，转入并显示在指定页面；
l 用户不能从Portal系统原登录页面登录。即：如果用户验证失败，系统将返回到该登录portlet，而非系统自带的登录页面；
l 用户可以从这个portlet直接进入到指定的任意逻辑、物理页面。

其数据流转是这样的：

[开发过程]

1、首先编写这个类，用来读取OA系统中任一用户的邮件系统：

package youjiantishi;

/**
* 这个类用来读取某一用户的邮件内容：
*
* 维护：zhengwp@dhcc.com.cn 郑文平
*
* 编码：赵建业 时间：2004年11月
*/

import java.util.*;
import java.io.*;
import javax.mail.*;
import javax.mail.event.*;
import javax.mail.internet.*;
import javax.activation.*;

public class msgOAshow {

static String protocol;
static String host = null;
static String user = null;
static String password = null;
static String mbox = null;
static String url = null;
static int port = -1;
static boolean verbose = false;
static boolean debug = false;
static boolean showStructure = false;
static boolean showMessage = false;
static boolean showAlert = false;
static boolean saveAttachments = false;
static int attnum = 1;
static int dhcc_totalmsg=0;
static int dhcc_newmsg=0;

public int get_total()
{
return dhcc_totalmsg;
}
public int get_new()
{
return dhcc_newmsg;
}

public msgOAshow()
{
java.io.InputStream inputstream = getClass().getResourceAsStream("mailaddress.properties");
Properties properties = new Properties();
try
{
properties.load(inputstream);
}
catch(Exception exception)
{
System.err.println("Can not read the properties file. Make sure db.properties is in the CLASSPATH");
return;
}
host = properties.getProperty("address", "localhost");
protocol=properties.getProperty("protocol", "pop3");
mbox=properties.getProperty("mbox", "INBOX");

}

public static int getEmailMain(String argv[]) {
int msgnum = -1;
int optind;
user=argv[0];
password=argv[1];

try {

// Get a Properties object
Properties props = System.getProperties();

// Get a Session object
Session session = Session.getInstance(props, null);
session.setDebug(debug);


// Get a Store object
Store store = null;
if (url != null) {
URLName urln = new URLName(url);
store = session.getStore(urln);
if (showAlert) {
store.addStoreListener(new StoreListener() {
public void notification(StoreEvent e) {
String s;
if (e.getMessageType() == StoreEvent.ALERT)
s = "ALERT: ";
else
s = "NOTICE: ";
//System.out.println(s + e.getMessage());
}
});
}
store.connect();
} else {
if (protocol != null)
store = session.getStore(protocol);
else
store = session.getStore();

// Connect
if (host != null || user != null || password != null)
store.connect(host, port, user, password);
else
store.connect();
}


// Open the Folder

Folder folder = store.getDefaultFolder();
if (folder == null) {
//System.out.println("No default folder");
//System.exit(1);
return -1;
}

if (mbox == null)
mbox = "INBOX";
folder = folder.getFolder(mbox);
if (folder == null) {
//System.out.println("Invalid folder");
//System.exit(1);
return -1;
}

// try to open read/write and if that fails try read-only
try {
folder.open(Folder.READ_WRITE);
} catch (MessagingException ex) {
folder.open(Folder.READ_ONLY);
}
int totalMessages = folder.getMessageCount();

if (totalMessages == 0) {
//System.out.println("Empty folder");
folder.close(false);
store.close();
dhcc_totalmsg=0;
dhcc_newmsg=0;
return 0;
//System.exit(1);
}

int newMessages = folder.getNewMessageCount();
System.out.println("Total messages = " + totalMessages);
System.out.println("New messages = " + newMessages);
//System.out.println("-------------------------------");
dhcc_totalmsg=totalMessages;
dhcc_newmsg=newMessages;



folder.close(false);
store.close();
} catch (Exception ex) {
System.out.println("Oops, got exception! " + ex.getMessage());
//ex.printStackTrace();
//System.exit(1);
return -2;
}
return 0;
}


}

2、用WSAD开发一个使用凭证保险库的portlet，最好选用共享保险槽。接下来，在Portlet的View.jsp页面中我们提供用户登录表单（表单源代码略）：
<wps:if loggedIn="no"> //如果用户没有登录，我们显示为登录表单：

该表单接收到用户名和密码后，提交到ChenkLogin.jsp文件。
<wps:if loggedIn="yes"> //当用户登录后，调用这个类读取OA系统：
<jsp:useBean id="msgOAshow" scope="page" class="youjiantishi.msgOAshow"/>
<%
String MyName=(String)(session.getAttribute("userid"));
String MyPass=(String)session.getAttribute("password");
String argv[]=new String[2];
argv[0]=MyName;
argv[1]=MyPass;
boolean b_flag=false;
int i=msgOAshow.getEmailMain(argv);
if (i!=0)
{
//out.println("读取用户时发生错误！");
b_flag=true;
}
else
{
b_flag=false;
}
%>
然后，将读到的内容显示出来（源代码略），并添加欢迎信息：

图：获取该用户的邮箱信息，并显示出来。

我们在这个jsp页面上显示出该用户的邮箱信息，并显示欢迎该用户的字样。该欢迎信息是这样获取的：
l 首先，引入wps标签库：
<%@ taglib uri="/WEB-INF/tld/engine.tld" prefix="wps" %>
引入该标签库后，我们就可以使用其中的标签了，比如上面用到的：
<wps:if loggedIn="no"> //当用户没有登录时。
</wps:if>
l 我们引入欢迎标签：welcome：
<wps:text key="welcome" bundle="nls.engine">
<wps:textParam><wps:user attribute="givenName"/></wps:textParam>
</wps:text>
我们必须在wps包内找到名字为nsl.engine的标签文件，并添加或者修改键值为welcome的标签，并设置成我们要求的格式。这部分具体开发内容同于一般的标签开发，这里不再赘述。有兴趣的朋友可以自己查找资料研究，也可以与作者讨论。
3、新建checklogin.jsp，用来将用户信息提交到portal系统，实现单点登录。
l 新建一个表单，用来将用户信息提交到Portal系统的登陆action。
<form method="POST" action='/wps/portal/!ut/p/.cmd/li' name="LoginPage"> //
<table width="196" height="150" cellspacing="0">
<tr>
<%
String username=request.getParameter("userid");
String password=request.getParameter("password");
%>
<td>
<input name="userid" type="hidden" value="<%=username%>">
</td>
<td>
<input name="password" type="hidden" value="<%=password%>">
</td>
</tr>
</ta ble>
</form>
这个表单用来将提取到的用户信息，提交到portal系统的login系统。其中这里的action我们先使用了编译后的代码，如果您重装了Portal系统，您必须更改此portlet的选项，以符合portal系统登陆要求。读到这里，如果您是一个标签方面的高手，您可能已经猜到了更好的解决方案。是的，将这个portelt切换到配置模式，不如直接引入wps相应地标签库，使用一个简单的标签，就可以用键值将之写死，这些内容实现起来比较麻烦，笔者将在以后的相关文章中详细介绍，有兴趣的朋友，可以关注我的专栏。
l 其他该注意的问题：
到这里该Portlet可以算是开发完了，这里提醒开发者该注意的问题：
1）Portal系统的action处理完用户登录后，会返回提交者，即：checklogin.jsp。这是我们所不希望的，因为系统一旦返回到checklogin，checklogin会再次提交！是的，您已经想到了，这会生成一个死循环，计算机的声卡会发出啪啪啪的声音，就是这个原因造成的。解决这个问题，实际上非常简单，我们可以在session里设置一个开关，如果checklogin没有提交过，就打开这个开关，让系统提交；一旦提交过了，就把这个开关关死，死循环的问题就OK了。参考代码如下：
if (my_flagid==null)
my_flagid="";
if (my_flagid.equals("0"))
{
session.setAttribute("b_getPortaPass","1");
…….

2)如果登录成功，我们可以将location转向到myportal的任何页面，
如果登录不成功，系统会向用户要Session,自然会重定向到登录叶面，这样，我们的设计意图也就达到了。


作者简介：郑文平，“神狐”软件工作室创立者，IBM WebSpher Portal产品开发人员，原北京东华合创软件院软件工程师，Portal信息化专员，长期从事Portal（尤其是IBM Websphere Portal）开发，曾参与并引领了北京驰普企业门户、山东新汶矿务局远程调度系统、中国石化齐鲁公司综合数据平台、北京供电局虚拟门户产品，北京航信企业门户等多个Portal项目的开发。
如果您有以下需要，欢迎您与SagFox SoftWare 联系：
1、如果您的公司有IBM WebSpher Portal 项目需要实施但缺少必需的技术力量，而您又不愿安排工程师们边学习边开发而影响项目质量，欢迎您把项目外包给 SagFox SoftWare，或者以项目合作的方式联合开发。
2、如果您们是一个Java 开发者并打算投身Portal领域，欢迎您接受 SagFox SoftWare 针对公司技术人员的开发培训，SagFox SoftWare 同时开展针对个人的技术指导与职业规划，助您谋得高薪。
3、如果您是一个娴熟的Portal开发者，欢迎您加盟SagFox SoftWare，我们的团队正在飞速发展。我们也欢迎入门者加入我们的讨论组，SagFox SoftWare 尽力解答欠成熟开发者的提问，并以提携后起者为乐趣，希望国内的门户实施少一些“豆腐渣”工程，我们愿贡献一点力量。
您可以通过zhengwp@cn.ibm.com 或者 zhengwenping@126.com 与SagFox SoftWare取得联系。本文作者的msn是： zhengwp@cn.ibm.com