rocks.xmpp.extensions.blocking

Class BlockingManager

java.lang.Object

rocks.xmpp.core.session.Manager

rocks.xmpp.core.session.ExtensionManager

rocks.xmpp.extensions.blocking.BlockingManager

public final class BlockingManager
extends ExtensionManager

This manager allows to block communications with contacts.

Enabling or disabling this manager has no effect, because blocking is done on server side.

Author:

Christian Schudt

Field Summary

Fields inherited from class rocks.xmpp.core.session.ExtensionManager

features, xmppSession

Method Summary

Modifier and Type	Method and Description
void	addBlockingListener(BlockingListener blockingListener) Adds a blocking listener, which allows to listen for block and unblock pushes.
void	blockContact(rocks.xmpp.core.Jid... jids) Blocks communications with contacts.
Collection<rocks.xmpp.core.Jid>	getBlockedContacts() Retrieves the blocked contacts.
void	removeBlockingListener(BlockingListener blockingListener) Removes a previously added blocking listener.
void	unblockContact(rocks.xmpp.core.Jid... jids) Unblocks communications with specific contacts or with all contacts.

Methods inherited from class rocks.xmpp.core.session.ExtensionManager

setEnabled

Methods inherited from class rocks.xmpp.core.session.Manager

isEnabled

Methods inherited from class java.lang.Object

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

Method Detail

addBlockingListener

public void addBlockingListener(BlockingListener blockingListener)

Adds a blocking listener, which allows to listen for block and unblock pushes.

Parameters:

blockingListener - The listener.

See Also:

removeBlockingListener(BlockingListener)

removeBlockingListener

public void removeBlockingListener(BlockingListener blockingListener)

Removes a previously added blocking listener.

Parameters:

blockingListener - The listener.

See Also:

addBlockingListener(BlockingListener)

getBlockedContacts

public Collection<rocks.xmpp.core.Jid> getBlockedContacts()
                                                   throws rocks.xmpp.core.XmppException

Retrieves the blocked contacts.

Returns:

The block list.

Throws:

rocks.xmpp.core.stanza.model.StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

rocks.xmpp.core.XmppException

See Also:

3.2 User Retrieves Block List

blockContact

public void blockContact(rocks.xmpp.core.Jid... jids)
                  throws rocks.xmpp.core.XmppException

Blocks communications with contacts.

Parameters:

jids - The contacts.

Throws:

rocks.xmpp.core.stanza.model.StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

rocks.xmpp.core.XmppException

See Also:

3.3 User Blocks Contact

unblockContact

public void unblockContact(rocks.xmpp.core.Jid... jids)
                    throws rocks.xmpp.core.XmppException

Unblocks communications with specific contacts or with all contacts. If you want to unblock all communications, pass no arguments to this method.

Parameters:

jids - The contacts.

Throws:

rocks.xmpp.core.stanza.model.StanzaException - If the entity returned a stanza error.

NoResponseException - If the entity did not respond.

rocks.xmpp.core.XmppException

See Also:

3.4 User Unblocks Contact, 3.5 User Unblocks All Contacts