/ 
Mojo-Redis2-0.31
River stage zero No dependents
/ Mojo::Redis2::Transaction

NAME

Mojo::Redis2::Transaction - Transaction guard for Mojo::Redis2

DESCRIPTION

Mojo::Redis2::Transaction is an object for handling transactions started by "multi" in Mojo::Redis2.

All transactions objects will be kept isolated having its own connection to the database. One object can also be re-used: Calling a Redis method after "exec" or "discard" will result in sending the "MULTI" command to the Redis server again.

"discard" is automatically called when an instance of Mojo::Redis2::Transaction goes out of scope.

See also http://redis.io/topics/transactions.

SYNOPSIS

use Mojo::Redis2;
my $redis = Mojo::Redis2->new;

my $txn = $redis->multi;
$txn->set(foo => 42);
$txn->exec;

# the same object (and connection to database) can be re-used
$txn->incr('foo');
$txn->discard;

ATTRIBUTES

Mojo::Redis2::Transaction inherits all attributes from Mojo::Redis2.

METHODS

Mojo::Redis2::Transaction inherits all methods from Mojo::Redis2 and implements the following new ones.

discard

$self->discard;
$self->discard(sub { my ($self, $err, $res) = @_; });

Discard all commands issued. This method is called automatically on DESTROY, unless "exec" was called first.

exec

$self->exec;
$self->exec(sub { my ($self, $err, $res) = @_; });

Execute all commands issued.

watch

$self = $self->watch($key, $cb);
$res = $self->watch($key);

Marks the given keys to be watched for conditional execution of a transaction.

ILLEGAL METHODS

The following methods cannot be called on an instance of Mojo::Redis2::Transaction.

  • blpop

  • brpop

  • brpoplpush

  • multi

  • psubscribe

  • publish

  • subscribe

COPYRIGHT AND LICENSE

Copyright (C) 2014, Jan Henning Thorsen

This program is free software, you can redistribute it and/or modify it under the terms of the Artistic License version 2.0.

AUTHOR

Jan Henning Thorsen - jhthorsen@cpan.org