Package pyxmpp :: Module message :: Class Message
[show private | hide private]
[frames | no frames]

Class Message

Stanza --+
         |
        Message


Wraper object for <message /> stanzas.

Method Summary
  __init__(self, xmlnode, from_jid, to_jid, stanza_type, stanza_id, subject, body, thread, error, error_cond)
Initialize a `Message` object.
  copy(self)
Create a deep copy of the message stanza.
  get_body(self)
Get the body of the message.
  get_subject(self)
Get the message subject.
  get_thread(self)
Get the thread-id subject.
  make_error_response(self, cond)
Create error response for any non-error message stanza.
    Inherited from Stanza
  __del__(self)
  __eq__(self, other)
  __ne__(self, other)
  add_content(self, content)
Add an XML node to the stanza's payload.
  add_new_content(self, ns_uri, name)
Add a new XML element to the stanza payload.
  free(self)
Free the node associated with this `Stanza` object.
  get_error(self)
Get stanza error information.
  get_from(self)
Get "from" attribute of the stanza.
  get_from_jid(self)
Get "from" attribute of the stanza.
  get_id(self)
Get "id" attribute of the stanza.
  get_node(self)
Return the XML node wrapped into `self`.
  get_stanza_id(self)
Get "id" attribute of the stanza.
  get_stanza_type(self)
Get "type" attribute of the stanza.
  get_to(self)
Get "to" attribute of the stanza.
  get_to_jid(self)
Get "to" attribute of the stanza.
  get_type(self)
Get "type" attribute of the stanza.
  serialize(self)
Serialize the stanza into an UTF-8 encoded XML string.
  set_content(self, content)
Set stanza content to an XML node.
  set_from(self, from_jid)
Set "from" attribute of the stanza.
  set_id(self, stanza_id)
Set "id" attribute of the stanza.
  set_new_content(self, ns_uri, name)
Set stanza payload to a new XML element.
  set_to(self, to_jid)
Set "to" attribute of the stanza.
  set_type(self, stanza_type)
Set "type" attribute of the stanza.
  xpath_eval(self, expr, namespaces)
Evaluate an XPath expression on the stanza XML node.

Class Variable Summary
str stanza_type = 'message'

Method Details

__init__(self, xmlnode=None, from_jid=None, to_jid=None, stanza_type=None, stanza_id=None, subject=None, body=None, thread=None, error=None, error_cond=None)
(Constructor)

Initialize a `Message` object.

:Parameters:
    - `xmlnode`: XML node to_jid be wrapped into the `Message` object
      or other Message object to be copied. If not given then new
      presence stanza is created using following parameters.
    - `from_jid`: sender JID.
    - `to_jid`: recipient JID.
    - `stanza_type`: staza type: one of: "get", "set", "result" or "error".
    - `stanza_id`: stanza id -- value of stanza's "id" attribute. If not
      given, then unique for the session value is generated.
    - `subject`: message subject,
    - `body`: message body.
    - `thread`: message thread id.
    - `error_cond`: error condition name. Ignored if `stanza_type` is not "error".
:Types:
    - `xmlnode`: `unicode` or `libxml2.xmlNode` or `Stanza`
    - `from_jid`: `JID`
    - `to_jid`: `JID`
    - `stanza_type`: `unicode`
    - `stanza_id`: `unicode`
    - `subject`: `unicode`
    - `body`: `unicode`
    - `thread`: `unicode`
    - `error_cond`: `unicode`
Overrides:
pyxmpp.stanza.Stanza.__init__

copy(self)

Create a deep copy of the message stanza.

:returntype: `Message`
Overrides:
pyxmpp.stanza.Stanza.copy

get_body(self)

Get the body of the message.

:return: the body of the message or `None` if there is no body.
:returntype: `unicode`

get_subject(self)

Get the message subject.

:return: the message subject or `None` if there is no subject.
:returntype: `unicode`

get_thread(self)

Get the thread-id subject.

:return: the thread-id or `None` if there is no thread-id.
:returntype: `unicode`

make_error_response(self, cond)

Create error response for any non-error message stanza.

:Parameters:
    - `cond`: error condition name, as defined in XMPP specification.

:return: new message stanza with the same "id" as self, "from" and
    "to" attributes swapped, type="error" and containing <error />
    element plus payload of `self`.
:returntype: `unicode`

Class Variable Details

stanza_type

Type:
str
Value:
'message'                                                              

Generated by Epydoc 2.1 on Wed May 31 22:37:02 2006 http://epydoc.sf.net