The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

 / 
DBICx-Modeler-0.005
River stage zero No dependents
/ DBICx::Modeler

NAME

DBICx::Modeler - A Moose-based model layer over DBIx::Class

VERSION

Version 0.005

SYNOPSIS


            

              
              
# Given the following schema:
My::Schema::Artist
My::Schema::Cd
My::Schema::Track
# ... and the following model:
My::Model::Artist
use DBICx::Modeler::Model
My::Model::Cd ...
My::Model::Track ...
...
my $modeler = DBICx::Modeler->new( schema => ..., namespace => My::Model );
my $artist = $modeler->create( Artist => { ... } ) # $artist is My::Model::Artist
my $cd = $artist->create_related( cds => { ... } ) # $cd is My::Model::Cd
...
my $search = $artist->cds( { title => ... } ) # Start a search ...
$search->search( { ... } ) # Refine the search ...
my @cds = $search->slice( 0, 9 ) # Get the first 10     
                                 # Each is of type My::Model::Cd

DESCRIPTION

DBICx::Modeler is tool for making a thin, Moose-based model layer over a DBIx::Class schema

CAVEAT EMPTOR

Many-to-many is not handled

Many-to-many relationships are ignored, for now. You'll have to access _model__storage (which is the DBIx::Class::Row) if you want to play with them

The same storage object can be present in different model objects


            

              
              
# With the following example:
$artist->cds( ... )->slice( 0 )->artist # $artist and ->artist are different objects

This shouldn't be too difficult to fix.

The modeler will probably barf when trying to modify immutable Model:: classes

This shouldn't be too difficult to fix, either.

Use DBIC_MODELER to trace modeler setup

Set DBIC_MODELER to 1 if you want to trace what is going on in the modeler internally


            

              
              
$ENV{DBIC_MODELER} = 1

METHODS

DBICx::Modeler->new( ... )


            

              
              
schema          The connected DBIx::Class schema to use/inspect
namespace       The package containing the Moose classes that will mimic the class structure of <schema>

$modeler->model( <moniker> )


            

              
              
Return the model source for <moniker>

$modeler->create( <moniker> => ... )


            

              
              
Create a new row for <moniker> and return the modeled object

$modeler->search( <moniker> => ... )


            

              
              
Make a search of <moniker> that will inflate into modeled objects

AUTHOR

Robert Krimen, <rkrimen at cpan.org>

BUGS

Please report any bugs or feature requests to bug-dbicx-modeler at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=DBICx-Modeler. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.


            

              
              
perldoc DBICx::Modeler

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2009 Robert Krimen, all rights reserved.

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