1Net::STOMP::Client::ConUnseecrtiCoonn(t3r)ibuted Perl DoNceutm:e:nStTaOtMiPo:n:Client::Connection(3)
2
3
4

NAME

6       Net::STOMP::Client::Connection - Connection support for
7       Net::STOMP::Client
8

DESCRIPTION

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

FUNCTIONS

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

SSL

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

FAILOVER

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

SEE ALSO

67       IO::Socket::IP, IO::Socket::SSL, Net::STOMP::Client.
68

AUTHOR

70       Lionel Cons <http://cern.ch/lionel.cons>
71
72       Copyright (C) CERN 2010-2021
73
74
75
76perl v5.38.0                      2023-07-21 Net::STOMP::Client::Connection(3)
Impressum