/usr/share/perl5/KiokuDB/Backend/Role/TXN.pm is in libkiokudb-perl 0.56-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 | package KiokuDB::Backend::Role::TXN;
BEGIN {
$KiokuDB::Backend::Role::TXN::AUTHORITY = 'cpan:NUFFIN';
}
{
$KiokuDB::Backend::Role::TXN::VERSION = '0.56';
}
use Moose::Role;
# ABSTRACT: Backend level transaction support.
use Carp qw(croak);
use Try::Tiny;
use namespace::clean -except => 'meta';
requires qw(txn_begin txn_commit txn_rollback);
sub txn_do {
my ( $self, $coderef, %args ) = @_;
my @args = @{ $args{args} || [] };
my ( $commit, $rollback ) = @args{qw(commit rollback)};
ref $coderef eq 'CODE' or croak '$coderef must be a CODE reference';
my @txn_args = $self->txn_begin;
try {
my @ret;
if ( wantarray ) {
@ret = $coderef->(@args);
} elsif ( defined wantarray ) {
$ret[0] = $coderef->(@args);
} else {
$coderef->(@args);
}
$commit->() if $commit;
$self->txn_commit(@txn_args);
return wantarray ? @ret : $ret[0];
} catch {
my $err = $_;
try {
$self->txn_rollback(@txn_args);
$rollback->() if $rollback;
} catch {
croak "Transaction aborted: $err, rollback failed: $_";
};
die $err;
}
}
__PACKAGE__
__END__
=pod
=head1 NAME
KiokuDB::Backend::Role::TXN - Backend level transaction support.
=head1 VERSION
version 0.56
=head1 SYNOPSIS
package MyBackend;
use Moose;
with qw(
KiokuDB::Backend
KiokuDB::Backend::Role::TXN
);
sub txn_begin { ... }
sub txn_commit { ... }
sub txn_rollback { ... }
=head1 DESCRIPTION
This API is inspired by standard database transactions much like you get with
L<DBI>.
This is the low level interface required by L<KiokuDB/txn_do>.
=head1 OPTIONAL METHODS
=over 4
=item txn_do $code, %callbacks
This method should evaluate the code reference in the context of a transaction,
inside an C<eval>. If any errors are caught the transaction should be aborted,
otherwise it should be committed. This is much like
L<DBIx::Class::Schema/txn_do>.
The C<rollback> callback should be fired when the transaction will be aborted.
=back
=head1 REQUIRED METHODS
=over 4
=item txn_begin [ $parent_txn ]
Begin a new transaction.
This method can return a transaction handle that will later be passed to
C<txn_commit> or C<txn_rollback> as necessary.
The current handle will be passed to nested calls to C<txn_begin>.
=item txn_commit $txn
Commit the transaction.
=item txn_rollback $txn
Rollback the transaction.
=back
=head1 AUTHOR
Yuval Kogman <nothingmuch@woobling.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by Yuval Kogman, Infinity Interactive.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
|