* Fixed the bug with omitting 'FOR UPDATE'/'FOR SHARED' (introduced from the 'subque...
[dbsrgits/DBIx-Class.git] / lib / DBIx / Class / Storage / DBI / Oracle / Generic.pm
1 package DBIx::Class::Storage::DBI::Oracle::Generic;
2 # -*- mode: cperl; cperl-indent-level: 2 -*-
3
4 use strict;
5 use warnings;
6
7 =head1 NAME
8
9 DBIx::Class::Storage::DBI::Oracle::Generic - Automatic primary key class for Oracle
10
11 =head1 SYNOPSIS
12
13   # In your table classes
14   __PACKAGE__->load_components(qw/PK::Auto Core/);
15   __PACKAGE__->add_columns({ id => { sequence => 'mysequence', auto_nextval => 1 } });
16   __PACKAGE__->set_primary_key('id');
17   __PACKAGE__->sequence('mysequence');
18
19 =head1 DESCRIPTION
20
21 This class implements autoincrements for Oracle.
22
23 =head1 METHODS
24
25 =cut
26
27 use Carp::Clan qw/^DBIx::Class/;
28
29 use base qw/DBIx::Class::Storage::DBI::MultiDistinctEmulation/;
30
31 # __PACKAGE__->load_components(qw/PK::Auto/);
32
33 sub _dbh_last_insert_id {
34   my ($self, $dbh, $source, @columns) = @_;
35   my @ids = ();
36   foreach my $col (@columns) {
37     my $seq = ($source->column_info($col)->{sequence} ||= $self->get_autoinc_seq($source,$col));
38     my $id = $self->_sequence_fetch( 'currval', $seq );
39     push @ids, $id;
40   }
41   return @ids;
42 }
43
44 sub _dbh_get_autoinc_seq {
45   my ($self, $dbh, $source, $col) = @_;
46
47   # look up the correct sequence automatically
48   my $sql = q{
49     SELECT trigger_body FROM ALL_TRIGGERS t
50     WHERE t.table_name = ?
51     AND t.triggering_event = 'INSERT'
52     AND t.status = 'ENABLED'
53   };
54
55   # trigger_body is a LONG
56   $dbh->{LongReadLen} = 64 * 1024 if ($dbh->{LongReadLen} < 64 * 1024);
57
58   my $sth;
59
60   # check for fully-qualified name (eg. SCHEMA.TABLENAME)
61   if ( my ( $schema, $table ) = $source->name =~ /(\w+)\.(\w+)/ ) {
62     $sql = q{
63       SELECT trigger_body FROM ALL_TRIGGERS t
64       WHERE t.owner = ? AND t.table_name = ?
65       AND t.triggering_event = 'INSERT'
66       AND t.status = 'ENABLED'
67     };
68     $sth = $dbh->prepare($sql);
69     $sth->execute( uc($schema), uc($table) );
70   }
71   else {
72     $sth = $dbh->prepare($sql);
73     $sth->execute( uc( $source->name ) );
74   }
75   while (my ($insert_trigger) = $sth->fetchrow_array) {
76     return uc($1) if $insert_trigger =~ m!(\w+)\.nextval!i; # col name goes here???
77   }
78   $self->throw_exception("Unable to find a sequence INSERT trigger on table '" . $source->name . "'.");
79 }
80
81 sub _sequence_fetch {
82   my ( $self, $type, $seq ) = @_;
83   my ($id) = $self->dbh->selectrow_array("SELECT ${seq}.${type} FROM DUAL");
84   return $id;
85 }
86
87 sub connected {
88   my $self = shift;
89
90   if (not $self->SUPER::connected(@_)) {
91     return 0;
92   }
93   else {
94     my $dbh = $self->_dbh;
95
96     local $dbh->{RaiseError} = 1;
97
98     eval {
99       my $ping_sth = $dbh->prepare_cached("select 1 from dual");
100       $ping_sth->execute;
101       $ping_sth->finish;
102     };
103
104     return $@ ? 0 : 1;
105   }
106 }
107
108 sub _dbh_execute {
109   my $self = shift;
110   my ($dbh, $op, $extra_bind, $ident, $bind_attributes, @args) = @_;
111
112   my $wantarray = wantarray;
113
114   my (@res, $exception, $retried);
115
116   do {
117     eval {
118       if ($wantarray) {
119         @res    = $self->SUPER::_dbh_execute(@_);
120       } else {
121         $res[0] = $self->SUPER::_dbh_execute(@_);
122       }
123     };
124     $exception = $@;
125     if ($exception =~ /ORA-01003/) {
126       # ORA-01003: no statement parsed (someone changed the table somehow,
127       # invalidating your cursor.)
128       my ($sql, $bind) = $self->_prep_for_execute($op, $extra_bind, $ident, \@args);
129       delete $dbh->{CachedKids}{$sql};
130     } else {
131       last;
132     }
133   } while (not $retried++);
134
135   $self->throw_exception($exception) if $exception;
136
137   wantarray ? @res : $res[0]
138 }
139
140 =head2 get_autoinc_seq
141
142 Returns the sequence name for an autoincrement column
143
144 =cut
145
146 sub get_autoinc_seq {
147   my ($self, $source, $col) = @_;
148     
149   $self->dbh_do('_dbh_get_autoinc_seq', $source, $col);
150 }
151
152 =head2 columns_info_for
153
154 This wraps the superclass version of this method to force table
155 names to uppercase
156
157 =cut
158
159 sub columns_info_for {
160   my ($self, $table) = @_;
161
162   $self->next::method(uc($table));
163 }
164
165 =head2 datetime_parser_type
166
167 This sets the proper DateTime::Format module for use with
168 L<DBIx::Class::InflateColumn::DateTime>.
169
170 =cut
171
172 sub datetime_parser_type { return "DateTime::Format::Oracle"; }
173
174 sub _svp_begin {
175     my ($self, $name) = @_;
176  
177     $self->dbh->do("SAVEPOINT $name");
178 }
179
180 # Oracle automatically releases a savepoint when you start another one with the
181 # same name.
182 sub _svp_release { 1 }
183
184 sub _svp_rollback {
185     my ($self, $name) = @_;
186
187     $self->dbh->do("ROLLBACK TO SAVEPOINT $name")
188 }
189
190 =head1 AUTHORS
191
192 Andy Grundman <andy@hybridized.org>
193
194 Scott Connelly <scottsweep@yahoo.com>
195
196 =head1 LICENSE
197
198 You may distribute this code under the same terms as Perl itself.
199
200 =cut
201
202 1;