OpenFire源码学习之六:用户注册
用户注册
注册流程:
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
该方法主要是做初始化注册模板。这个注册模板就是在上面提到的需要发送给客户端申请注册的深表表单。源码如下:
@Override public 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这样的消息包错误对象,在以后的源码中会继续写博客,希望大家多多关照...
注册表单配置
在上面讲解用户注册的流程的时候,相信大家都看到了,用户注册的时候服务端会发送很长的一连串表单要客户端来填写。实际上吗,在openfire官方也不一定确定,世界各地使用注册到底需要哪些属性,所以给出来的注册模板可能会不适合所有的人来使用。那么怎么来修改注册模板呢。
然而在openfire控制管理台,也提供了用户注册表单的配置。在管理台目录:
用户/组->RegistrationProperties这个目录下。截图如下:
Ok,这里面有很多关于注册的使用相关信息。如下几个:
1、RegistrationSettings
2、RegistrationNotification Contacts
3、WelcomeMessage
4、DefaultGroup
5、Sign-Up PageHeader Text
在本章就,本人则挑几个给大家一起分析下。其余的大家可以自己跟踪下源码。
Registration Settings
RegistrationSettings是设置注册配置信息。
这里有禁用使用email,当然也可以添加使用,其他的属性,比如地址,邮编等。
Welcome Message
注册完成后,反馈欢迎词等等。
Default Group
注册完成后,添加到哪些默认组。关于默认组,以后再说。
.......
好了,注册这块就不谈了。