org.jivesoftware.openfire.handler

Class IQBindHandler

java.lang.Object

org.jivesoftware.openfire.container.BasicModule

org.jivesoftware.openfire.handler.IQHandler

org.jivesoftware.openfire.handler.IQBindHandler

All Implemented Interfaces:

ChannelHandler, Module

public class IQBindHandler
extends IQHandler

Binds a resource to the stream so that the client's address becomes a full JID. Once a resource has been binded to the session the entity (i.e. client) is considered a "connected resource".

Clients may specify a desired resource but if none was specified then the server will create a random resource for the session. The new resource should be in accordance with ResourcePrep. The server will also verify if there are previous sessions from the same user that are already using the resource specified by the user. Depending on the server configuration the old session may be kicked or the new session may be rejected.

Author:

Gaston Dombiak

Field Summary

Fields inherited from class org.jivesoftware.openfire.handler.IQHandler

deliverer, sessionManager

Constructor Summary

Constructors

Constructor and Description
IQBindHandler()

Method Summary

Modifier and Type	Method and Description
IQHandlerInfo	getInfo() Returns the handler information to help generically handle IQ packets.
org.xmpp.packet.IQ	handleIQ(org.xmpp.packet.IQ packet) Handles the received IQ packet.
void	initialize(XMPPServer server) Initializes the basic module.

Methods inherited from class org.jivesoftware.openfire.handler.IQHandler

process

Methods inherited from class org.jivesoftware.openfire.container.BasicModule

destroy, getName, start, stop

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IQBindHandler

public IQBindHandler()

Method Detail

handleIQ

public org.xmpp.packet.IQ handleIQ(org.xmpp.packet.IQ packet)
                            throws UnauthorizedException

Description copied from class: IQHandler

Handles the received IQ packet.

Specified by:

handleIQ in class IQHandler

Parameters:

packet - the IQ packet to handle.

Returns:

the response to send back.

Throws:

UnauthorizedException - if the user that sent the packet is not authorized to request the given operation.

initialize

public void initialize(XMPPServer server)

Description copied from class: BasicModule

Initializes the basic module.

Inheriting classes that choose to override this method MUST call this initialize() method before accessing BasicModule resources.

Specified by:

initialize in interface Module

Overrides:

initialize in class IQHandler

Parameters:

server - the server hosting this module.

getInfo

public IQHandlerInfo getInfo()

Description copied from class: IQHandler

Returns the handler information to help generically handle IQ packets. IQHandlers that aren't local server iq handlers (e.g. chatbots, transports, etc) return null.

Specified by:

getInfo in class IQHandler

Returns:

The IQHandlerInfo for this handler