1AnyEvent::XMPP::ComponeUnste(r3)Contributed Perl DocumenAtnaytEivoennt::XMPP::Component(3)
2
3
4
6 AnyEvent::XMPP::Component - "XML" stream that implements the XEP-0114
7
9 use AnyEvent::XMPP::Component;
10
11 my $con = AnyEvent::XMPP::Component->new (
12 domain => 'chat.jabber.org'
13 host => 'jabber.org',
14 port => 5347,
15 secret => 'insecurepasswordforthehackers'
16 );
17 $con->reg_cb (session_ready => sub { ... });
18 $con->connect;
19
21 This module represents a XMPP connection to a server that authenticates
22 as component.
23
24 This module is a subclass of "AnyEvent::XMPP::Connection" and inherits
25 all methods. For example "reg_cb" and the stanza sending routines.
26
27 For additional events that can be registered to look below in the
28 EVENTS section.
29
30 Please note that for component several functionality in
31 AnyEvent::XMPP::Connection might have no effect or not the desired
32 effect. Basically you should use the AnyEvent::XMPP::Component as
33 component and only handle events the handle with incoming data. And
34 only use functions that send stanzas.
35
36 No effect has the event "stream_pre_authentication" and the
37 "authenticate" method of AnyEvent::XMPP::Connection, because those
38 handle the usual SASL or iq-auth authentication. "Jabber" components
39 have a completly different authentication mechanism.
40
41 Also note that the support for some XEPs in AnyEvent::XMPP::Ext is just
42 thought for client side usage, if you miss any functionaly don't
43 hesitate to ask the author or send him a patch! (See AnyEvent::XMPP for
44 contact information).
45
47 new (%args)
48 This is the constructor. It takes the same arguments as the
49 constructor of AnyEvent::XMPP::Connection along with a few others:
50
51 NOTE: Please note that some arguments that
52 AnyEvent::XMPP::Connection usually takes have no effect when using
53 this class. (That would be the 'username', 'password', 'resource'
54 and 'jid' arguments for example.)
55
56 secret => $secret
57 $secret is the secret that will be used for authentication with
58 the server.
59
61 These additional events can be registered on with "reg_cb":
62
63 NOTE: The event "stream_pre_authentication" should _not_ be handled and
64 just ignored. Don't attach callbacks to it!
65
66 session_ready
67 This event indicates that the component has connected successfully
68 and can now be used to transmit stanzas.
69
71 Robin Redeker, "<elmex at ta-sa.org>", JID: "<elmex at jabber.org>"
72
74 Copyright 2007, 2008 Robin Redeker, all rights reserved.
75
76 This program is free software; you can redistribute it and/or modify it
77 under the same terms as Perl itself.
78
79
80
81perl v5.38.0 2023-07-20 AnyEvent::XMPP::Component(3)