Package org.jivesoftware.smack.packet

Class Message

java.lang.Object

org.jivesoftware.smack.packet.Stanza

org.jivesoftware.smack.packet.MessageOrPresence<MessageBuilder>

org.jivesoftware.smack.packet.Message

All Implemented Interfaces:

Element, MessageView, NamedElement, StanzaView, TopLevelStreamElement, XmlElement, XmlLangElement

public final class Message
extends MessageOrPresence<MessageBuilder>
implements MessageView

Represents XMPP message packets. A message can be one of several types:

• Message.Type.NORMAL -- (Default) a normal text message used in email like interface.
• Message.Type.CHAT -- a typically short text message used in line-by-line chat interfaces.
• Message.Type.GROUP_CHAT -- a chat message sent to a groupchat server for group chats.
• Message.Type.HEADLINE -- a text message to be displayed in scrolling marquee displays.
• Message.Type.ERROR -- indicates a messaging error.

For each message type, different message fields are typically used as follows:

Message Types

	Message type
Field	Normal	Chat	Group Chat	Headline	XMPPError
subject	SHOULD	SHOULD NOT	SHOULD NOT	SHOULD NOT	SHOULD NOT
thread	OPTIONAL	SHOULD	OPTIONAL	OPTIONAL	SHOULD NOT
body	SHOULD	SHOULD	SHOULD	SHOULD	SHOULD NOT
error	MUST NOT	MUST NOT	MUST NOT	MUST NOT	MUST

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Message.Body	Represents a message body, its language and the content of the message.
static class	Message.Subject	Represents a message subject, its language and the content of the subject.
static class	Message.Thread
static class	Message.Type	Represents the type of a message.

Field Summary

Fields

Modifier and Type	Field	Description
static String	BODY
static String	ELEMENT

Fields inherited from class org.jivesoftware.smack.packet.Stanza

DEFAULT_LANGUAGE, ITEM, language, TEXT

Constructor Summary

Constructors

Constructor	Description
Message()	Deprecated. use StanzaBuilder, preferable via StanzaFactory, instead.
Message(String to, String body)	Deprecated. use StanzaBuilder, preferable via StanzaFactory, instead.
Message(Message other)	Copy constructor.
Message(Jid to)	Deprecated. use StanzaBuilder, preferable via StanzaFactory, instead.
Message(Jid to, String body)	Deprecated. use StanzaBuilder, preferable via StanzaFactory, instead.
Message(Jid to, ExtensionElement extensionElement)	Deprecated. use StanzaBuilder, preferable via StanzaFactory, instead.
Message(Jid to, Message.Type type)	Deprecated. use StanzaBuilder, preferable via StanzaFactory, instead.

Method Summary

Modifier and Type	Method	Description
Message.Body	addBody(String language, String body)	Deprecated. use StanzaBuilder instead.
Message.Subject	addSubject(String language, String subject)	Deprecated.
MessageBuilder	asBuilder()
MessageBuilder	asBuilder(String id)
MessageBuilder	asBuilder(XMPPConnection connection)
Message	clone()	Deprecated. use asBuilder() instead.
String	getElementName()	Returns the root element name.
Message.Type	getType()	Returns the type of the message.
boolean	removeBody(String language)	Deprecated. use StanzaBuilder instead.
boolean	removeBody(Message.Body body)	Deprecated. use StanzaBuilder instead.
boolean	removeSubject(String language)	Deprecated.
boolean	removeSubject(Message.Subject subject)	Deprecated.
void	setBody(CharSequence body)	Deprecated. use StanzaBuilder instead.
void	setBody(String body)	Deprecated. use StanzaBuilder instead.
void	setSubject(String subject)	Deprecated. use StanzaBuilder instead.
void	setThread(String thread)	Deprecated. use StanzaBuilder instead.
void	setType(Message.Type type)	Deprecated. use StanzaBuilder instead.
String	toString()	Returns a short String describing the Stanza.
XmlStringBuilder	toXML(XmlEnvironment enclosingXmlEnvironment)

Methods inherited from class org.jivesoftware.smack.packet.Stanza

addCommonAttributes, addExtension, addExtensions, appendErrorIfExists, getDefaultLanguage, getError, getExtension, getExtension, getExtension, getExtensionElement, getExtensions, getExtensions, getExtensions, getExtensions, getExtensionsMap, getFrom, getLanguage, getNamespace, getStanzaId, getTo, hasExtension, hasExtension, hasStanzaIdSet, logCommonAttributes, overrideExtension, removeExtension, removeExtension, setError, setError, setFrom, setLanguage, setNewStanzaId, setStanzaId, setStanzaId, setTo, throwIfNoStanzaId

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jivesoftware.smack.packet.Element

toXML, toXML

Methods inherited from interface org.jivesoftware.smack.packet.MessageView

getBodies, getBody, getBody, getBodyLanguages, getMessageBody, getMessageSubject, getSubject, getSubject, getSubjectLanguages, getSubjects, getThread

Methods inherited from interface org.jivesoftware.smack.packet.StanzaView

getError, getExtension, getExtension, getExtensions, getExtensions, getExtensions, getFrom, getStanzaId, getTo, hasExtension, hasExtension, hasExtension

Methods inherited from interface org.jivesoftware.smack.packet.XmlElement

getQName

Field Detail

ELEMENT

public static final String ELEMENT

See Also:

Constant Field Values

BODY

public static final String BODY

See Also:

Constant Field Values

Constructor Detail

Message

@Deprecated
public Message()

Deprecated.

use StanzaBuilder, preferable via StanzaFactory, instead.

Creates a new, "normal" message.

Message

@Deprecated
public Message(Jid to)

Deprecated.

use StanzaBuilder, preferable via StanzaFactory, instead.

Creates a new "normal" message to the specified recipient.

Parameters:

to - the recipient of the message.

Message

@Deprecated
public Message(Jid to,
               Message.Type type)

Deprecated.

use StanzaBuilder, preferable via StanzaFactory, instead.

Creates a new message of the specified type to a recipient.

Parameters:

to - the user to send the message to.

type - the message type.

Message

@Deprecated
public Message(Jid to,
               String body)

Deprecated.

use StanzaBuilder, preferable via StanzaFactory, instead.

Creates a new message to the specified recipient and with the specified body.

Parameters:

to - the user to send the message to.

body - the body of the message.

Message

@Deprecated
public Message(String to,
               String body)
        throws XmppStringprepException

Deprecated.

use StanzaBuilder, preferable via StanzaFactory, instead.

Creates a new message to the specified recipient and with the specified body.

Parameters:

to - the user to send the message to.

body - the body of the message.

Throws:

XmppStringprepException - if 'to' is not a valid XMPP address.

Message

@Deprecated
public Message(Jid to,
               ExtensionElement extensionElement)

Deprecated.

use StanzaBuilder, preferable via StanzaFactory, instead.

Creates a new message with the specified recipient and extension element.

Parameters:

to - TODO javadoc me please

extensionElement - TODO javadoc me please

Since:

4.2

Message

public Message(Message other)

Copy constructor.

This does not perform a deep clone, as extension elements are shared between the new and old instance.

Parameters:

other - TODO javadoc me please

Method Detail

getType

public Message.Type getType()

Description copied from interface: MessageView

Returns the type of the message. If no type has been set this method will return Message.Type.normal.

Specified by:

getType in interface MessageView

Returns:

the type of the message.

setType

@Deprecated
public void setType(Message.Type type)

Deprecated.

use StanzaBuilder instead.

Sets the type of the message.

Parameters:

type - the type of the message.

setSubject

@Deprecated
public void setSubject(String subject)

Deprecated.

use StanzaBuilder instead.

Sets the subject of the message. The subject is a short description of message contents.

Parameters:

subject - the subject of the message.

addSubject

@Deprecated
public Message.Subject addSubject(String language,
                                  String subject)

Deprecated.

Adds a subject with a corresponding language.

Parameters:

language - the language of the subject being added.

subject - the subject being added to the message.

Returns:

the new Message.Subject

Throws:

NullPointerException - if the subject is null, a null pointer exception is thrown

removeSubject

@Deprecated
public boolean removeSubject(String language)

Deprecated.

Removes the subject with the given language from the message.

Parameters:

language - the language of the subject which is to be removed

Returns:

true if a subject was removed and false if it was not.

removeSubject

@Deprecated
public boolean removeSubject(Message.Subject subject)

Deprecated.

Removes the subject from the message and returns true if the subject was removed.

Parameters:

subject - the subject being removed from the message.

Returns:

true if the subject was successfully removed and false if it was not.

setBody

@Deprecated
public void setBody(CharSequence body)

Deprecated.

use StanzaBuilder instead.

Sets the body of the message.

Parameters:

body - the body of the message.

Since:

4.2

See Also:

setBody(String)

setBody

@Deprecated
public void setBody(String body)

Deprecated.

use StanzaBuilder instead.

Sets the body of the message. The body is the main message contents.

Parameters:

body - the body of the message.

addBody

@Deprecated
public Message.Body addBody(String language,
                            String body)

Deprecated.

use StanzaBuilder instead.

Adds a body with a corresponding language.

Parameters:

language - the language of the body being added.

body - the body being added to the message.

Returns:

the new Message.Body

Throws:

NullPointerException - if the body is null, a null pointer exception is thrown

Since:

3.0.2

removeBody

@Deprecated
public boolean removeBody(String language)

Deprecated.

use StanzaBuilder instead.

Removes the body with the given language from the message.

Parameters:

language - the language of the body which is to be removed

Returns:

true if a body was removed and false if it was not.

removeBody

@Deprecated
public boolean removeBody(Message.Body body)

Deprecated.

use StanzaBuilder instead.

Removes the body from the message and returns true if the body was removed.

Parameters:

body - the body being removed from the message.

Returns:

true if the body was successfully removed and false if it was not.

Since:

3.0.2

setThread

@Deprecated
public void setThread(String thread)

Deprecated.

use StanzaBuilder instead.

Sets the thread id of the message, which is a unique identifier for a sequence of "chat" messages.

Parameters:

thread - the thread id of the message.

getElementName

public String getElementName()

Description copied from interface: NamedElement

Returns the root element name.

Specified by:

getElementName in interface NamedElement

Returns:

the element name.

asBuilder

public MessageBuilder asBuilder()

Specified by:

asBuilder in class MessageOrPresence<MessageBuilder>

asBuilder

public MessageBuilder asBuilder(String id)

Specified by:

asBuilder in class MessageOrPresence<MessageBuilder>

asBuilder

public MessageBuilder asBuilder(XMPPConnection connection)

Specified by:

asBuilder in class MessageOrPresence<MessageBuilder>

toString

public String toString()

Description copied from class: Stanza

Returns a short String describing the Stanza. This method is suited for log purposes.

Specified by:

toString in class Stanza

toXML

public XmlStringBuilder toXML(XmlEnvironment enclosingXmlEnvironment)

Specified by:

toXML in interface Element

clone

@Deprecated
public Message clone()

Deprecated.

use asBuilder() instead.

Creates and returns a copy of this message stanza.

This does not perform a deep clone, as extension elements are shared between the new and old instance.

Overrides:

clone in class Object

Returns:

a clone of this message.