Franck Cuny > Net-Riak-0.11 > Net::Riak

Download:
Net-Riak-0.11.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Module Version: 0.11   Source   Latest Release: Net-Riak-0.1702

NAME ^

Net::Riak - Interface to Riak

VERSION ^

version 0.11

SYNOPSIS ^

    my $client = Net::Riak->new(host => 'http://10.0.0.40:8098');
    my $bucket = $client->bucket('blog');
    my $obj    = $bucket->new_object('new_post', {title => 'foo', content => 'bar'});
    $obj->store;

    $obj = $bucket->get('new_post');
    say "title for ".$obj->key." is ".$obj->data->{title};

    my $req = $client->http_request; # last request
    $client->http_response # last response

DESCRIPTION ^

ATTRIBUTES

host

URL of the node (default 'http://127.0.0.1:8098'). If your ring is composed with more than one node, you can configure the client to hit more than one host, instead of hitting always the same node. For this, you can do one of the following:

all nodes equals
    my $riak = Net::Riak->new(
        host => [
            'http://10.0.0.40:8098',
            'http://10.0.0.41:8098'
        ]
    );
give weight to nodes
    my $riak = Net::Riak->new(
        host => [
            {node => 'http://10.0.0.40:8098', weight => '0.2'},
            {node => 'http://10.0.0.41:8098', weight => '0.8'}
        ]
    );

Now, when a request is made, a node is picked at random, according to weight.

prefix

Interface prefix (default 'riak')

mapred_prefix

MapReduce prefix (default 'mapred')

r

R value setting for this client (default 2)

w

W value setting for this client (default 2)

dw

DW value setting for this client (default 2)

client_id

client_id for this client

METHODS ^

http_request

Returns the HTTP::Request object from the last request

http_response

Returns a HTTP::Response object from the last request

METHODS ^

bucket

    my $bucket = $client->bucket($name);

Get the bucket by the specified name. Since buckets always exist, this will always return a Net::Riak::Bucket

is_alive

    if (!$client->is_alive) {
        ...
    }

Check if the Riak server for this client is alive

add

    my $map_reduce = $client->add('bucket_name', 'key');

Start assembling a Map/Reduce operation

link

    my $map_reduce = $client->link();

Start assembling a Map/Reduce operation

map

    my $map_reduce = $client->add('bucket_name', 'key')->map("function ...");

Start assembling a Map/Reduce operation

reduce

    my $map_reduce = $client->add(..)->map(..)->reduce("function ...");

Start assembling a Map/Reduce operation

SEE ALSO

Net::Riak::MapReduce

AUTHOR ^

franck cuny <franck@lumberjaph.net>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2010 by linkfluence.

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

syntax highlighting: