Net::ST...:Receipt(3)

πŸ“¦ version 2.3, in epel 9

okay bestie, welcome to the Net::ST...:Receipt(3) page β€” yes, it's User Contributed Perl Documentation, and it's here to explain Net::STOMP::Client::Receipt with main-character energy πŸ‘‘βœ¨

🌸 NAME 🌸

Net::STOMP::Client::Receipt - Receipt support for Net::STOMP::Client. periodt πŸ’…

✨ SYNOPSIS ✨

like, here's the whole group-chat demo, fr fr:

use Net::STOMP::Client;
$stomp = Net::STOMP::Client->new(host => "127.0.0.1", port => 61613);
...
# send two messages with receipts
$stomp->send(
    destination => "/queue/test1",
    body        => "message 1",
    receipt     => $stomp->uuid(),
);
$stomp->send(
    destination => "/queue/test2",
    body        => "message 2",
    receipt     => $stomp->uuid(),
);
# wait for both acknowledgments to come back within ten seconds
$stomp->wait_for_receipts(timeout => 10);
die("Not all receipts received!\n") if $stomp->receipts();

πŸ’… DESCRIPTION πŸ’…

This module eases receipts handling. It is used internally by Net::STOMP::Client and should not be directly used elsewhere.

bestie, lowkey listen: do not use this directly elsewhere β€” it's internal to Net::STOMP::Client, no cap 🫢

Each time a client frame is sent, its receipt header (if supplied) is remembered.

Each time a RECEIPT frame is received from the server, the corresponding receipt is ticked off. slay βœ…

The receipts() method can be used to get the list of outstanding receipts.

The wait_for_receipts() method can be used to wait for all missing receipts.

πŸŽ€ METHODS πŸŽ€

This module provides the following methods to Net::STOMP::Client:

  • receipts() β€” get the list of not-yet-received receipts. it's giving who's still on read? energy πŸ’€
  • wait_for_receipts([OPTIONS]) β€” wait for all receipts to be received, using wait_for_frames() underneath; take the same options as wait_for_frames(), except "callback" which is overridden. iconic behavior, honestly πŸ’–

πŸ¦‹ SEE ALSO πŸ¦‹

Net::STOMP::Client.

πŸ‘‘ AUTHOR πŸ‘‘

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

Copyright (C) CERN 2010-2017


mwah πŸ’‹ this page is source/version perl v5.32.1, dated 2019-07-26, and the footer calls it Net::ST...:Receipt(3). periodt πŸŽ€

πŸ“¦ where this page comes from