OpenFire源码学习之六：用户注册

来源：互联网发布：淘宝怎么显示多个客服编辑：程序博客网时间：2024/05/22 06:08

用户注册

注册流程：

1、客户端进行握手给服务端发送连接消息：

<stream:stream to="192.168.2.104" xmlns="jabber:client" xmlns:stream="http://etherx.jabber.org/streams" version="1.0"></stream:stream>

2、服务端回执：

<?xml version='1.0' encoding='UTF-8'?><stream:stream xmlns:stream="http://etherx.jabber.org/streams" xmlns="jabber:client" from="hytest240" id="9fd61155" xml:lang="en" version="1.0"><stream:features><mechanisms xmlns="urn:ietf:params:xml:ns:xmpp-sasl"><mechanism>DIGEST-MD5</mechanism><mechanism>JIVE-SHAREDSECRET</mechanism><mechanism>PLAIN</mechanism><mechanism>ANONYMOUS</mechanism><mechanism>CRAM-MD5</mechanism></mechanisms><compression xmlns="http://jabber.org/features/compress"><method>zlib</method></compression><auth xmlns="http://jabber.org/features/iq-auth"/><register xmlns="http://jabber.org/features/iq-register"/></stream:features>

3、客户端发送注册申请

<iq id="69Bxy-0" to="hytest240" type="get"><query xmlns="jabber:iq:register"></query></iq>

4、服务端给出注册需要的填写的信息，相当与给客户端发送一个申请单

<iq type="result" id="69Bxy-0" from="hytest240"><query xmlns="jabber:iq:register"><username/><password/><email/><name/><x xmlns="jabber:x:data" type="form"><title>XMPP Client Registration</title><instructions>Please provide the following information</instructions><field var="FORM_TYPE" type="hidden"><value>jabber:iq:register</value></field><field var="username" type="text-single" label="Username"><required/></field><field var="name" type="text-single" label="Full name"/><field var="email" type="text-single" label="Email"/><field var="password" type="text-private" label="Password"><required/></field></x></query></iq>

5、客户端接收到服务端发送的申请单后，并填写回复：

<iq id="69Bxy-1" to="hytest240" type="set"><query xmlns="jabber:iq:register"><username>test</username><email></email><name></name><password>123456</password></query></iq>

6、注册完成后，服务端返回成功这里没有做出任何消息，仅仅只是回复。

<iq type="result" id="69Bxy-1" from="hytest240" to="hytest240/9fd61155"/>

IQRegisterHandler

IQRegisterHandler位于org.jivesoftware.openfire.handler中。该类主要处理客户端注册信息。

该类中有两个比较重要方法initialize、handleIQ。接下来看这两个方法。

initialize

该方法主要是做初始化注册模板。这个注册模板就是在上面提到的需要发送给客户端申请注册的深表表单。源码如下：

@Overridepublic void initialize(XMPPServer server) {        super.initialize(server);        userManager = server.getUserManager();        rosterManager = server.getRosterManager();        if (probeResult == null) {            // Create the basic element of the probeResult which contains the basic registration            // information (e.g. username, passoword and email)            probeResult = DocumentHelper.createElement(QName.get("query", "jabber:iq:register"));            probeResult.addElement("username");            probeResult.addElement("password");            probeResult.addElement("email");            probeResult.addElement("name");            // Create the registration form to include in the probeResult. The form will include            // the basic information plus name and visibility of name and email.            // TODO Future versions could allow plugin modules to add new fields to the form             final DataForm registrationForm = new DataForm(DataForm.Type.form);            registrationForm.setTitle("XMPP Client Registration");            registrationForm.addInstruction("Please provide the following information");            final FormField fieldForm = registrationForm.addField();            fieldForm.setVariable("FORM_TYPE");            fieldForm.setType(FormField.Type.hidden);            fieldForm.addValue("jabber:iq:register");            final FormField fieldUser = registrationForm.addField();            fieldUser.setVariable("username");            fieldUser.setType(FormField.Type.text_single);            fieldUser.setLabel("Username");            fieldUser.setRequired(true);            final FormField fieldName = registrationForm.addField();         fieldName.setVariable("name");            fieldName.setType(FormField.Type.text_single);            fieldName.setLabel("Full name");            if (UserManager.getUserProvider().isNameRequired()) {                fieldName.setRequired(true);            }            final FormField fieldMail = registrationForm.addField();            fieldMail.setVariable("email");            fieldMail.setType(FormField.Type.text_single);            fieldMail.setLabel("Email");            if (UserManager.getUserProvider().isEmailRequired()) {                fieldMail.setRequired(true);            }            final FormField fieldPwd = registrationForm.addField();            fieldPwd.setVariable("password");            fieldPwd.setType(FormField.Type.text_private);            fieldPwd.setLabel("Password");            fieldPwd.setRequired(true);            // Add the registration form to the probe result.            probeResult.add(registrationForm.getElement());        }        // See if in-band registration should be enabled (default is true).        registrationEnabled = JiveGlobals.getBooleanProperty("register.inband", true);        // See if users can change their passwords (default is true).        canChangePassword = JiveGlobals.getBooleanProperty("register.password", true);    }

handleIQ

handleIQ方法，方法有四个步骤。

1、判断用户是否已经登陆。如果在session已经存在该用户发送错误消息反馈客户端：

PacketError.Condition.internal_server_error

2、获取IQ消息包的消息类型，如果是type=get那就是客户端需要获取申请表了。然

后，服务端封装这个表单，转成成XMPP消息发送给客户端。

3、当获取到的IQ消息包的消息类型给set(type=set)。那么就是客户点填写完了注册

表单，发送给服务端了。上面描述注册流程的第4步就是提交表单了。源码就不在

贴出来了，这个比较简单。只是一些判断校验比较多。

4、当所有的校验都正确，一切注册流程都正常的话。服务端就该返回第6点消息了。

当然在代码执行过程(业务处理，消息校验等)可能会产生些异常。处理异常的信息

这里把代码贴出来下，大家也可以自己去看源码：

catch (UserAlreadyExistsException e) {                reply = IQ.createResultIQ(packet);                reply.setChildElement(packet.getChildElement().createCopy());                reply.setError(PacketError.Condition.conflict);            }            catch (UserNotFoundException e) {                reply = IQ.createResultIQ(packet);                reply.setChildElement(packet.getChildElement().createCopy());                reply.setError(PacketError.Condition.bad_request);            }            catch (StringprepException e) {                // The specified username is not correct according to the stringprep specs                reply = IQ.createResultIQ(packet);                reply.setChildElement(packet.getChildElement().createCopy());                reply.setError(PacketError.Condition.jid_malformed);            }            catch (IllegalArgumentException e) {                // At least one of the fields passed in is not valid                reply = IQ.createResultIQ(packet);                reply.setChildElement(packet.getChildElement().createCopy());                reply.setError(PacketError.Condition.not_acceptable);                Log.warn(e.getMessage(), e);            }            catch (UnsupportedOperationException e) {                // The User provider is read-only so this operation is not allowed                reply = IQ.createResultIQ(packet);                reply.setChildElement(packet.getChildElement().createCopy());                reply.setError(PacketError.Condition.not_allowed);            }            catch (Exception e) {                // Some unexpected error happened so return an internal_server_error                reply = IQ.createResultIQ(packet);                reply.setChildElement(packet.getChildElement().createCopy());                reply.setError(PacketError.Condition.internal_server_error);                Log.error(e.getMessage(), e);            }

这里出现的PacketError这样的消息包错误对象，在以后的源码中会继续写博客，希望大家多多关照...