public abstract class Packet
extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
protected static java.lang.String |
DEFAULT_LANGUAGE |
static java.lang.String |
ID_NOT_AVAILABLE
Constant used as packetID to indicate that a packet has no id.
|
Modifier and Type | Method and Description |
---|---|
protected void |
addCommonAttributes(XmlStringBuilder xml)
Add to, from and id attributes
|
void |
addExtension(PacketExtension extension)
Adds a packet extension to the packet.
|
void |
addExtensions(java.util.Collection<PacketExtension> extensions)
Adds a collection of packet extensions to the packet.
|
boolean |
equals(java.lang.Object o) |
static java.lang.String |
getDefaultLanguage()
Returns the default language used for all messages containing localized content.
|
XMPPError |
getError()
Returns the error associated with this packet, or null if there are
no errors.
|
PacketExtension |
getExtension(java.lang.String namespace)
Returns the first extension of this packet that has the given namespace.
|
PacketExtension |
getExtension(java.lang.String elementName,
java.lang.String namespace)
Returns the first packet extension that matches the specified element name and
namespace, or null if it doesn't exist.
|
java.util.Collection<PacketExtension> |
getExtensions()
Returns an unmodifiable collection of the packet extensions attached to the packet.
|
protected java.lang.CharSequence |
getExtensionsXML()
Returns the extension sub-packets (including properties data) as an XML
String, or the Empty String if there are no packet extensions.
|
java.lang.String |
getFrom()
Returns who the packet is being sent "from" or null if
the value is not set.
|
java.lang.String |
getPacketID()
Returns the unique ID of the packet.
|
java.lang.String |
getTo()
Returns who the packet is being sent "to", or null if
the value is not set.
|
java.lang.String |
getXmlns() |
int |
hashCode() |
static java.lang.String |
nextID()
Returns the next unique id.
|
void |
removeExtension(PacketExtension extension)
Removes a packet extension from the packet.
|
static void |
setDefaultXmlns(java.lang.String defaultXmlns) |
void |
setError(XMPPError error)
Sets the error for this packet.
|
void |
setFrom(java.lang.String from)
Sets who the packet is being sent "from".
|
void |
setPacketID(java.lang.String packetID)
Sets the unique ID of the packet.
|
void |
setTo(java.lang.String to)
Sets who the packet is being sent "to".
|
java.lang.String |
toString() |
abstract java.lang.CharSequence |
toXML()
Returns the packet as XML.
|
protected static final java.lang.String DEFAULT_LANGUAGE
public static final java.lang.String ID_NOT_AVAILABLE
public Packet()
public Packet(Packet p)
public static java.lang.String nextID()
public static void setDefaultXmlns(java.lang.String defaultXmlns)
public java.lang.String getPacketID()
public void setPacketID(java.lang.String packetID)
packetID
- the unique ID for the packet.public java.lang.String getTo()
The StringUtils class provides several useful methods for dealing with
XMPP addresses such as parsing the
bare address
,
user name
,
server
, and
resource
.
public void setTo(java.lang.String to)
to
- who the packet is being sent to.public java.lang.String getFrom()
The StringUtils class provides several useful methods for dealing with
XMPP addresses such as parsing the
bare address
,
user name
,
server
, and
resource
.
public void setFrom(java.lang.String from)
from
- who the packet is being sent to.public XMPPError getError()
public void setError(XMPPError error)
error
- the error to associate with this packet.public java.util.Collection<PacketExtension> getExtensions()
public PacketExtension getExtension(java.lang.String namespace)
namespace
- the namespace of the extension that is desired.public PacketExtension getExtension(java.lang.String elementName, java.lang.String namespace)
ProviderManager
class to handle custom parsing. In that case, the type of the Object
will be determined by the provider.elementName
- the XML element name of the packet extension. (May be null)namespace
- the XML element namespace of the packet extension.public void addExtension(PacketExtension extension)
extension
- a packet extension.public void addExtensions(java.util.Collection<PacketExtension> extensions)
extensions
- a collection of packet extensionspublic void removeExtension(PacketExtension extension)
extension
- the packet extension to remove.public abstract java.lang.CharSequence toXML()
protected java.lang.CharSequence getExtensionsXML()
public java.lang.String getXmlns()
public static java.lang.String getDefaultLanguage()
public boolean equals(java.lang.Object o)
equals
in class java.lang.Object
public int hashCode()
hashCode
in class java.lang.Object
public java.lang.String toString()
toString
in class java.lang.Object
protected void addCommonAttributes(XmlStringBuilder xml)
xml
-