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
GroupManager.getInstance().getSharedGroups(username);
这里调用了DAO,首先会从缓存列表中根据用户名获取所拥有的组。如果缓存中不存在则,查询数据库。
缓存Cache
那么group设计到了那些表呢。主要有3张表:
ofGroup、ofGroupProp、ofGroupUser
ofGroup该表就是grouo的信息内容:
ofGroupProp是group的权值属性表:
Name是权值名称,propValue是值,在上面源码中看到的onlyGroup、everybody就是值了。比如onlyGroup就是该组只对该组成员有效,everybody则是针对所有成员,所有人都能加入这个组当中去。
ofGroupUser这个是用户与组关系表。里面有三个值
组名+用户+用户所在该组的权限。
关于组的信息就说到这,解下继续源码for里面很简单了,就是封装组。
然后服务端返回客户端组消息,内容如下:
testg
从这段消息中可以知道,服务返回是以人(用户)为基础单位,告诉客户端,这个用户(也就是你的好友)所跟您在一起的组。本人认为这样并不是很好。个人认为服务端的返回应该是这样:
u1
u2
......
当然openfire并没有这么做,至少在3.8.1的版本没能这么做。这也为了迎合用户的花名册了。
Ok,查询就都这里。
控制台上的操作
当管理将一个用户添加到group中时:
1、向客户端发送新的iq,告诉它你有新的好友了,你和这个组了的一个人的好友关系是
both(互为好友为什么互为好友呢,之前说过了,凡事群组的成员都是互为好友的)。当然
这个组内有多少个成员,便会发送多少条消息。内容如下:
-
groupname#groupdesc
注意
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这个包下的内。