anyevent::xmpp::ext::muc::message(3pm) [debian man page]
AnyEvent::XMPP::Ext::MUC::Message(3pm) User Contributed Perl Documentation AnyEvent::XMPP::Ext::MUC::Message(3pm)NAME
AnyEvent::XMPP::Ext::MUC::Message - A room message
SYNOPSIS DESCRIPTION
This message represents a message from a MUC room. It is derived from AnyEvent::XMPP::IM::Message. (You can use the methods from that class
to access it for example).
Also the methods like eg. "make_reply" return a AnyEvent::XMPP::Ext::MUC::Message.
METHODS
new (%args)
This constructor takes the same arguments that the constructor for AnyEvent::XMPP::IM::Message takes.
room
Returns the chatroom in which' context this message was sent.
send ([$room])
This method send this message. If $room is defined it will set the connection of this message object before it is send.
make_reply ([$msg])
This method returns a new instance of AnyEvent::XMPP::Ext::MUC::Message. The destination address, connection and type of the returned
message object will be set.
If $msg is defined and an instance of AnyEvent::XMPP::Ext::MUC::Message the destination address, connection and type of $msg will be
changed and this method will not return a new instance of AnyEvent::XMPP::Ext::MUC::Message.
If $self is a message of type 'groupchat' the "to" attribute will be set to the bare JID of the room for the reply.
from_nick
This method returns the nickname of the source of this message.
is_private
This method returns true when the message was not directed to the room, but privately to you.
AUTHOR
Robin Redeker, "<elmex at ta-sa.org>", JID: "<elmex at jabber.org>"
COPYRIGHT & LICENSE
Copyright 2007, 2008 Robin Redeker, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
perl v5.14.2 2012-01-23 AnyEvent::XMPP::Ext::MUC::Message(3pm)
Check Out this Related Man Page
AnyEvent::XMPP::Ext::Registration(3pm) User Contributed Perl Documentation AnyEvent::XMPP::Ext::Registration(3pm)NAME
AnyEvent::XMPP::Ext::Registration - Handles all tasks of in band registration
SYNOPSIS
my $con = AnyEvent::XMPP::Connection->new (...);
$con->reg_cb (stream_pre_authentication => sub {
my ($con) = @_;
my $reg = AnyEvent::XMPP::Ext::Registration->new (connection => $con);
$reg->send_registration_request (sub {
my ($reg, $form, $error) = @_;
if ($error) {
# error handling
} else {
my $af = $form->try_fillout_registration ("tester", "secret");
$reg->submit_form ($af, sub {
my ($reg, $ok, $error, $form) = @_;
if ($ok) { # registered successfully!
$con->authenticate
} else { # error
if ($form) { # we got an alternative form!
# fill it out and submit it with C<submit_form> again
}
}
});
}
});
0
});
DESCRIPTION
This module handles all tasks of in band registration that are possible and specified by XEP-0077. It's mainly a helper class that eases
some tasks such as submitting and retrieving a form.
METHODS
new (%args)
This is the constructor for a registration object.
connection
This must be a AnyEvent::XMPP::Connection (or some other subclass of that) object.
This argument is required.
send_registration_request ($cb)
This method sends a register form request. $cb will be called when either the form arrived or an error occured.
The first argument of $cb is always $self. If the form arrived the second argument of $cb will be a AnyEvent::XMPP::Ext::RegisterForm
object. If an error occured the second argument will be undef and the third argument will be a AnyEvent::XMPP::Error::Register object.
For hints how AnyEvent::XMPP::Ext::RegisterForm should be filled out look in XEP-0077. Either you have legacy form fields, out of band
data or a data form.
See also try_fillout_registration in AnyEvent::XMPP::Ext::RegisterForm.
send_unregistration_request ($cb)
This method sends an unregistration request.
For description of the semantics of the callback in $cb plase look in the description of the "submit_form" method below.
send_password_change_request ($username, $password, $cb)
This method sends a password change request for the user $username with the new password $password.
For description of the semantics of the callback in $cb plase look in the description of the "submit_form" method below.
submit_form ($form, $cb)
This method submits the $form which should be of type AnyEvent::XMPP::Ext::RegisterForm and should be an answer form.
$con is the connection on which to send this form.
$cb is the callback that will be called once the form has been submitted and either an error or success was received. The first
argument to the callback will be the AnyEvent::XMPP::Ext::Registration object, the second will be a boolean value that is true when the
form was successfully transmitted and everything is fine. If the second argument is false then the third argument is a
AnyEvent::XMPP::Error::Register object. If the error contained a data form which is required to successfully make the request then the
fourth argument will be a AnyEvent::XMPP::Ext::RegisterForm which you should fill out and send again with "submit_form".
For the semantics of such an error form see also XEP-0077.
AUTHOR
Robin Redeker, "<elmex at ta-sa.org>", JID: "<elmex at jabber.org>"
COPYRIGHT & LICENSE
Copyright 2007, 2008 Robin Redeker, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
perl v5.14.2 2012-01-23 AnyEvent::XMPP::Ext::Registration(3pm)