OpenFire源码学习之七:组与花名册

Group

在openfire中的gorop——组,也可以理解为共享组。什么叫共享组呢。当有一个组名字为“学习组”,当其他用户加入这个组的时候,那么他们会自动成为相互的好友。实际上

在openfire内,用户的好友不仅仅只是花名册,还包括共同在一个组的成员。当然这个组有很多好处。比如,那我们公司做的一个项目为例。我们做学校老师与家里沟通的的APP,需要预先将老师和家长做成好友,这个就不要重新让用户手动去添加了,可以直接生成放在用一个组内。当然,还有很多其他的用户。大家随意发挥吧,呵呵。。。

Group通讯

这里所讲的group通讯主要是将客户端与服务端之间基于group之上的操作通讯。

比如服务端的CRUD操作,如何知会给客户端。目前据本人了解,openfire提供的客户端版本中都没让用户自己操作gruop的功能,我想在客户端也并不需要这些功能。下面几个小节就主要讲讲服务端的操作。

终端查询

客户端发送查询的命令如下:


      
      

服务端怎么处理呢?

IQSharedGroupHandler,就是在针对客户端的查询命令处理。该类位于org.jivesoftware.openfire.handler下。

源码如下:

 @Override
	public IQ handleIQ(IQ packet) throws UnauthorizedException {
        IQ result = IQ.createResultIQ(packet);
        String username = packet.getFrom().getNode();
	//以下是一些校验。。。 此处省略....
	//这里才开始处理。
        Collection groups = rosterManager.getSharedGroups(username);
        Element sharedGroups = result.setChildElement("sharedgroup",
                "http://www.jivesoftware.org/protocol/sharedgroup");
        for (Group sharedGroup : groups) {
            String displayName = sharedGroup.getProperties().get("sharedRoster.displayName");
            if (displayName != null) {
                sharedGroups.addElement("group").setText(displayName);
            }
        }
        return result;
    }

从源码中,可以看书,groups集合从用户的花名册中得到。RosterManager。

那么就一起看看源码吧

 public Collection getSharedGroups(String username) {
        Collection answer = new HashSet();
        Collection groups = GroupManager.getInstance().getSharedGroups(username);
        for (Group group : groups) {
            String showInRoster = group.getProperties().get("sharedRoster.showInRoster");
            if ("onlyGroup".equals(showInRoster)) {
                if (group.isUser(username)) {
                    // The user belongs to the group so add the group to the answer
                    answer.add(group);
                }
                else {
                    // Check if the user belongs to a group that may see this group
                    Collection groupList = parseGroups(group.getProperties().get("sharedRoster.groupList"));
                    for (Group groupInList : groupList) {
                        if (groupInList.isUser(username)) {
                            answer.add(group);
                        }
                    }
                }
            }
            else if ("everybody".equals(showInRoster)) {
                // Anyone can see this group so add the group to the answer
                answer.add(group);
            }
        }
        return answer;
    }

那么这里比较重要的方法:

 Collection groups =

GroupManager.getInstance().getSharedGroups(username);

这里调用了DAO,首先会从缓存列表中根据用户名获取所拥有的组。如果缓存中不存在则,查询数据库。

缓存Cache groupMetaCache;

那么group设计到了那些表呢。主要有3张表:

ofGroup、ofGroupProp、ofGroupUser

ofGroup该表就是grouo的信息内容:

OpenFire源码学习之七:组与花名册_第1张图片

ofGroupProp是group的权值属性表:

Name是权值名称,propValue是值,在上面源码中看到的onlyGroup、everybody就是值了。比如onlyGroup就是该组只对该组成员有效,everybody则是针对所有成员,所有人都能加入这个组当中去。

ofGroupUser这个是用户与组关系表。里面有三个值


组名+用户+用户所在该组的权限。

关于组的信息就说到这,解下继续源码for里面很简单了,就是封装组。

然后服务端返回客户端组消息,内容如下:


     
         testg 
     

从这段消息中可以知道,服务返回是以人(用户)为基础单位,告诉客户端,这个用户(也就是你的好友)所跟您在一起的组。本人认为这样并不是很好。个人认为服务端的返回应该是这样:


u1
u2
......

当然openfire并没有这么做,至少在3.8.1的版本没能这么做。这也为了迎合用户的花名册了。

Ok,查询就都这里。

控制台上的操作

当管理将一个用户添加到group中时:

1、向客户端发送新的iq,告诉它你有新的好友了,你和这个组了的一个人的好友关系是

  both(互为好友为什么互为好友呢,之前说过了,凡事群组的成员都是互为好友的)。当然

   这个组内有多少个成员,便会发送多少条消息。内容如下:


  
    
      groupname#groupdesc
    
  

  注意groupname#groupdesc这里面有个“#”这个是本人自己加的。因为我们项目中把groupname作为了id,desc则为组的名称。实际上我们没有用到描述这个字段。

2、当管理台删除一个用户的时候,步骤个上面一样。发送的消息内容如下:


  
    
  

它只是告诉你,你没这个好友了。当然这个消息是删除正在在线状态的用户。删除其他用户的消息,这里就不在啰嗦了。

Group事件

在控制台操作的group出发的事件由GroupManager控制。在GroupManager的构造函数中添加了监听事件。有7个监听事件。

1、groupCreated。创建group

1)添加gourp权值属性

2)加入group缓存

3)删除元缓存

 

2、groupDeleting 删除group

1)发送iq消息给组内成员“jabber:iq:group:delete

2)从缓存中移除

3)从db中移除

......


花名册

处理流程

终端获取流程:

1、终端发送




2、系统返回

 

    
         testg 
    

    我的兄弟
    testg 


      军机处

   

走进源码看IQRosterHandler的处理。IQRosterHandler是服务端对用户花名册的处理。

IQRosterHandler位于org.jivesoftware.openfire.handler。

IQRosterHandler中的handleIQ方法,根据客户端的IQ请求中的to属性判别用户是查询还是删除。

查询:

if (recipientJID == null || recipientJID.getNode() == null ||
                    !UserManager.getInstance().isRegisteredUser(recipientJID.getNode())) {
                returnPacket = manageRoster(roster);
            }

manageRoster方法,有两个判断

1、if (IQ.Type.get == type) 这里从缓存中查找用户好友,并封装消息

2、else if (IQ.Type.set == type)由分为两种

1)removeItem移除列表

2)createRosterItem创建列表

removeRosterItem:删除用户列表。并广播整个列表好友删除消息。

组与花名册就先到这,以后还补充。这块还是比较简单。主要看handle这个包下的内。













转载于:https://www.cnblogs.com/huwf/p/4273361.html

你可能感兴趣的:(OpenFire源码学习之七:组与花名册)