Net::ST...:Version(3)

🌸 NAME 🌸

Net::STOMP::Client::Version — bestie, this is the version support little helper for Net::STOMP::Client. It's the module that handles the whole "which STOMP version are we speaking" negotiation dance 💅

✨ SYNOPSIS ✨

  use Net::STOMP::Client;
  $stomp = Net::STOMP::Client->new(host => "127.0.0.1", port => 61613);
  ...
  # can change the acceptable versions only _before_ connect()
  $stomp->accept_version([ "1.1", "1.2" ]);
  ...
  $stomp->connect();
  ...
  # can get the negotiated version only _after_ connect()
  printf("using STOMP %s\n", $stomp->version());

okay so notice the ordering bestie — that's the whole plot twist 📖✨ the version list is a before connect() thing, and reading the negotiated version is an after connect() thing. No cap.

🦋 DESCRIPTION 🦋

This module is the one doing the STOMP protocol version negotiation. It's used internally by Net::STOMP::Client — so like, if you're not that module, please don't touch it directly? 🙈 It said what it said.

🎀 METHODS 🎀

Here's the tea: this module hands the following methods to Net::STOMP::Client 🫶

• accept_version([VALUE]) — get/set the list of acceptable STOMP protocol versions, iykyk 🍓 The given VALUE can be any of these three moods:
  • undef — meaning all supported versions, the "I'm flexible, I trust the universe" option 🌈
  • a single version — just the one, main character energy 👑
  • an array reference — for when you want multiple versions on the menu 💖
• version([STRING]) — get the negotiated STOMP protocol version. That's the one y'all actually agreed on after the handshake 💅

⚠️ Real talk: accept_version only works its magic before connect(), and version() only gives you the goods after connect(). Timing is everything, bestie 😭

👑 SUPPORTED VERSIONS 👑

Net::STOMP::Client supports these three icons of the STOMP protocol 🔥

• 1.0 — see <http://stomp.github.com/stomp-specification-1.0.html>
• 1.1 — see <http://stomp.github.com/stomp-specification-1.1.html>
• 1.2 — see <http://stomp.github.com/stomp-specification-1.2.html>

Literally the whole lineup, slay ✨

🌈 SEE ALSO 🌈

Net::STOMP::Client — the main character this whole module supports 🫶

💜 AUTHOR 💜

Lionel Cons <http://cern.ch/lionel.cons>

Copyright (C) CERN 2010-2017

---

and that's the whole page, bestie 🎀 fr fr — signed off from the perl v5.32.1 era, dated 2019-07-26, living under the Net::ST...:Version(3) header the whole time 💖✨