XMPP在其XEP-0045扩展中定义了一个用于多用户文本会议(群聊)的协议,类似于聊天室、QQ群等。由于它作为一个标准协议在定义模型上力求完备,涵盖了现实中的绝大部分IM产品模型,而现实中的IM产品基本都只实现了XMPP定义的模型中的一个子集。
XMPP定义的一些基本概念:
房间:房间的JID标识
房客:房客的JID标识
岗位:表达了用户和房间的长期关系。XMPP定义的岗位有:所有者(owner)、管理者(admin)、成员(member)、排斥者(outcast)
角色:表达了用户和房间的临时联系,它只存在与一次访问期间。XMPP定义的角色有:主持人(moderator)、与会者(paticipant)、游客(visitor)
有关岗位、角色及其权限详细描述,参考协议规范描述(角色、岗位和权限)
pom.xml里加入 依赖引用
tigase tigase-muc 3.0.0-SNAPSHOT
config.tdsl 配置文件中加入配置:
muc(class: tigase.muc.MUCComponent) { defaultRoomConfig { 'tigase#presence_delivery_logic' = 'PREFERE_LAST' 'muc#roomconfig_persistentroom' = 'true' } }
MUC源码首先从 MUCComponent 这个组件开始分析 :
@Bean(name = "muc", parent = Kernel.class, active = true) @ConfigType(ConfigTypeEnum.DefaultMode) @ClusterModeRequired(active = false) public class MUCComponent extends AbstractKernelBasedComponent {}在
在前一节已说明怎么扫描加载相关的Class,类似这里,加载Kernel.class的时候,会把parent=Kernel.class的Bean全部加载到容器中
MUCComponent 也实现了RegistrarBean,在初始化的时候,会被调用 public void register(Kernel kernel) {} 函数进行注册工作
public abstract class AbstractKernelBasedComponent extends AbstractMessageReceiver implements XMPPService, DisableDisco, RegistrarBean {}
由于用户客户端发来的MUC消息协议为:to=
@Override public void processPacket(Packet packet) { stanzaProcessor.processPacket(packet); }
public void processPacket(Packet packet) { if (log.isLoggable(Level.FINER)) { log.finer("Received: " + packet.getElement()); } //查找是否为Response模式,则由Handler来处理 Runnable responseHandler = responseManager.getResponseHandler(packet); boolean handled; if (responseHandler != null) { handled = true; responseHandler.run(); } else { //否则调用处理包的函数 handled = this.process(packet); } if (!handled) { final String t = packet.getElement().getAttributeStaticStr(Packet.TYPE_ATT); final StanzaType type = (t == null) ? null : StanzaType.valueof(t); if (type != StanzaType.error) { throw new ComponentException(Authorization.FEATURE_NOT_IMPLEMENTED); } else { if (log.isLoggable(Level.FINER)) { log.finer(packet.getElemName() + " stanza with type='error' ignored"); } } } 。。。。。。 }
private boolean process(final Packet packet) throws ComponentException, TigaseStringprepException { boolean handled = false; if (log.isLoggable(Level.FINER)) { log.finest("Processing packet: " + packet.toString()); } //找到匹配的Module来处理 for (Module module : this.modules) { if (module.canHandle(packet)) { handled = true; if (log.isLoggable(Level.FINER)) { log.finer("Handled by module " + module.getClass()); } module.process(packet); if (log.isLoggable(Level.FINEST)) { log.finest("Finished " + module.getClass()); } } } return handled; }
例如MUC中实现的Module有如下:
这里的逻辑比较简单,也就是根据包的节类型等信息,来匹配感兴趣的处理Module,来进行处理
再来看下 module.canHandle(packet) 是怎么样找到匹配的Module来处理的:
default boolean canHandle(Packet packet) { Criteria criteria = getModuleCriteria(); return criteria != null && criteria.match(packet.getElement()); }
private final String[] names;
private final String[] xmlns;
@Override public boolean ElemPathCriteria.match(Element element) { //判断packet的名字如iq是否和本module中定义name一致 boolean match = element.getName().equals(names[0]); if (match && xmlns[0] != null) {
//并且判断命名空间是否一致 match &= xmlns[0].equals(element.getXMLNS()); } Element child = element; int i = 1;
//例如packet则name为数组{"iq","set"},前面判断了iq,这里判断set是否一致,如果还存在子节点,则依次比较是否一致 for (; i < names.length; i++) { String n = names[i]; String x = xmlns[i]; // child = child.getChildStaticStr(n, x); match &= child != null; if (!match) { return match; } } // TODO Auto-generated method stub return match; } xxx
例如针对出muc的
@Bean(name = PresenceModuleImpl.ID, parent = MUCComponent.class, active = true) public class PresenceModuleImpl extends AbstractMucModule implements PresenceModule { protected static final Logger log = Logger.getLogger(PresenceModule.class.getName()); private static final Criteria CRIT = ElementCriteria.name("presence"); }