Package | org.igniterealtime.xiff.events |
Class | public class XIFFErrorEvent |
Inheritance | XIFFErrorEvent ![]() |
The following rules apply to stream-level errors:
It is assumed that all stream-level errors are unrecoverable; therefore, if an error occurs at the level of the stream, the entity that detects the error MUST send a stream error to the other entity, send a closing stream tag, and terminate the underlying TCP connection.
If the error occurs while the stream is being set up, the receiving entity MUST still send the opening stream tag, include the error element as a child of the stream element, send the closing stream tag, and terminate the underlying TCP connection. In this case, if the initiating entity provides an unknown host in the 'to' attribute (or provides no 'to' attribute at all), the server SHOULD provide the server's authoritative hostname in the 'from' attribute of the stream header sent before termination.
See also
Property | Defined By | ||
---|---|---|---|
errorCode : int
Legacy error code
| XIFFErrorEvent | ||
errorCondition : String
The following stream-level error conditions are defined:
bad-format - the entity has sent XML that cannot be processed;
this error MAY be used instead of the more specific XML-related
errors, such as bad-namespace-prefix, invalid-xml,
restricted-xml, unsupported-encoding, and
xml-not-well-formed, although the more specific errors are
preferred.
bad-namespace-prefix - the entity has sent a namespace prefix
that is unsupported, or has sent no namespace prefix on an element
that requires such a prefix (see XML Namespace Names and Prefixes
(Section 11.2)).
conflict - the server is closing the active stream for this
entity because a new stream has been initiated that conflicts with
the existing stream.
connection-timeout - the entity has not generated any traffic
over the stream for some period of time (configurable according to
a local service policy).
host-gone - the value of the 'to' attribute provided by the
initiating entity in the stream header corresponds to a hostname
that is no longer hosted by the server.
host-unknown - the value of the 'to' attribute provided by the
initiating entity in the stream header does not correspond to a
hostname that is hosted by the server.
improper-addressing - a stanza sent between two servers lacks
a 'to' or 'from' attribute (or the attribute has no value).
internal-server-error - the server has experienced a
misconfiguration or an otherwise-undefined internal error that
prevents it from servicing the stream.
invalid-from - the JID or hostname provided in a 'from'
address does not match an authorized JID or validated domain
negotiated between servers via SASL or dialback, or between a
client and a server via authentication and resource binding.
invalid-id - the stream ID or dialback ID is invalid or does
not match an ID previously provided.
invalid-namespace - the streams namespace name is something
other than "http://etherx.jabber.org/streams" or the dialback
namespace name is something other than "jabber:server:dialback"
(see XML Namespace Names and Prefixes (Section 11.2)).
invalid-xml - the entity has sent invalid XML over the stream
to a server that performs validation (see Validation (Section
11.3)).
not-authorized - the entity has attempted to send data before
the stream has been authenticated, or otherwise is not authorized
to perform an action related to stream negotiation; the receiving
entity MUST NOT process the offending stanza before sending the
stream error.
policy-violation - the entity has violated some local service
policy; the server MAY choose to specify the policy in the text
element or an application-specific condition element.
remote-connection-failed - the server is unable to properly
connect to a remote entity that is required for authentication or
authorization.
resource-constraint - the server lacks the system resources
necessary to service the stream.
restricted-xml - the entity has attempted to send restricted
XML features such as a comment, processing instruction, DTD,
entity reference, or unescaped character (see Restrictions
(Section 11.1)).
see-other-host - the server will not provide service to the
initiating entity but is redirecting traffic to another host; the
server SHOULD specify the alternate hostname or IP address (which
MUST be a valid domain identifier) as the XML character data of
the see-other-host element.
system-shutdown - the server is being shut down and all active
streams are being closed.
undefined-condition - the error condition is not one of those
defined by the other conditions in this list; this error condition
SHOULD be used only in conjunction with an application-specific
condition.
unsupported-encoding - the initiating entity has encoded the
stream in an encoding that is not supported by the server (see
Character Encoding (Section 11.5)).
unsupported-stanza-type - the initiating entity has sent a
first-level child of the stream that is not supported by the
server.
unsupported-version - the value of the 'version' attribute
provided by the initiating entity in the stream header specifies a
version of XMPP that is not supported by the server; the server
MAY specify the version(s) it supports in the text element.
xml-not-well-formed - the initiating entity has sent XML that
is not well-formed as defined by [XML].
| XIFFErrorEvent | ||
errorExt : Extension | XIFFErrorEvent | ||
errorMessage : String | XIFFErrorEvent | ||
errorType : String | XIFFErrorEvent |
Method | Defined By | ||
---|---|---|---|
XIFFErrorEvent | |||
clone():Event [override] | XIFFErrorEvent | ||
toString():String [override] | XIFFErrorEvent |
Constant | Defined By | ||
---|---|---|---|
XIFF_ERROR : String = error [static]
| XIFFErrorEvent |
errorCode | property |
errorCode:int
Legacy error code
public function get errorCode():int
public function set errorCode(value:int):void
See also
errorCondition | property |
errorCondition:String
The following stream-level error conditions are defined:
public function get errorCondition():String
public function set errorCondition(value:String):void
See also
errorExt | property |
errorExt:Extension
public function get errorExt():Extension
public function set errorExt(value:Extension):void
errorMessage | property |
errorMessage:String
public function get errorMessage():String
public function set errorMessage(value:String):void
errorType | property |
errorType:String
public function get errorType():String
public function set errorType(value:String):void
XIFFErrorEvent | () | Constructor |
public function XIFFErrorEvent()
clone | () | method |
override public function clone():Event
ReturnsEvent |
toString | () | method |
override public function toString():String
ReturnsString |
XIFF_ERROR | Constant |
public static const XIFF_ERROR:String = error
The default value is .