androidpn的学习研究（三）androidpn-server服务端几个类说明

AndroidPN(Android Push Notification) 是一个基于XMPP协议的Java开源推送通知实现，它包含了完整的客户端和服务端。

AndroidPN基于Openfire下的一些开源项目构建。

AndroidPN服务器包含两个部分，

一个是侦听在5222端口上的XMPP服务，负责与客户端的XMPPConnection类进行通信，作用是用户注册和身份认证，并发送推送通知消息。

另外一部分是Web服务器，采用一个轻量级的HTTP服务器，负责接收用户的Web请求。

最上层包含四个组成部分，分别是SessionManager，Auth Manager，PresenceManager以及Notification Manager。

SessionManager负责管理客户端与服务器之间的会话。

Auth Manager负责客户端用户认证管理。

Presence Manager负责管理客户端用户的登录状态。

NotificationManager负责实现服务器向客户端推送消息功能。

IQHandler消息处理器的类：

IQHandler：消息处理器抽象类。

IQAuthHandler：权限协议的消息处理类，消息的类型为：jabber:iq:auth

IQRegisterHandler：用户注册的消息处理类，消息类型为： jabber:iq:register

IQRosterHandler：用户消息交互类，消息类型为：jabber:iq:roster

PresenceUpdateHandler：用户状态展现变化处理类。内部调用，不具有类型。

NotificationManager源代码：

Java代码

1. publicclassNotificationManager{
3. privatestaticfinalStringNOTIFICATION_NAMESPACE="androidpn:iq:notification";
5. privatefinalLoglog=LogFactory.getLog(getClass());
7. privateSessionManagersessionManager;
9. /**
10. *Constructor.
11. */
12. publicNotificationManager(){
13. sessionManager=SessionManager.getInstance();
14. }
16. /**
17. *Broadcastsanewlycreatednotificationmessagetoallconnectedusers.
18. *
19. *@paramapiKeytheAPIkey
20. *@paramtitlethetitle
21. *@parammessagethemessagedetails
22. *@paramuritheuri
23. */
24. publicvoidsendBroadcast(StringapiKey,Stringtitle,Stringmessage,
25. Stringuri){
26. log.debug("sendBroadcast()...");
27. IQnotificationIQ=createNotificationIQ(apiKey,title,message,uri);
28. for(ClientSessionsession:sessionManager.getSessions()){
29. if(session.getPresence().isAvailable()){
30. notificationIQ.setTo(session.getAddress());
31. session.deliver(notificationIQ);
32. }
33. }
34. }
36. /**
37. *Sendsanewlycreatednotificationmessagetothespecificuser.
38. *
39. *@paramapiKeytheAPIkey
40. *@paramtitlethetitle
41. *@parammessagethemessagedetails
42. *@paramuritheuri
43. */
44. publicvoidsendNotifcationToUser(StringapiKey,Stringusername,
45. Stringtitle,Stringmessage,Stringuri){
46. log.debug("sendNotifcationToUser()...");
47. IQnotificationIQ=createNotificationIQ(apiKey,title,message,uri);
48. ClientSessionsession=sessionManager.getSession(username);
49. if(session!=null){
50. if(session.getPresence().isAvailable()){
51. notificationIQ.setTo(session.getAddress());
52. session.deliver(notificationIQ);
53. }
54. }
55. }
57. /**
58. *CreatesanewnotificationIQandreturnsit.
59. */
60. privateIQcreateNotificationIQ(StringapiKey,Stringtitle,
61. Stringmessage,Stringuri){
62. Randomrandom=newRandom();
63. Stringid=Integer.toHexString(random.nextInt());
64. //Stringid=String.valueOf(System.currentTimeMillis());
66. Elementnotification=DocumentHelper.createElement(QName.get(
67. "notification",NOTIFICATION_NAMESPACE));
68. notification.addElement("id").setText(id);
69. notification.addElement("apiKey").setText(apiKey);
70. notification.addElement("title").setText(title);
71. notification.addElement("message").setText(message);
72. notification.addElement("uri").setText(uri);
74. IQiq=newIQ();
75. iq.setType(IQ.Type.set);
76. iq.setChildElement(notification);
78. returniq;
79. }
80. }

其中：

发布订阅式的发送消息调用方法：

/**
* Broadcasts a newly created notification message to all connected users.
*
* @param apiKey the API key
* @param title the title
* @param message the message details
* @param uri the uri
*/
public void sendBroadcast(String apiKey, String title, String message,
String uri)；

点对点的发送消息调用方法：

/**
* Sends a newly created notification message to the specific user.
*
* @param apiKey the API key
* @param title the title
* @param message the message details
* @param uri the uri
*/
public void sendNotifcationToUser(String apiKey, String username,
String title, String message, String uri)；

创建发送消息的方法：

/**
* Creates a new notification IQ and returns it.
*/
private IQ createNotificationIQ(String apiKey, String title,
String message, String uri)；