table of contents
DBIx::Class::ResultClass::HashRefInflator(3) | User Contributed Perl Documentation | DBIx::Class::ResultClass::HashRefInflator(3) |
NAME¶
DBIx::Class::ResultClass::HashRefInflator - Get raw hashrefs from a resultset
SYNOPSIS¶
use DBIx::Class::ResultClass::HashRefInflator; my $rs = $schema->resultset('CD'); $rs->result_class('DBIx::Class::ResultClass::HashRefInflator'); while (my $hashref = $rs->next) { ... } OR as an attribute: my $rs = $schema->resultset('CD')->search({}, { result_class => 'DBIx::Class::ResultClass::HashRefInflator', }); while (my $hashref = $rs->next) { ... }
DESCRIPTION¶
DBIx::Class is faster than older ORMs like Class::DBI but it still isn't designed primarily for speed. Sometimes you need to quickly retrieve the data from a massive resultset, while skipping the creation of fancy result objects. Specifying this class as a "result_class" for a resultset will change "$rs->next" to return a plain data hash-ref (or a list of such hash-refs if "$rs->all" is used).
There are two ways of applying this class to a resultset:
- Specify "$rs->result_class" on a specific resultset to affect only that resultset (and any chained off of it); or
- Specify "__PACKAGE__->result_class" on your source object to force all uses of that result source to be inflated to hash-refs - this approach is not recommended.
METHODS¶
inflate_result¶
Inflates the result and prefetched data into a hash-ref (invoked by DBIx::Class::ResultSet)
CAVEATS¶
- This will not work for relationships that have been prefetched. Consider
the following:
my $artist = $artitsts_rs->search({}, {prefetch => 'cds' })->first; my $cds = $artist->cds; $cds->result_class('DBIx::Class::ResultClass::HashRefInflator'); my $first = $cds->first;
$first will not be a hashref, it will be a normal CD row since HashRefInflator only affects resultsets at inflation time, and prefetch causes relations to be inflated when the master $artist row is inflated.
- Column value inflation, e.g., using modules like DBIx::Class::InflateColumn::DateTime, is not performed. The returned hash contains the raw database values.
FURTHER QUESTIONS?¶
Check the list of additional DBIC resources.
COPYRIGHT AND LICENSE¶
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.
2022-05-18 | perl v5.40.0 |