org.jivesoftware.smack.packet

Class XMPPError

java.lang.Object

org.jivesoftware.smack.packet.AbstractError

org.jivesoftware.smack.packet.XMPPError

public class XMPPError
extends AbstractError

Represents an XMPP error sub-packet. Typically, a server responds to a request that has problems by sending the packet back and including an error packet. Each error has a type, error condition as well as as an optional text explanation. Typical errors are:

XMPP Error Condition	Type	RFC 6120 Section
bad-request	MODIFY	8.3.3.1
conflict	CANCEL	8.3.3.2
feature-not-implemented	CANCEL	8.3.3.3
forbidden	AUTH	8.3.3.4
gone	MODIFY	8.3.3.5
internal-server-error	WAIT	8.3.3.6
item-not-found	CANCEL	8.3.3.7
jid-malformed	MODIFY	8.3.3.8
not-acceptable	MODIFY	8.3.3.9
not-allowed	CANCEL	8.3.3.10
not-authorized	AUTH	8.3.3.11
policy-violation	AUTH	8.3.3.12
recipient-unavailable	WAIT	8.3.3.13
redirect	MODIFY	8.3.3.14
registration-required	AUTH	8.3.3.15
remote-server-not-found	CANCEL	8.3.3.16
remote-server-timeout	WAIT	8.3.3.17
resource-constraint	WAIT	8.3.3.18
service-unavailable	CANCEL	8.3.3.19
subscription-required	AUTH	8.3.3.20
undefined-condition	WAIT	8.3.3.21
unexpected-request	WAIT	8.3.3.22

See Also:

RFC 6120 - 8.3.2 Syntax: The Syntax of XMPP error stanzas

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	XMPPError.Condition
static class	XMPPError.Type A class to represent the type of the Error.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ERROR
static java.lang.String	NAMESPACE

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

descriptiveTexts

Constructor Summary

Constructors

Constructor and Description
XMPPError(XMPPError.Condition condition)
XMPPError(XMPPError.Condition condition, PacketExtension applicationSpecificCondition)
XMPPError(XMPPError.Condition condition, java.lang.String conditionText, java.lang.String errorGenerator, XMPPError.Type type, java.util.Map<java.lang.String,java.lang.String> descriptiveTexts, java.util.List<PacketExtension> extensions) Creates a new error with the specified type, condition and message.

Method Summary

Methods

Modifier and Type	Method and Description
static XMPPError	from(XMPPError.Condition condition, java.lang.String descriptiveText)
XMPPError.Condition	getCondition() Returns the error condition.
java.lang.String	getConditionText()
java.lang.String	getErrorGenerator()
XMPPError.Type	getType() Returns the error type.
java.lang.String	toString()
XmlStringBuilder	toXML() Returns the error as XML.

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

addDescriptiveTextsAndExtensions, getDescriptiveText, getDescriptiveText, getExtension

Methods inherited from class java.lang.Object

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

Field Detail

NAMESPACE

public static final java.lang.String NAMESPACE

See Also:

Constant Field Values

ERROR

public static final java.lang.String ERROR

See Also:

Constant Field Values

Constructor Detail

XMPPError

public XMPPError(XMPPError.Condition condition)

XMPPError

public XMPPError(XMPPError.Condition condition,
         PacketExtension applicationSpecificCondition)

XMPPError

public XMPPError(XMPPError.Condition condition,
         java.lang.String conditionText,
         java.lang.String errorGenerator,
         XMPPError.Type type,
         java.util.Map<java.lang.String,java.lang.String> descriptiveTexts,
         java.util.List<PacketExtension> extensions)

Creates a new error with the specified type, condition and message. This constructor is used when the condition is not recognized automatically by XMPPError i.e. there is not a defined instance of ErrorCondition or it does not apply the default specification.

Parameters:

type - the error type.

condition - the error condition.

descriptiveTexts -

extensions - list of packet extensions

Method Detail

getCondition

public XMPPError.Condition getCondition()

Returns the error condition.

Returns:

the error condition.

getType

public XMPPError.Type getType()

Returns the error type.

Returns:

the error type.

getErrorGenerator

public java.lang.String getErrorGenerator()

getConditionText

public java.lang.String getConditionText()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toXML

public XmlStringBuilder toXML()

Returns the error as XML.

Returns:

the error as XML.

from

public static XMPPError from(XMPPError.Condition condition,
             java.lang.String descriptiveText)