diff --git a/smack-core/src/main/java/org/jivesoftware/smack/packet/DefaultExtensionElement.java b/smack-core/src/main/java/org/jivesoftware/smack/packet/DefaultExtensionElement.java deleted file mode 100644 index 56090d568..000000000 --- a/smack-core/src/main/java/org/jivesoftware/smack/packet/DefaultExtensionElement.java +++ /dev/null @@ -1,138 +0,0 @@ -/** - * - * Copyright 2003-2007 Jive Software. - * - * 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 java.util.Collection; -import java.util.Collections; -import java.util.HashMap; -import java.util.Map; - -import org.jivesoftware.smack.util.XmlStringBuilder; - -/** - * Default implementation of the ExtensionElement interface. Unless a ExtensionElementProvider - * is registered with {@link org.jivesoftware.smack.provider.ProviderManager ProviderManager}, - * instances of this class will be returned when getting stanza extensions.
- * - * This class provides a very simple representation of an XML sub-document. Each element - * is a key in a Map with its CDATA being the value. For example, given the following - * XML sub-document: - * - *
- * <foo xmlns="http://bar.com"> - * <color>blue</color> - * <food>pizza</food> - * </foo>- * - * In this case, getValue("color") would return "blue", and getValue("food") would - * return "pizza". This parsing mechanism is very simplistic and will not work - * as desired in all cases (for example, if some of the elements have attributes. In those - * cases, a custom ExtensionElementProvider should be used. - * - * @author Matt Tucker - * @deprecated use {@link org.jivesoftware.smack.packet.StandardExtensionElement} instead. - */ -@Deprecated -public class DefaultExtensionElement implements ExtensionElement { - - private String elementName; - private String namespace; - private Map
null
.
- *
- * @return the packet's unique ID or null
if the id is not available.
- */
- String getStanzaId();
-
- /**
- * Get the stanza id.
- * @return the stanza id.
- * @deprecated use {@link #getStanzaId()} instead.
- */
- @Deprecated
- String getPacketID();
-
- /**
- * Sets the unique ID of the packet. To indicate that a stanza has no id
- * pass null
as the packet's id value.
- *
- * @param id the unique ID for the packet.
- */
- void setStanzaId(String id);
-
- /**
- * Set the stanza ID.
- * @param packetID TODO javadoc me please
- * @deprecated use {@link #setStanzaId(String)} instead.
- */
- @Deprecated
- void setPacketID(String packetID);
-
- /**
- * Returns who the stanza is being sent "to", or null
if
- * the value is not set. The XMPP protocol often makes the "to"
- * attribute optional, so it does not always need to be set.
- *
- * @return who the stanza is being sent to, or null
if the
- * value has not been set.
- */
- String getTo();
-
- /**
- * Sets who the stanza is being sent "to". The XMPP protocol often makes
- * the "to" attribute optional, so it does not always need to be set.
- *
- * @param to who the stanza is being sent to.
- */
- void setTo(String to);
-
- /**
- * Returns who the stanza is being sent "from" or null
if
- * the value is not set. The XMPP protocol often makes the "from"
- * attribute optional, so it does not always need to be set.
- *
- * @return who the stanza is being sent from, or
- * Changes to the returned set will update the stanza extensions, if the returned set is not the empty set.
- *
- * When possible, use {@link #getExtension(String, String)} instead.
- *
- * The argument
- * An extension element is an XML subdocument
- * with a root element name and namespace. Extension elements are used to provide
- * extended functionality beyond what is in the base XMPP specification. Examples of
- * extensions elements include message events, message properties, and extra presence data.
- * IQ stanzas have limited support for extension elements.
- *
- * This class is used primarily for extended content in XMPP Stanzas, to act as so called "extension elements". For more
- * information see RFC 6120 ยง 8.4 Extended Content.
- * null
if the
- * value has not been set.
- */
- String getFrom();
-
- /**
- * Sets who the stanza is being sent "from". The XMPP protocol often
- * makes the "from" attribute optional, so it does not always need to
- * be set.
- *
- * @param from who the stanza is being sent to.
- */
- void setFrom(String from);
-
- /**
- * Returns the error associated with this packet, or null
if there are
- * no errors.
- *
- * @return the error sub-packet or null
if there isn't an error.
- */
- StanzaError getError();
- /**
- * Sets the error for this packet.
- *
- * @param error the error to associate with this packet.
- */
- void setError(StanzaError error);
-
- @Override
- String getLanguage();
-
- /**
- * Sets the xml:lang of this Stanza.
- *
- * @param language the xml:lang of this Stanza.
- */
- void setLanguage(String language);
-
- /**
- * Returns a copy of the stanza extensions attached to the packet.
- *
- * @return the stanza extensions.
- */
- Listnull
if it doesn't exist. If the provided elementName is null,
- * only the namespace is matched. Stanza extensions are
- * are arbitrary XML sub-documents in standard XMPP packets. By default, a
- * DefaultPacketExtension instance will be returned for each extension. However,
- * PacketExtensionProvider instances can be registered with the
- * {@link org.jivesoftware.smack.provider.ProviderManager ProviderManager}
- * class to handle custom parsing. In that case, the type of the Object
- * will be determined by the provider.
- *
- * @param elementName the XML element name of the stanza extension. (May be null)
- * @param namespace the XML element namespace of the stanza extension.
- * @param null
if it doesn't exist.
- */
- elementName
may be null.
- *