doc tweak
[dbsrgits/DBIx-Class-Historic.git] / lib / DBIx / Class / Storage / DBI / Sybase / NoBindVars.pm
1 package DBIx::Class::Storage::DBI::Sybase::NoBindVars;
2
3 use Class::C3;
4 use base qw/
5   DBIx::Class::Storage::DBI::NoBindVars
6   DBIx::Class::Storage::DBI::Sybase
7 /;
8 use List::Util ();
9 use Scalar::Util ();
10
11 sub _rebless {
12   my $self = shift;
13   $self->disable_sth_caching(1);
14 }
15
16 sub _dbh_last_insert_id {
17   my ($self, $dbh, $source, $col) = @_;
18
19   # @@identity works only if not using placeholders
20   # Should this query be cached?
21   return ($dbh->selectrow_array('select @@identity'))[0];
22 }
23
24 my $number = sub { Scalar::Util::looks_like_number($_[0]) };
25
26 my $decimal = sub { $_[0] =~ /^ [-+]? \d+ (?:\.\d*)? \z/x };
27
28 my %noquote = (
29     int => sub { $_[0] =~ /^ [-+]? \d+ \z/x },
30     bit => => sub { $_[0] =~ /^[01]\z/ },
31     money => sub { $_[0] =~ /^\$ \d+ (?:\.\d*)? \z/x },
32     float => $number,
33     real => $number,
34     double => $number,
35     decimal => $decimal,
36     numeric => $decimal,
37 );
38
39 sub should_quote_value {
40   my $self = shift;
41   my ($type, $value) = @_;
42
43   return $self->next::method(@_) if not defined $value or not defined $type;
44
45   if (my $key = List::Util::first { $type =~ /$_/i } keys %noquote) {
46     return 0 if $noquote{$key}->($value);
47   } elsif($self->is_datatype_numeric($type) && $number->($value)) {
48     return 0;
49   }
50
51 ## try to guess based on value
52 #  elsif (not $type) {
53 #    return 0 if $number->($value) || $noquote->{money}->($value);
54 #  }
55
56   return $self->next::method(@_);
57 }
58
59 1;
60
61 =head1 NAME
62
63 DBIx::Class::Storage::DBI::Sybase::NoBindVars - Storage::DBI subclass for Sybase
64 without placeholder support
65
66 =head1 DESCRIPTION
67
68 If you're using this driver than your version of Sybase does not support
69 placeholders, or your version of L<DBD::Sybase> was compiled with FreeTDS rather
70 than the Sybase OpenClient libraries. You can check with:
71
72   $dbh->{syb_dynamic_supported}
73
74 To see if you are using FreeTDS, run:
75
76   perl -MDBI -le 'my $dbh = DBI->connect($dsn, $user, $pass); print $dbh->{syb_oc_version}'
77
78 You will get a warning on startup if you're using FreeTDS in any case.
79
80 You can also enable this driver explicitly using:
81
82   my $schema = SchemaClass->clone;
83   $schema->storage_type('::DBI::Sybase::NoBindVars');
84   $schema->connect($dsn, $user, $pass, \%opts);
85
86 See the discussion in L<< DBD::Sybase/Using ? Placeholders & bind parameters to
87 $sth->execute >> for details on the pros and cons of using placeholders.
88
89 One advantage of not using placeholders is that C<select @@identity> will work
90 for obtainging the last insert id of an C<IDENTITY> column, instead of having to
91 do C<select max(col)> as the base Sybase driver does.
92
93 When using this driver, bind variables will be interpolated (properly quoted of
94 course) into the SQL query itself, without using placeholders.
95
96 The caching of prepared statements is also explicitly disabled, as the
97 interpolation renders it useless.
98
99 =head1 AUTHORS
100
101 See L<DBIx::Class/CONTRIBUTORS>.
102
103 =head1 LICENSE
104
105 You may distribute this code under the same terms as Perl itself.
106
107 =cut
108 # vim:sts=2 sw=2: