Tatsuhiko Miyagawa > AnyEvent-Redis-0.22 > AnyEvent::Redis

Download:
AnyEvent-Redis-0.22.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.22   Source   Latest Release: AnyEvent-Redis-0.24

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.

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

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

syntax highlighting: