Shuyi Chen | d7955ce | 2013-05-22 14:51:55 -0700 | [diff] [blame] | 1 | /**
|
| 2 | * $Revision: 2408 $
|
| 3 | * $Date: 2004-11-02 20:53:30 -0300 (Tue, 02 Nov 2004) $
|
| 4 | *
|
| 5 | * Copyright 2003-2005 Jive Software.
|
| 6 | *
|
| 7 | * All rights reserved. Licensed under the Apache License, Version 2.0 (the "License");
|
| 8 | * you may not use this file except in compliance with the License.
|
| 9 | * You may obtain a copy of the License at
|
| 10 | *
|
| 11 | * http://www.apache.org/licenses/LICENSE-2.0
|
| 12 | *
|
| 13 | * Unless required by applicable law or agreed to in writing, software
|
| 14 | * distributed under the License is distributed on an "AS IS" BASIS,
|
| 15 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
| 16 | * See the License for the specific language governing permissions and
|
| 17 | * limitations under the License.
|
| 18 | */
|
| 19 |
|
| 20 | package org.jivesoftware.smack.packet;
|
| 21 |
|
| 22 | /**
|
| 23 | * Represents a stream error packet. Stream errors are unrecoverable errors where the server
|
| 24 | * will close the unrelying TCP connection after the stream error was sent to the client.
|
| 25 | * These is the list of stream errors as defined in the XMPP spec:<p>
|
| 26 | *
|
| 27 | * <table border=1>
|
| 28 | * <tr><td><b>Code</b></td><td><b>Description</b></td></tr>
|
| 29 | * <tr><td> bad-format </td><td> the entity has sent XML that cannot be processed </td></tr>
|
| 30 | * <tr><td> unsupported-encoding </td><td> the entity has sent a namespace prefix that is
|
| 31 | * unsupported </td></tr>
|
| 32 | * <tr><td> bad-namespace-prefix </td><td> Remote Server Timeout </td></tr>
|
| 33 | * <tr><td> conflict </td><td> the server is closing the active stream for this entity
|
| 34 | * because a new stream has been initiated that conflicts with the existing
|
| 35 | * stream. </td></tr>
|
| 36 | * <tr><td> connection-timeout </td><td> the entity has not generated any traffic over
|
| 37 | * the stream for some period of time. </td></tr>
|
| 38 | * <tr><td> host-gone </td><td> the value of the 'to' attribute provided by the initiating
|
| 39 | * entity in the stream header corresponds to a hostname that is no longer hosted by
|
| 40 | * the server. </td></tr>
|
| 41 | * <tr><td> host-unknown </td><td> the value of the 'to' attribute provided by the
|
| 42 | * initiating entity in the stream header does not correspond to a hostname that is
|
| 43 | * hosted by the server. </td></tr>
|
| 44 | * <tr><td> improper-addressing </td><td> a stanza sent between two servers lacks a 'to'
|
| 45 | * or 'from' attribute </td></tr>
|
| 46 | * <tr><td> internal-server-error </td><td> the server has experienced a
|
| 47 | * misconfiguration. </td></tr>
|
| 48 | * <tr><td> invalid-from </td><td> the JID or hostname provided in a 'from' address does
|
| 49 | * not match an authorized JID. </td></tr>
|
| 50 | * <tr><td> invalid-id </td><td> the stream ID or dialback ID is invalid or does not match
|
| 51 | * an ID previously provided. </td></tr>
|
| 52 | * <tr><td> invalid-namespace </td><td> the streams namespace name is invalid. </td></tr>
|
| 53 | * <tr><td> invalid-xml </td><td> the entity has sent invalid XML over the stream. </td></tr>
|
| 54 | * <tr><td> not-authorized </td><td> the entity has attempted to send data before the
|
| 55 | * stream has been authenticated </td></tr>
|
| 56 | * <tr><td> policy-violation </td><td> the entity has violated some local service
|
| 57 | * policy. </td></tr>
|
| 58 | * <tr><td> remote-connection-failed </td><td> Rthe server is unable to properly connect
|
| 59 | * to a remote entity. </td></tr>
|
| 60 | * <tr><td> resource-constraint </td><td> Rthe server lacks the system resources necessary
|
| 61 | * to service the stream. </td></tr>
|
| 62 | * <tr><td> restricted-xml </td><td> the entity has attempted to send restricted XML
|
| 63 | * features. </td></tr>
|
| 64 | * <tr><td> see-other-host </td><td> the server will not provide service to the initiating
|
| 65 | * entity but is redirecting traffic to another host. </td></tr>
|
| 66 | * <tr><td> system-shutdown </td><td> the server is being shut down and all active streams
|
| 67 | * are being closed. </td></tr>
|
| 68 | * <tr><td> undefined-condition </td><td> the error condition is not one of those defined
|
| 69 | * by the other conditions in this list. </td></tr>
|
| 70 | * <tr><td> unsupported-encoding </td><td> the initiating entity has encoded the stream in
|
| 71 | * an encoding that is not supported. </td></tr>
|
| 72 | * <tr><td> unsupported-stanza-type </td><td> the initiating entity has sent a first-level
|
| 73 | * child of the stream that is not supported. </td></tr>
|
| 74 | * <tr><td> unsupported-version </td><td> the value of the 'version' attribute provided by
|
| 75 | * the initiating entity in the stream header specifies a version of XMPP that is not
|
| 76 | * supported. </td></tr>
|
| 77 | * <tr><td> xml-not-well-formed </td><td> the initiating entity has sent XML that is
|
| 78 | * not well-formed. </td></tr>
|
| 79 | * </table>
|
| 80 | *
|
| 81 | * @author Gaston Dombiak
|
| 82 | */
|
| 83 | public class StreamError {
|
| 84 |
|
| 85 | private String code;
|
| 86 |
|
| 87 | public StreamError(String code) {
|
| 88 | super();
|
| 89 | this.code = code;
|
| 90 | }
|
| 91 |
|
| 92 | /**
|
| 93 | * Returns the error code.
|
| 94 | *
|
| 95 | * @return the error code.
|
| 96 | */
|
| 97 | public String getCode() {
|
| 98 | return code;
|
| 99 | }
|
| 100 |
|
| 101 | public String toString() {
|
| 102 | StringBuilder txt = new StringBuilder();
|
| 103 | txt.append("stream:error (").append(code).append(")");
|
| 104 | return txt.toString();
|
| 105 | }
|
| 106 | }
|