org.jivesoftware.smackx.xhtmlim

Class XHTMLManager

java.lang.Object

org.jivesoftware.smackx.xhtmlim.XHTMLManager

public class XHTMLManager
extends Object

Manages XHTML formatted texts within messages. A XHTMLManager provides a high level access to get and set XHTML bodies to messages, enable and disable XHTML support and check if remote XMPP clients support XHTML.

Constructor Summary

Constructors

Constructor and Description
XHTMLManager()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addBody(Message message, String body) Adds an XHTML body to the message.
static List<String>	getBodies(Message message) Returns an Iterator for the XHTML bodies in the message.
static boolean	isServiceEnabled(XMPPConnection connection) Returns true if the XHTML support is enabled for the given connection.
static boolean	isServiceEnabled(XMPPConnection connection, String userID) Returns true if the specified user handles XHTML messages.
static boolean	isXHTMLMessage(Message message) Returns true if the message contains an XHTML extension.
static void	setServiceEnabled(XMPPConnection connection, boolean enabled) Enables or disables the XHTML support on a given connection.

Methods inherited from class java.lang.Object

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

Constructor Detail

XHTMLManager

public XHTMLManager()

Method Detail

getBodies

public static List<String> getBodies(Message message)

Returns an Iterator for the XHTML bodies in the message. Returns null if the message does not contain an XHTML extension.

Parameters:

message - an XHTML message

Returns:

an Iterator for the bodies in the message or null if none.

addBody

public static void addBody(Message message,
           String body)

Adds an XHTML body to the message.

Parameters:

message - the message that will receive the XHTML body

body - the string to add as an XHTML body to the message

isXHTMLMessage

public static boolean isXHTMLMessage(Message message)

Returns true if the message contains an XHTML extension.

Parameters:

message - the message to check if contains an XHTML extentsion or not

Returns:

a boolean indicating whether the message is an XHTML message

setServiceEnabled

public static void setServiceEnabled(XMPPConnection connection,
                     boolean enabled)

Enables or disables the XHTML support on a given connection.

Before starting to send XHTML messages to a user, check that the user can handle XHTML messages. Enable the XHTML support to indicate that this client handles XHTML messages.

Parameters:

connection - the connection where the service will be enabled or disabled

enabled - indicates if the service will be enabled or disabled

isServiceEnabled

public static boolean isServiceEnabled(XMPPConnection connection)

Returns true if the XHTML support is enabled for the given connection.

Parameters:

connection - the connection to look for XHTML support

Returns:

a boolean indicating if the XHTML support is enabled for the given connection

isServiceEnabled

public static boolean isServiceEnabled(XMPPConnection connection,
                       String userID)
                                throws SmackException.NoResponseException,
                                       XMPPException.XMPPErrorException,
                                       SmackException.NotConnectedException

Returns true if the specified user handles XHTML messages.

Parameters:

connection - the connection to use to perform the service discovery

userID - the user to check. A fully qualified xmpp ID, e.g. jdoe@example.com

Returns:

a boolean indicating whether the specified user handles XHTML messages

Throws:

XMPPException.XMPPErrorException

SmackException.NoResponseException

SmackException.NotConnectedException