NAME
DBIx::DataModel::Statement - DBIx::DataModel statement objects
DESCRIPTION
The purpose of a statement object is to retrieve rows from the database and bless them as objects of appropriate classes.
Internally the statement builds and then encapsulates a DBI
statement handle (sth).
The design principles for statements are described in the DESIGN section of the manual (purpose, lifecycle, etc.).
METHODS
new
my $statement
= DBIx::DataModel::Statement->new($meta_source, $schema, %options);
This is the statement constructor; $meta_source
is an instance of DBIx::DataModel::Meta::Source (either a meta-table or a meta-join), and schema
is an instance of DBIx::DataModel::Schema. If present, %options
are delegated to the refine() method.
Explicit calls to the statement constructor are exceptional; the usual way to create a statement is through a schema's table() or join() method.
PRIVATE METHOD NAMES
The following methods or functions are used internally by this module and should be considered as reserved names, not to be redefined in subclasses :