lib/DBIx/Class/Storage/DBI/ODBC/Firebird.pm

   1 package DBIx::Class::Storage::DBI::ODBC::Firebird;
   2
   3 use strict;
   4 use warnings;
   5 use base 'DBIx::Class::Storage::DBI::Firebird::Common';
   6 use mro 'c3';
   7 use Try::Tiny;
   8 use namespace::clean;
   9
  10 =head1 NAME
  11
  12 DBIx::Class::Storage::DBI::ODBC::Firebird - Driver for using the Firebird RDBMS
  13 through ODBC
  14
  15 =head1 DESCRIPTION
  16
  17 Most functionality is provided by
  18 L<DBIx::Class::Storage::DBI::Firebird::Common>, see that driver for details.
  19
  20 To build the ODBC driver for Firebird on Linux for unixODBC, see:
  21
  22 L<http://www.firebirdnews.org/?p=1324>
  23
  24 This driver does not suffer from the nested statement handles across commits
  25 issue that the L<DBD::InterBase|DBIx::Class::Storage::DBI::InterBase> or the
  26 L<DBD::Firebird|DBIx::Class::Storage::DBI::Firebird> based driver does. This
  27 makes it more suitable for long running processes such as under L<Catalyst>.
  28
  29 =cut
  30
  31 __PACKAGE__->datetime_parser_type ('DBIx::Class::Storage::DBI::ODBC::Firebird::DateTime::Format');
  32
  33 # releasing savepoints doesn't work for some reason, but that shouldn't matter
  34 sub _exec_svp_release { 1 }
  35
  36 sub _exec_svp_rollback {
  37   my ($self, $name) = @_;
  38
  39   try {
  40     $self->_dbh->do("ROLLBACK TO SAVEPOINT $name")
  41   }
  42   catch {
  43     # Firebird ODBC driver bug, ignore
  44     if (not /Unable to fetch information about the error/) {
  45       $self->throw_exception($_);
  46     }
  47   };
  48 }
  49
  50 package # hide from PAUSE
  51   DBIx::Class::Storage::DBI::ODBC::Firebird::DateTime::Format;
  52
  53 # inherit parse/format date
  54 our @ISA = 'DBIx::Class::Storage::DBI::InterBase::DateTime::Format';
  55
  56 my $timestamp_format = '%Y-%m-%d %H:%M:%S.%4N'; # %F %T
  57 my $timestamp_parser;
  58
  59 sub parse_datetime {
  60   shift;
  61   require DateTime::Format::Strptime;
  62   $timestamp_parser ||= DateTime::Format::Strptime->new(
  63     pattern  => $timestamp_format,
  64     on_error => 'croak',
  65   );
  66   return $timestamp_parser->parse_datetime(shift);
  67 }
  68
  69 sub format_datetime {
  70   shift;
  71   require DateTime::Format::Strptime;
  72   $timestamp_parser ||= DateTime::Format::Strptime->new(
  73     pattern  => $timestamp_format,
  74     on_error => 'croak',
  75   );
  76   return $timestamp_parser->format_datetime(shift);
  77 }
  78
  79 1;
  80
  81 =head1 AUTHOR
  82
  83 See L<DBIx::Class/AUTHOR> and L<DBIx::Class/CONTRIBUTORS>.
  84
  85 =head1 LICENSE
  86
  87 You may distribute this code under the same terms as Perl itself.
  88
  89 =cut
  90 # vim:sts=2 sw=2: