DBIx::Class::Row - Basic row methods
This class is responsible for defining and doing basic operations on rows derived from DBIx::Class::Table objects.
my $obj = My::Class->new($attrs);
Creates a new row object from column => value mappings passed as a hash ref
$obj->insert;
Inserts an object into the database if it isn't already in there. Returns the object itself. Requires the object's result source to be set, or the class to have a result_source_instance method.
$obj->in_storage; # Get value $obj->in_storage(1); # Set value
Indicated whether the object exists as a row in the database or not
$obj->update;
Must be run on an object that is already in the database; issues an SQL UPDATE query to commit any changes to the object to the db if required.
$obj->delete
Deletes the object from the database. The object is still perfectly usable accessor-wise etc. but ->in_storage will now return 0 and the object must be re ->insert'ed before it can be ->update'ed
my $val = $obj->get_column($col);
Gets a column value from a row object. Currently, does not do any queries; the column must have already been fetched from the database and stored in the object.
my %data = $obj->get_columns;
Does get_column, for all column values at once.
get_column
my %data = $obj->get_dirty_columns;
Identical to get_columns but only returns those that have been changed.
$obj->set_column($col => $val);
Sets a column value. If the new value is different from the old one, the column is marked as dirty for when you next call $obj->update.
my $copy = $orig->set_columns({ $col => $val, ... });
Sets more than one column value at once.
my $copy = $orig->copy({ change => $to, ... });
Inserts a new row with the specified changes.
$obj->store_column($col => $val);
Sets a column value without marking it as dirty.
Class->inflate_result($result_source, \%me, \%prefetch?)
Called by ResultSet to inflate a result from storage
$obj->insert_or_update
Updates the object if it's already in the db, else inserts it.
my @changed_col_names = $obj->is_changed
Accessor to the ResultSource this object was created from
Registers a column on the class and creates an accessor for it
Matt S. Trout <mst@shadowcatsystems.co.uk>
You may distribute this code under the same terms as Perl itself.
To install DBIx::Class, copy and paste the appropriate command in to your terminal.
cpanm
cpanm DBIx::Class
CPAN shell
perl -MCPAN -e shell install DBIx::Class
For more information on module installation, please visit the detailed CPAN module installation guide.