网站地图
【www.gdgbn.com--php安全】
MSN Messenger这一由世界头号软件商-微软公司开发的即时通讯软件，凭借其与windows操作系统和整个微软产品家族的紧密结合，简单实用、性能稳定、世界通用等特点，很快被中国用户接受，目前其用户正在以几何数字增长。但是让开发者雀跃的是该软件同时也提供了开放的API以及开放的通讯协议。
著名的MSN Plus就是一款利用其API开发的用于扩展MSN Messenger功能的插件。而我们今天要介绍的jMSN则是封装了MSN Messenger开放的通讯协议的JAVA API，通过这个API开发者完全可以使用JAVA语言模拟出MSN Messenger软件，API的作者也提供一个用JAVA语言编写的在某方面功能甚至比MSN Messenger还强大的MSN 客户端软件。
由于采用了跨平台的JAVA语言开发，因此该软件也可同时运行于其他操作系统，目前已经经过测试的有各种Linux系统以及Mac OS上，当然还有视窗操作系统。
jMSN是一个韩国人开发的开放源码的API，可以从http://sourceforge.net/projects/jmsn/站点上下载，该项目的首页基本上以韩文为主，包括它的API文档的说明都是韩文。这个让我非常头疼，不过没有关系，因为jMSN非常简单，如果没有什么特殊情况下不看那些说明也没有关系。
jMSN的主页中提供两个部件供下载如下图所示，其中jmsn是一个完整的JAVA应用程序，下载解压后可以直接运行，运行的界面跟微软的MSN Messenger很类似，包括操作上都非常一致，如果你的操作系统是Linux或者其他那都可以直接用它来替代微软的程序。另外一个是msnm-lib，这个就是我们今天要介绍的API，它仅仅是一个开发包，在jmsn组件中已经包含了这个包。
你可能想先体验一下jmsn自带的程序看看到底能完成什么样的功能吧？解压jmsn压缩包后的目录中会有一个可执行文件，不过如果你的JDK不是使用安装程序安装的，建议你不用执行它，它会找不到jre的。
你可以使用命令行来启动这个程序，这样做有个好处是你还可以看到运行中打印出来的信息。
启动jMSN的命令：
java -jar jmsn.jar
jMSN的登录界面以及主窗口如下图所示：
应该说这个界面跟MSN Messenger是非常类似的。用户可以通过它发送和接收消息等。在启动jMSN的命令行窗口中可以看到jMSN与服务器之间通讯的详细信息。
前面我们主要在介绍j MSN大概的情况，介绍它能完成什么样的功能。
下面我们开始来了解怎么利用jMSN自带的API：
msnm-lib来实现这些功能。
下图是msnm-lib与jMSN包括MSN系统之间的关系，也就是说我们可以通过msnm-lib来完成与MSN服务器之间的通讯而不需要我们去操心具体的通讯协议的细节。事实上msnm-lib给我们做了更多的事情使得我们使用msnm-lib来开发一个MSN应用程序变得非常的简单，这也就是我前面提到的我们完全可以不去可能它所提供的韩文API文档的缘故，因为使用它实在是太简单了。
/* * Created on 2003-11-21 by Liudong */ package jmsn.demo; import rath.msnm.MSNMessenger; import rath.msnm.SwitchboardSession; import rath.msnm.UserStatus; import rath.msnm.entity.MsnFriend; import rath.msnm.event.MsnAdapter; import rath.msnm.msg.MimeMessage; /** * MSN演示程序 * @author Liudong */ public class MSNDaemon extends Thread { private static MSNMessenger msn; public static void main(String[] args) { msn = new MSNMessenger("youraccount@hotmail.com", "password"); msn.setInitialStatus(UserStatus.ONLINE); msn.addMsnListener(new MSNAdapter(msn)); msn.login(); System.out.println("Waiting for the response...."); //捕捉Ctrl+C的输入以便注销MSN的登录 Runtime.getRuntime().addShutdownHook(new MSNDaemon()); } /** * 用户中止程序执行 */ public void run() { msn.logout(); System.out.println("MSN Logout OK"); } } /** * MSN消息事件处理类 * @author Liudong */
class MSNAdapter extends MsnAdapter { MSNMessenger messenger; public MSNAdapter(MSNMessenger messenger) { this.messenger = messenger; } /** * 某人正在输入信息 */ public void progressTyping( SwitchboardSession ss, MsnFriend friend, String typingUser) { System.out.println( friend.getLoginName() + "正在输入信息..."); } /** * 收到消息的时候执行该方法 */ public void instantMessageReceived( SwitchboardSession ss, MsnFriend friend, MimeMessage mime) { System.out.print( "接收到消息：" + friend.getFriendlyName() + "->"); System.out.println(mime.getMessage()); try { //发送相同的回复信息给发送者messenger.sendMessage( friend.getLoginName(), mime); } catch (Exception e) { e.printStackTrace(); } } /** * 登录成功后执行该方法 */ public void loginComplete(MsnFriend own) { System.out.println( own.getLoginName() + " Login OK"); } /** * 登录失败后执行该方法 */ public void loginError( String header) { System.out.println( "Login Failed: " + header); } /** * 好友离线时执行该方法 */ public void userOffline(String loginName) { System.out.println("USER " + loginName + " Logout."); } /** * 好友上线时执行该方法 */ public void userOnline(MsnFriend friend) { System.out.println( "USER "+friend.getFriendlyName()+" Login."); } /** * 有人加我为好友时执行 */ public void whoAddedMe(MsnFriend friend) { System.out.println( "USER " + friend.getLoginName() + " Addme."); try { messenger.addFriend(friend.getLoginName()); } catch (Exception e) { e.printStackTrace(); } }
/** * 有人把我从好友列表中删除时执行 */ public void whoRemovedMe(MsnFriend friend) { System.out.println("USER "+friend.getLoginName()+" Remove me."); try { messenger.removeFriend(friend.getLoginName()); } catch (Exception e) { e.printStackTrace(); } } }
/* * Created on 2003-11-21 by Liudong */ package jmsn.demo; import rath.msnm.MSNMessenger; import rath.msnm.SwitchboardSession; import rath.msnm.UserStatus; import rath.msnm.entity.MsnFriend; import rath.msnm.event.MsnAdapter; import rath.msnm.msg.MimeMessage; /** * MSN演示程序 * @author Liudong */ public class MSNDaemon extends Thread { private static MSNMessenger msn; public static void main(String[] args) { msn = new MSNMessenger("youraccount@hotmail.com", "password"); msn.setInitialStatus(UserStatus.ONLINE); msn.addMsnListener(new MSNAdapter(msn)); msn.login(); System.out.println("Waiting for the response...."); //捕捉Ctrl+C的输入以便注销MSN的登录 Runtime.getRuntime().addShutdownHook(new MSNDaemon()); } /** * 用户中止程序执行 */ public void run() { msn.logout(); System.out.println("MSN Logout OK"); } } /** * MSN消息事件处理类 * @author Liudong */
* 有人把我从好友列表中删除时执行class MSNAdapter extends MsnAdapter { MSNMessenger messenger; public MSNAdapter(MSNMessenger messenger) { this.messenger = messenger; } /** * 某人正在输入信息 */ public void progressTyping( SwitchboardSession ss, MsnFriend friend, String typingUser) { System.out.println( friend.getLoginName() + "正在输入信息..."); } /** * 收到消息的时候执行该方法 */ public void instantMessageReceived( SwitchboardSession ss, MsnFriend friend, MimeMessage mime) { System.out.print( "接收到消息：" + friend.getFriendlyName() + "->"); System.out.println(mime.getMessage()); try { //发送相同的回复信息给发送者messenger.sendMessage( friend.getLoginName(), mime); } catch (Exception e) { e.printStackTrace(); } } /** * 登录成功后执行该方法 */ public void loginComplete(MsnFriend own) { System.out.println( own.getLoginName() + " Login OK"); } /** * 登录失败后执行该方法 */ public void loginError( String header) { System.out.println( "Login Failed: " + header); } /** * 好友离线时执行该方法 */ public void userOffline(String loginName) { System.out.println("USER " + loginName + " Logout."); } /** * 好友上线时执行该方法 */ public void userOnline(MsnFriend friend) { System.out.println( "USER "+friend.getFriendlyName()+" Login."); } /** * 有人加我为好友时执行 */ public void whoAddedMe(MsnFriend friend) { System.out.println( "USER " + friend.getLoginName() + " Addme."); try { messenger.addFriend(friend.getLoginName()); } catch (Exception e) { e.printStackTrace(); } }
*/
public void whoRemovedMe(MsnFriend friend) {
System.out.println("USER "+friend.getLoginName()+" Remove me.");
try {
messenger.removeFriend(friend.getLoginName());
}
catch (Exception e) {
e.printStackTrace();
}
}
}
我们自行扩展MsnAdapter的类必须告诉MSNMessenger实例知道，这也就是我们前面代码中的msn.addMsnListener(new MSNAdapter(msn)); 自行扩展MsnAdapter的类是用来处理被动消息的，例如有人给我发消息等。当我们要发送消息给别人的时候就需要用到MSNMessenger的实例，这也就是我们为什么要把MSNMessenger的实例传递给MSNAdapter的原因，因为当我们接收到任何消息时要给发送人回复一条相同的信息。
到此我们前面提出的简单功能已经完成了，读者可以在自己的机器上进行测试，运行时需要用到msnm-lib库，也就是msnm.jar文件。下图是运行时候的一个截图：
关于多人聊天
MSN有另外一个不错的功能就是多人同时聊天，msnm-lib对这个功能支持也非常好。在MsnAdapter中定义的方法instantMessageReceived的第一个参数类型为SwitchboardSession。当接收到消息时，我们可以从这个参数中获取多人聊天的一个会话标识，同时可以通过getMsnFriends来读取参与当前聊天的所有好友。当你要主动发送消息的时候你就必须从SwitchboardSession中读取所有的好友并给他们一一发送信息。
关于文件传输
可能这是我发现的关于msnm-lib的唯一不足，或者说还不够完善的部分。经过测试发现使用微软的MSN程序可以正常传输文件的两台机器用jMSN却无法传输，错误信息都是说连接超时，这两台机器不在同一个子网。相信msnm-lib对这个功能并没有进行处理。由于并没有两台直接连接Internet的机器，因此关于jMSN的文件传输一直都没有办法来做一个试验，希望新版本的msnm-lib能解决好这个问题。
总结
尽管在文件传输上有点瑕疵，但是msnm-lib所提供的功能已经非常棒了，至少在我第一眼看到它的时候心里说：没错，这就是我想要的东西！本文旨在介绍如何使用msnm-lib来完成一个简单的MSN客户端，至于如果让它在实际的应用系统中发挥作用，读者们肯定有比我更多的想法，比如说是否可以利用它来丰富客服的渠道等等，当然这些都超过我们的题目。