anyevent::xmpp::component(3pm) [debian man page]

AnyEvent::XMPP::Component(3pm)				User Contributed Perl Documentation			    AnyEvent::XMPP::Component(3pm)

NAME

       AnyEvent::XMPP::Component - "XML" stream that implements the XEP-0114

SYNOPSIS

	  use AnyEvent::XMPP::Component;

	  my $con = AnyEvent::XMPP::Component->new (
		       domain => 'chat.jabber.org'
		       host   => 'jabber.org',
		       port   => 5347,
		       secret => 'insecurepasswordforthehackers'
		    );
	  $con->reg_cb (session_ready => sub { ... });
	  $con->connect;

DESCRIPTION

       This module represents a XMPP connection to a server that authenticates as component.

       This module is a subclass of "AnyEvent::XMPP::Connection" and inherits all methods.  For example "reg_cb" and the stanza sending routines.

       For additional events that can be registered to look below in the EVENTS section.

       Please note that for component several functionality in AnyEvent::XMPP::Connection might have no effect or not the desired effect.
       Basically you should use the AnyEvent::XMPP::Component as component and only handle events the handle with incoming data. And only use
       functions that send stanzas.

       No effect has the event "stream_pre_authentication" and the "authenticate" method of AnyEvent::XMPP::Connection, because those handle the
       usual SASL or iq-auth authentication. "Jabber" components have a completly different authentication mechanism.

       Also note that the support for some XEPs in AnyEvent::XMPP::Ext is just thought for client side usage, if you miss any functionaly don't
       hesitate to ask the author or send him a patch! (See AnyEvent::XMPP for contact information).

METHODS

       new (%args)
	   This is the constructor. It takes the same arguments as the constructor of AnyEvent::XMPP::Connection along with a few others:

	   NOTE: Please note that some arguments that AnyEvent::XMPP::Connection usually takes have no effect when using this class. (That would
	   be the 'username', 'password', 'resource' and 'jid' arguments for example.)

	   secret => $secret
	       $secret is the secret that will be used for authentication with the server.

EVENTS

       These additional events can be registered on with "reg_cb":

       NOTE: The event "stream_pre_authentication" should _not_ be handled and just ignored. Don't attach callbacks to it!

       session_ready
	   This event indicates that the component has connected successfully and can now be used to transmit stanzas.

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::Component(3pm)

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)