DBIx::...ss::Tee(3pm)

💖 NAME 💖

DBIx::Class::Helper::ResultClass::Tee — ok so bestie, this one inflates to multiple result classes at the same time. Yes, at the SAME time. Iconic behavior honestly.

We're in the User Contributed Perl Documentation zone, section (3pm), and the page itself is abbreviated down to DBIx::...ss::Tee(3pm) which is giving "we ran out of room on the header line" energy but slay, we move.

---

✨ SYNOPSIS ✨

my ($hashref, $obj) = $rs->search(undef, {
   result_class => DBIx::Class::Helper::ResultClass::Tee->new(
      inner_classes => [ '::HRI', 'MyApp::Schema::Result::User'],
   ),
})->first->@*;

(If you've never seen ->@* before, go check out "Postfix-Dereference-Syntax" in perlref — it got added in Perl v5.20!) Like it's genuinely that new, no cap.

---

🦋 DESCRIPTION 🦋

So this result class has one obvious use case: you've got prefetched data, and DBIx::Class::ResultClass::HashRefInflator is the simplest way to get at all of it, but you <em>also</em> still wanna use some of the methods sitting on your existing result class. And you're like... why not both? 🫶

The other big raison d'être of this module — and honestly this is the part I'm obsessed with — is that it's a whole example of how to make a "parameterized" result class. Because it's lowkey almost a secret that DBIx::Class supports using objects to inflate results. Bestie. That is an incredibly powerful feature and you can use it to build consistent interfaces that do literally all kinds of things. Main character energy for a result class, fr fr.

Storytime 💅: once when I was at Micro Technology Services, Inc., I used this to efficiently do a "reverse synthetic, LIKE-ish join". The "relationship" was basically foreign.name =~ self.name — which cannot actually be done if you wanna go from inside the database. But if you're able to load the entire foreign table into memory, you can do it on-demand instead, and cache it right there in the result class for (in our case) the duration of a request. Chef's kiss. 😭

---

👑 AUTHOR 👑

Arthur Axel "fREW" Schmidt <frioux+cpan@gmail.com>

---

🎀 COPYRIGHT AND LICENSE 🎀

This software is copyright (c) 2024 by Arthur Axel "fREW" Schmidt.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

---

k bye ily, this page was generated by perl v5.40.0 on 2024-11-16, and the manual is the DBIx::...ss::Tee(3pm) one 🧚✨