NAME
Net::Jabber::IQ - Jabber Info/Query Library
SYNOPSIS
Net::Jabber::IQ is a companion to the Net::Jabber module. It
provides the user a simple interface to set and retrieve all {iq}->
parts of a Jabber IQ.DESCRIPTION
Net::Jabber::IQ differs from the other Net::Jabber::* modules in that
the XMLNS of the query is split out into more submodules under
IQ. For specifics on each module please view the documentation
for each Net::Jabber::Query::* module. To see the list of avilable
namspaces and modules see Net::Jabber::Query.
To initialize the IQ with a Jabber <iq/> you must pass it the
XML::Parser Tree array. For example:
my $iq = new Net::Jabber::IQ(@tree);
There has been a change from the old way of handling the callbacks.
You no longer have to do the above, a Net::Jabber::IQ object is passed
to the callback function for the iq:
use Net::Jabber;
sub iq {
my ($IQ) = @_;
.
.
.
}
You now have access to all of the retrieval functions available.
To create a new iq to send to the server:
use Net::Jabber;
$IQ = new Net::Jabber::IQ();
$IQType = $IQ->NewQuery( type );
$IQType->SetXXXXX("yyyyy");
Now you can call the creation functions for the IQ, and for the <query/>
on the new Query object itself. See below for the <iq/> functions, and
in each query module for those functions.
For more information about the array format being passed to the CallBack
please read the Net::Jabber::Client documentation.Retrieval functions
$to = $IQ->GetTo();
$toJID = $IQ->GetTo("jid");
$from = $IQ->GetFrom();
$fromJID = $IQ->GetFrom("jid");
$id = $IQ->GetID();
$type = $IQ->GetType();
$error = $IQ->GetError();
$errorCode = $IQ->GetErrorCode();
$queryTag = $IQ->GetQuery();
$queryTree = $IQ->GetQueryTree();
$str = $IQ->GetXML();
@iq = $IQ->GetTree();Creation functions
$IQ->SetIQ(tYpE=>"get",
tO=>"bob@jabber.org",
query=>"info");
$IQ->SetTo("bob@jabber.org");
$IQ->SetFrom("me\@jabber.org");
$IQ->SetType("set");
$IQ->SetIQ(to=>"bob\@jabber.org",
errorcode=>403,
error=>"Permission Denied");
$IQ->SetErrorCode(403);
$IQ->SetError("Permission Denied");
$IQObject = $IQ->NewQuery("jabber:iq:auth");
$IQObject = $IQ->NewQuery("jabber:iq:roster");
$iqReply = $IQ->Reply();
$iqReply = $IQ->Reply("client");
$iqReply = $IQ->Reply("transport");Test functions
$test = $IQ->DefinedTo();
$test = $IQ->DefinedFrom();
$test = $IQ->DefinedID();
$test = $IQ->DefinedType();
$test = $IQ->DefinedError();
$test = $IQ->DefinedErrorCode();METHODS
Retrieval functions
GetTo() - returns either a string with the Jabber Identifier,
GetTo("jid") or a Net::Jabber::JID object for the person who is
going to receive the <iq/>. To get the JID
object set the string to "jid", otherwise leave
blank for the text string.
GetFrom() - returns either a string with the Jabber Identifier,
GetFrom("jid") or a Net::Jabber::JID object for the person who
sent the <iq/>. To get the JID object set
the string to "jid", otherwise leave blank for the
text string.
GetType() - returns a string with the type <iq/> this is.
GetID() - returns an integer with the id of the <iq/>.
GetError() - returns a string with the text description of the error.
GetErrorCode() - returns a string with the code of error.
GetQuery() - returns a Net::Jabber::Query object that contains the data
in the <query/> of the <iq/>.
GetQueryTree() - returns an XML::Parser::Tree object that contains the
data in the <query/> of the <iq/>.
GetXML() - returns the XML string that represents the <iq/>. This
is used by the Send() function in Client.pm to send
this object as a Jabber IQ.
GetTree() - returns an array that contains the <iq/> tag in XML::Parser
Tree format.Creation functions
SetIQ(to=>string|JID, - set multiple fields in the <iq/> at one
from=>string|JID, time. This is a cumulative and over
id=>string, writing action. If you set the "to"
type=>string, attribute twice, the second setting is
errorcode=>string, what is used. If you set the status, and
error=>string) then set the priority then both will be in
the <iq/> tag. For valid settings read the
specific Set functions below.
SetTo(string) - sets the to attribute. You can either pass a string
SetTo(JID) or a JID object. They must be a valid Jabber
Identifiers or the server will return an error message.
(ie. jabber:bob@jabber.org, etc...)
SetFrom(string) - sets the from attribute. You can either pass a string
SetFrom(JID) or a JID object. They must be a valid Jabber
Identifiers or the server will return an error message.
(ie. jabber:bob@jabber.org, etc...)
SetType(string) - sets the type attribute. Valid settings are:
get request information
set set information
result results of a get
SetErrorCode(string) - sets the error code of the <iq/>.
SetError(string) - sets the error string of the <iq/>.
NewQuery(string) - creates a new Net::Jabber::Query object with the
namespace in the string. In order for this function
to work with a custom namespace, you must define and
register that namespace with the IQ module. For more
information please read the documentation for
Net::Jabber::Query. NOTE: Jabber does not support
custom IQs at the time of this writing. This was just
including in case they do at some point.
Reply(type=>string) - creates a new IQ object and populates the to/from
fields. The type will be set in the <iq/>.Test functions
DefinedTo() - returns 1 if the to attribute is defined in the <iq/>,
0 otherwise.
DefinedFrom() - returns 1 if the from attribute is defined in the <iq/>,
0 otherwise.
DefinedID() - returns 1 if the id attribute is defined in the <iq/>,
0 otherwise.
DefinedType() - returns 1 if the type attribute is defined in the <iq/>,
0 otherwise.
DefinedError() - returns 1 if <error/> is defined in the <iq/>,
0 otherwise.
DefinedErrorCode() - returns 1 if the code attribute is defined in
<error/>, 0 otherwise.AUTHOR
By Ryan Eatmon in May of 2000 for http://jabber.org..
COPYRIGHT
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.