1 contributor
package DBI::Custom;
use Object::Simple;
our $VERSION = '0.0101';
use Carp 'croak';
use DBI;
# Model
sub model : ClassAttr { auto_build => \&_inherit_model }
# Inherit super class model
sub _inherit_model {
my $class = shift;
my $super = do {
no strict 'refs';
${"${class}::ISA"}[0];
};
my $model = eval{$super->can('model')}
? $super->model->clone
: $class->Object::Simple::new;
$class->model($model);
}
# New
sub new {
my $self = shift->Object::Simple::new(@_);
my $class = ref $self;
return bless {%{$class->model->clone}, %{$self}}, $class;
}
# Initialize modle
sub initialize_model {
my ($class, $callback) = @_;
# Callback to initialize model
$callback->($class->model);
}
# Clone
sub clone {
my $self = shift;
my $new = $self->Object::Simple::new;
$new->connect_info(%{$self->connect_info || {}});
$new->filters(%{$self->filters || {}});
$new->bind_filter($self->bind_filter);
$new->fetch_filter($self->fetch_filter);
}
# Attribute
sub connect_info : Attr { type => 'hash', auto_build => sub { shift->connect_info({}) } }
sub bind_filter : Attr {}
sub fetch_filter : Attr {}
sub filters : Attr { type => 'hash', deref => 1, auto_build => sub { shift->filters({}) } }
sub add_filter { shift->filters(@_) }
sub dbh : Attr { auto_build => sub { shift->connect } }
sub sql_template : Attr { auto_build => sub { shift->sql_template(DBI::Custom::SQLTemplate->new) } }
our %VALID_CONNECT_INFO = map {$_ => 1} qw/data_source user password options/;
sub connect {
my $self = shift;
my $connect_info = $self->connect_info;
foreach my $key (keys %{$self->connect_info}) {
croak("connect_info '$key' is invald")
unless $VALID_CONNECT_INFO{$key};
}
my $dbh = DBI->connect(
$connect_info->{data_source},
$connect_info->{user},
$connect_info->{password},
{
RaiseError => 1,
PrintError => 0,
AutoCommit => 1,
%{$connect_info->{options} || {} }
}
);
$self->dbh($dbh);
}
sub create_sql {
my $self = shift;
my ($sql, @bind) = $self->sql_template->create_sql(@_);
return ($sql, @bind);
}
sub query {
my ($self, $template, $values, $filter) = @_;
$filter ||= $self->bind_filter;
my ($sql, @bind) = $self->creqte_sql($template, $values, $filter);
$self->prepare($sql);
$self->execute(@bind);
}
sub query_raw_sql {
my ($self, $sql, @bind) = @_;
$self->prepare($sql);
$self->execute(@bind);
}
Object::Simple->build_class;
package DBI::Custom::SQLTemplate;
use Object::Simple;
### Attributes;
sub tag_start : Attr { default => '{' }
sub tag_end : Attr { default => '}' }
sub template : Attr {};
sub tree : Attr { auto_build => sub { shift->tree([]) } }
sub create_sql {
my ($self, $template, $values, $filter) = @_;
$self->parse($template);
my ($sql, @bind);
return ($sql, @bind);
}
our $TAG_SYNTAX = <<'EOS';
[tag] [expand]
{= name} name = ?
{!= name} name != ?
{< name} name < ?
{> name} name > ?
{>= name} name >= ?
{<= name} name <= ?
{like name} name like ?
{in name} name in [?, ?, ..]
{insert_values} (key1, key2, key3) values (?, ?, ?)
{update_values} set key1 = ?, key2 = ?, key3 = ?
EOS
our %VALID_TAG_NAMES = map {$_ => 1} qw/=/;
sub parse {
my ($self, $template) = @_;
$self->template($template);
# Clean start;
delete $self->{tree};
# Tags
my $tag_start = quotemeta $self->tag_start;
my $tag_end = quotemeta $self->tag_end;
# Tokenize
my $state = 'text';
# Save original template
my $original_template = $template;
# Text
while ($template =~ s/([^$tag_start]*?)$tag_start([^$tag_end].*?)$tag_end//sm) {
my $text = $1;
my $tag = $2;
push @{$self->tree}, ['text', $text] if $text;
if ($tag) {
my ($tag_name, @params) = split /\s+/, $tag;
croak("Tag name is empty in '$tag'.\n" .
"Tag Syntax\n$TAG_SYNTAX.\n" .
"Your SQL template is \n$original_template")
unless length $tag_name;
croak("Tag name '$tag_name' in '$tag' is invalid.\n" .
"Tag Syntax\n$TAG_SYNTAX.\n" .
"Your SQL template is \n$original_template")
unless $VALID_TAG_NAMES{$tag_name};
push @{$self->tree}, [$tag_name, @params];
}
}
push @{$self->tree}, ['text', $template] if $template;
}
Object::Simple->build_class;
=head1 NAME
DBI::Custom - Customizable simple DBI
=head1 VERSION
Version 0.0101
=cut
=head1 SYNOPSIS
my $dbi = DBI::Custom->new;
=head1 METHODS
=head2 add_filter
=head2 bind_filter
=head2 clone
=head2 connect
=head2 connect_info
=head2 dbh
=head2 fetch_filter
=head2 filters
=head2 initialize_model
=head2 model
=head2 new
=head2 query
=head2 create_sql
=head2 query_raw_sql
=head2 sql_template
=head1 AUTHOR
Yuki Kimoto, C<< <kimoto.yuki at gmail.com> >>
=head1 BUGS
Please report any bugs or feature requests to C<bug-dbi-custom at rt.cpan.org>, or through
the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=DBI-Custom>. I will be notified, and then you'll
automatically be notified of progress on your bug as I make changes.
=head1 SUPPORT
You can find documentation for this module with the perldoc command.
perldoc DBI::Custom
You can also look for information at:
=over 4
=item * RT: CPAN's request tracker
L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=DBI-Custom>
=item * AnnoCPAN: Annotated CPAN documentation
L<http://annocpan.org/dist/DBI-Custom>
=item * CPAN Ratings
L<http://cpanratings.perl.org/d/DBI-Custom>
=item * Search CPAN
L<http://search.cpan.org/dist/DBI-Custom/>
=back
=head1 ACKNOWLEDGEMENTS
=head1 COPYRIGHT & LICENSE
Copyright 2009 Yuki Kimoto, all rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
=cut
1; # End of DBI::Custom