mirror of
https://codeberg.org/Mercury-IM/Smack
synced 2024-08-25 10:20:27 +02:00
git-svn-id: http://svn.igniterealtime.org/svn/repos/smack/trunk@2408 b35dd754-fafc-0310-a699-88a17e54d16e
168 lines
5 KiB
Java
168 lines
5 KiB
Java
/**
|
|
* $RCSfile$
|
|
* $Revision$
|
|
* $Date$
|
|
*
|
|
* Copyright 2003-2004 Jive Software.
|
|
*
|
|
* All rights reserved. Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package org.jivesoftware.smack.packet;
|
|
|
|
import org.jivesoftware.smack.util.StringUtils;
|
|
|
|
/**
|
|
* The base IQ (Info/Query) packet. IQ packets are used to get and set information
|
|
* on the server, including authentication, roster operations, and creating
|
|
* accounts. Each IQ packet has a specific type that indicates what type of action
|
|
* is being taken: "get", "set", "result", or "error".<p>
|
|
*
|
|
* IQ packets can contain a single child element that exists in a specific XML
|
|
* namespace. The combination of the element name and namespace determines what
|
|
* type of IQ packet it is. Some example IQ subpacket snippets:<ul>
|
|
*
|
|
* <li><query xmlns="jabber:iq:auth"> -- an authentication IQ.
|
|
* <li><query xmlns="jabber:iq:private"> -- a private storage IQ.
|
|
* <li><pubsub xmlns="http://jabber.org/protocol/pubsub"> -- a pubsub IQ.
|
|
* </ul>
|
|
*
|
|
* @author Matt Tucker
|
|
*/
|
|
public abstract class IQ extends Packet {
|
|
|
|
private Type type = Type.GET;
|
|
|
|
/**
|
|
* Returns the type of the IQ packet.
|
|
*
|
|
* @return the type of the IQ packet.
|
|
*/
|
|
public Type getType() {
|
|
return type;
|
|
}
|
|
|
|
/**
|
|
* Sets the type of the IQ packet.
|
|
*
|
|
* @param type the type of the IQ packet.
|
|
*/
|
|
public void setType(Type type) {
|
|
if (type == null) {
|
|
this.type = Type.GET;
|
|
}
|
|
else {
|
|
this.type = type;
|
|
}
|
|
}
|
|
|
|
public String toXML() {
|
|
StringBuffer buf = new StringBuffer();
|
|
buf.append("<iq ");
|
|
if (getPacketID() != null) {
|
|
buf.append("id=\"" + getPacketID() + "\" ");
|
|
}
|
|
if (getTo() != null) {
|
|
buf.append("to=\"").append(StringUtils.escapeForXML(getTo())).append("\" ");
|
|
}
|
|
if (getFrom() != null) {
|
|
buf.append("from=\"").append(StringUtils.escapeForXML(getFrom())).append("\" ");
|
|
}
|
|
if (type == null) {
|
|
buf.append("type=\"get\">");
|
|
}
|
|
else {
|
|
buf.append("type=\"").append(getType()).append("\">");
|
|
}
|
|
// Add the query section if there is one.
|
|
String queryXML = getChildElementXML();
|
|
if (queryXML != null) {
|
|
buf.append(queryXML);
|
|
}
|
|
// Add the error sub-packet, if there is one.
|
|
XMPPError error = getError();
|
|
if (error != null) {
|
|
buf.append(error.toXML());
|
|
}
|
|
buf.append("</iq>");
|
|
return buf.toString();
|
|
}
|
|
|
|
/**
|
|
* Returns the sub-element XML section of the IQ packet, or <tt>null</tt> if there
|
|
* isn't one. Packet extensions <b>must</b> be included, if any are defined.<p>
|
|
*
|
|
* Extensions of this class must override this method.
|
|
*
|
|
* @return the child element section of the IQ XML.
|
|
*/
|
|
public abstract String getChildElementXML();
|
|
|
|
/**
|
|
* A class to represent the type of the IQ packet. The types are:
|
|
*
|
|
* <ul>
|
|
* <li>IQ.Type.GET
|
|
* <li>IQ.Type.SET
|
|
* <li>IQ.Type.RESULT
|
|
* <li>IQ.Type.ERROR
|
|
* </ul>
|
|
*/
|
|
public static class Type {
|
|
|
|
public static final Type GET = new Type("get");
|
|
public static final Type SET = new Type("set");
|
|
public static final Type RESULT = new Type("result");
|
|
public static final Type ERROR = new Type("error");
|
|
|
|
/**
|
|
* Converts a String into the corresponding types. Valid String values
|
|
* that can be converted to types are: "get", "set", "result", and "error".
|
|
*
|
|
* @param type the String value to covert.
|
|
* @return the corresponding Type.
|
|
*/
|
|
public static Type fromString(String type) {
|
|
if (type == null) {
|
|
return null;
|
|
}
|
|
type = type.toLowerCase();
|
|
if (GET.toString().equals(type)) {
|
|
return GET;
|
|
}
|
|
else if (SET.toString().equals(type)) {
|
|
return SET;
|
|
}
|
|
else if (ERROR.toString().equals(type)) {
|
|
return ERROR;
|
|
}
|
|
else if (RESULT.toString().equals(type)) {
|
|
return RESULT;
|
|
}
|
|
else {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
private String value;
|
|
|
|
private Type(String value) {
|
|
this.value = value;
|
|
}
|
|
|
|
public String toString() {
|
|
return value;
|
|
}
|
|
}
|
|
}
|