MR::IP...Cluster(3pm)

💖 MR::IProto::Cluster — the cluster-of-servers page (3pm, bestie) 💖

okay so real talk, this is MR::IProto::Cluster, and no cap, it's the lil class that handles balancing between a whole squad of servers. let's get into it 🫶

✨ NAME ✨

MR::IProto::Cluster — literally just a cluster of servers, that's the whole vibe 💅

🌸 DESCRIPTION 🌸

so this class is used to implement balancing between several servers. that's it, that's the girl. she's the one picking which server gets the honor of your request 👑

🎀 EXPORTED CONSTANTS 🎀

these are the algorithm constants, and yes you can just use them by name:

• RR — Round robin algorithm. everybody gets a turn, take turns, be fair, we love to see it 💖
• HASH — hashing algorithm using CRC32. ngl CRC32 is doing the heavy lifting here 🔥
• KETAMA — the Ketama algorithm. iconic, mysterious, consistent-hashing queen ✨

🦋 ATTRIBUTES 🦋

• balance — the balancing algorithm, bestie. possible values are the constants RR, HASH, KETAMA, or their string analogs: 'round-robin', 'hash-crc32', 'ketama'. pick your fighter 🌈
• servers — an ArrayRef of MR::IProto::Cluster::Server. yes, actual server objects, plural, the whole friend group 💜

👑 PUBLIC METHODS 👑

server( $key? )

get a server from balancing using $key. the optional key matters for the hashing ones, iykyk 🔑

timeout( $new? )

used to set the $new timeout value to all servers. and here's the tea: if the argument is skipped and the timeout is equal for all servers, then it returns its value. if the timeout is different, then it returns undef. 💀

no timeout argument + mismatched timeouts = undef. that's the rules, don't come for her 🙈

🌟 SEE ALSO 🌟

• MR::IProto
• MR::IProto::Cluster::Server

go read those too, they're part of the lore 📚

and that's the page, bestie!! this was perl v5.30.3, dated 2020-07-21 — so yeah, she's been serving since way back, and she still ate 💅✨ mwah, ily, go balance some servers 🎀🦋