NAME¶

PGObject::Util::DBMethod - Declarative stored procedure <-> object mappings for the PGObject Framework

VERSION¶

Version 1.00.001

SYNOPSIS¶

Without PGObject::Util::DBobject, you would:

    sub mymethod {
        my ($self) = @_;
        return $self->call_dbmethod(funcname => 'foo');
    }

With this you'd do this instead:

    dbmethod mymethod => (funcname => 'foo');

EXPORT¶

This exports only dbmethod, which it always exports.

SUBROUTINES/METHODS¶

dbmethod¶

use as dbmethod (name => (default_arghash)) For example:

  package MyObject;
  use PGObject::Utils::DBMethod;
  dbmethod save => (
                                 strict_args => 0,
                                    funcname => 'save_user', 
                                  funcschema => 'public',
                                        args => { admin => 0 },
  );
  $MyObject->save(args => {username => 'foo', password => 'bar'});

Special arguments are:

arg_lit

It set must point to a hashref. Used to allow mapping of function arguments to arg hash elements. If this is set then funcname, funcschema, etc, cannot be overwritten on the call.

strict_args

If true, args override args provided by user.

returns_objects

If true, bless returned hashrefs before returning them.

merge_back

If true, merges the first record back to the $self at the end before returning, and returns $self. Note this is a copy only one layer deep which is fine for the use case of merging return values from the database into the current object.

AUTHOR¶

Chris Travers, "<chris.travers at gmail.com>"

BUGS¶

Please report any bugs or feature requests to "bug-pgobject-util-dbmethod at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=PGObject-Util-DBMethod>. 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 PGObject::Util::DBMethod

You can also look for information at:

•

RT: CPAN's request tracker (report bugs here)

<http://rt.cpan.org/NoAuth/Bugs.html?Dist=PGObject-Util-DBMethod>

•

AnnoCPAN: Annotated CPAN documentation

<http://annocpan.org/dist/PGObject-Util-DBMethod>

•

CPAN Ratings

<http://cpanratings.perl.org/d/PGObject-Util-DBMethod>

•

Search CPAN

<http://search.cpan.org/dist/PGObject-Util-DBMethod/>

ACKNOWLEDGEMENTS¶

LICENSE AND COPYRIGHT¶

Copyright 2014 Chris Travers. This program is released under the following license: BSD