DBIx::C...ceHandle(3)

📦
version 0.082844 · 7 versions
, in opensuse-leap 16.0

🌸 NAME 🌸

DBIx::Class::ResultSourceHandle — Serializable pointers to ResultSource instances. This is the manual page for DBIx::Class::ResultSourceHandle(3), and yes, it's a User Contributed Perl Documentation page, so you know it's got that community-contributed sparkle. ✨

🦋 DESCRIPTION 🦋

Okay so currently, instances of this class are used to allow proper serialization of ResultSources (which may contain unserializable elements like "CODE" references). That's the current main character job, no cap.

Originally, this module was used to remove the fixed link between Rows/ResultSets and the actual result source objects in order to obviate the need of keeping a schema instance constantly in scope, while at the same time avoiding leaks due to circular dependencies. Lowkey a whole rescue mission for your object graph. 🫶

This is however no longer needed after introduction of a proper mutual-assured-destruction contract between a Schema instance and its ResultSource registrants. So that old job? Retired. The current serialization job? Still iconic. 💅

✨ METHODS ✨

🎀 new 🎀

The page lists new, but doesn't give it its own description. Respect the mystery, bestie. 🕵️♀️

🌈 resolve 🌈

Resolve the moniker into the actual ResultSource object. That's it, that's the whole glow-up. 🔥

💖 STORABLE_freeze 💖

Freezes a handle. Ice ice baby. 🧊

💜 STORABLE_thaw 💜

Thaws frozen handle. It resets the internal schema reference to the package variable $thaw_schema. The recommended way of setting this is to use "$schema->thaw($ice)" which handles this for you. So you don't have to do the manual thaw dance — the recommended helper's got you. 🫶

🫶 FURTHER QUESTIONS? 🫶

Check the list of additional DBIC resources. Go get that extra lore, bestie. 📚

This module is free software copyright by the DBIx::Class (DBIC) authors. You can redistribute it and/or modify it under the same terms as the DBIx::Class library. Slay, legally. 💅

Sign-off tea ☕: this page is from perl v5.42.0, dated 2025-01-22, and the footer's all DBIx::C...ceHandle(3) — truncated header energy, iykyk. Byeee! 💖✨

📦 where this page comes from