1Net::STOMP::Client::ConUnseecrtiCoonn(t3r)ibuted Perl DoNceutm:e:nStTaOtMiPo:n:Client::Connection(3)
2
3
4
6 Net::STOMP::Client::Connection - Connection support for
7 Net::STOMP::Client
8
10 This module provides connection establishment support (plain TCP and
11 SSL) as well as URI handling.
12
13 It is used internally by Net::STOMP::Client and should not be directly
14 used elsewhere.
15
17 This module provides the following function (which is not exported):
18
19 new([OPTIONS])
20 attempt to establish a new connection to a STOMP server
21
23 When creating an object with Net::STOMP::Client's new() method, if you
24 supply some socket options (via "sockopts") with a name starting with
25 "SSL_" or if you supply a URI (via "uri") with a scheme containg "ssl"
26 then IO::Socket::SSL will be used to create the socket instead of
27 IO::Socket::IP and the communication with the server will then go
28 through SSL.
29
30 Here are the most commonly used SSL socket options:
31
32 SSL_ca_path
33 path to a directory containing several trusted certificates as
34 separate files as well as an index of the certificates
35
36 SSL_key_file
37 path of your RSA private key
38
39 SSL_cert_file
40 path of your certificate
41
42 SSL_passwd_cb
43 subroutine that should return the password required to decrypt your
44 private key
45
46 For more information, see IO::Socket::SSL.
47
49 The "uri" option of Net::STOMP::Client's new() method can be given a
50 complex URI indicating some kind of failover, for instance:
51 "failover:(tcp://msg01:6163,tcp://msg02:6163)".
52
53 The given URI must use the ActiveMQ failover syntax (see
54 <http://activemq.apache.org/failover-transport-reference.html>) and
55 only some options are supported, namely: "backOffMultiplier",
56 "initialReconnectDelay", "maxReconnectAttempts", "maxReconnectDelay",
57 "randomize" and "useExponentialBackOff".
58
59 When specified, these failover options will be used only inside the
60 new() method (so at the TCP connection level) and not elsewhere. If the
61 broker later fails during the STOMP interaction, it is up to the
62 program author, knowing the logic of his code, to perform the
63 appropriate recovery actions and eventually reconnect, using again the
64 new() method.
65
67 IO::Socket::IP, IO::Socket::SSL, Net::STOMP::Client.
68
70 Lionel Cons <http://cern.ch/lionel.cons>
71
72 Copyright (C) CERN 2010-2021
73
74
75
76perl v5.36.0 2022-07-22 Net::STOMP::Client::Connection(3)