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