debian man page for jifty::dbi::filter

Query: jifty::dbi::filter

OS: debian

Section: 3pm

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

Jifty::DBI::Filter(3pm) 				User Contributed Perl Documentation				   Jifty::DBI::Filter(3pm)

NAME
Jifty::DBI::Filter - base class for Jifty::DBI filters
SYNOPSIS
# To implement your own filter package MyApp::Filter::Uppercase; use base qw/ Jifty::DBI::Filter /; # Setup for DB storage, store in lowercase sub encode { my $self = shift; my $value_ref = $self->value_ref; return unless defined $$value_ref; # don't blow up on undef $$value_ref = lc $$value_ref; } # Setup for Perl code to use, always sees uppercase sub decode { my $self = shift; my $value_ref = $self->value_ref; return unless defined $$value_ref; # don't blow up on undef $$value_ref = uc $$value_ref; } # To use a filter use MyApp::Record schema { column filtered => type is 'text', filters are qw/ MyApp::Filter::Uppercase /; };
DESCRIPTION
A filter allows Jifty::DBI models to tweak data prior to being stored and/or loaded. This is useful for marshalling and unmarshalling complex objects.
METHODS
new Takes three arguments in a parameter hash: value_ref A reference to the current value you're going to be massaging. "encode" works in place, massaging whatever value_ref refers to. column A Jifty::DBI::Column object, whatever sort of column we're working with here. handle A Jifty::DBI::Handle object, because some filters (i.e. Jifty::DBI::Filter::Boolean) depend on what database system is being used. encode "encode" takes data that users are handing to us and marshals it into a form suitable for sticking it in the database. This could be anything from flattening a DateTime object into an ISO date to making sure that data is utf8 clean. decode "decode" takes data that the database is handing back to us and gets it into a form that's OK to hand back to the user. This could be anything from inflating an ISO date to a DateTime object to making sure that the string properly has the utf8 flag.
SEE ALSO
Jifty::DBI::Filter::Date, Jifty::DBI::Filter::DateTime, Jifty::DBI::Filter:SaltHash, Jifty::DBI::Filter::Storable, Jifty::DBI::Filter::Time, Jifty::DBI::Filter::Truncate, Jifty::DBI::Filter::YAML, Jifty::DBI::Filter::base64, Jifty::DBI::Filter::utf8
LICENSE
Jifty::DBI is Copyright 2005-2007 Best Practical Solutions, LLC. Jifty::DBI is distributed under the same terms as Perl itself. perl v5.14.2 2010-12-09 Jifty::DBI::Filter(3pm)
Related Man Pages
jifty::action::record::create(3pm) - debian
jifty::action::record(3pm) - debian
jifty::dbi::collection::union(3pm) - debian
jifty::dbi::filter(3pm) - debian
jifty::dbi::record::memcached(3pm) - debian
Similar Topics in the Unix Linux Community
perl DBI: populate a scalar from a select statement
awk : Filter a set of data to parse header line and last field of multiple same match.
PERL one liner
Filter and merge 2 files problem
Filter file with condition