++ed by:
MELO DMOL

2 PAUSE users
1 non-PAUSE user.

Tatsuhiko Miyagawa
and 1 contributors

NAME

AnyEvent::Redis - Non-blocking Redis client

SYNOPSIS

  use AnyEvent::Redis;

  my $redis = AnyEvent::Redis->new(
      host => '127.0.0.1',
      port => 6379,
      on_error => sub { warn @_ },
  );

  # callback based
  $redis->set( 'foo'=> 'bar', sub { warn "SET!" } );
  $redis->get( 'foo', sub { my $value = shift } );

  my ($key, $value) = ('list_key', 123);
  $redis->lpush( $key, $value );
  $redis->lpop( $key, sub { my $value = shift });

  # condvar based
  my $cv = $redis->lpop( $key );
  $cv->cb(sub { my $value = $_[0]->recv });

DESCRIPTION

AnyEvent::Redis is a non-blocking Redis client using AnyEvent.

METHODS

All methods supported by your version of Redis should be supported.

Normal commands

There are two alternative approaches for handling results from commands.

  • AnyEvent::CondVar based:

      my $cv = $redis->command(
        # arguments to command
      );
    
      $cv->cb(sub {
        my($cv) = @_;
        my($result, $err) = $cv->recv
      });
  • Callback:

      $redis->command(
        # arguments,
        sub {
          my($result, $err) = @_;
        });

    (Callback is a wrapper around the $cv approach.)

Subscriptions

The subscription methods (subscribe and psubscribe) must be used with a callback:

  my $cv = $redis->subscribe("test", sub {
    my($message, $channel[, $actual_channel]) = @_;
    # ($actual_channel is provided for pattern subscriptions.)
  });

The $cv condition will be met on unsubscribing from the channel.

Due to limitations of the Redis protocol the only valid commands on a connection with an active subscription are subscribe and unsubscribe commands.

Common methods

  • get

  • set

  • hset

  • hget

  • lpush

  • lpop

The Redis command reference (http://code.google.com/p/redis/wiki/CommandReference) lists all commands Redis supports.

REQUIREMENTS

This requires Redis >= 1.2.

COPYRIGHT

Tatsuhiko Miyagawa <miyagawa@bulknews.net> 2009-

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHORS

Tatsuhiko Miyagawa

David Leadbeater

Chia-liang Kao

franck cuny

Lee Aylward

Joshua Barratt

Jeremy Zawodny

Leon Brocard

SEE ALSO

Redis, AnyEvent