NAME

       DR::Tarantool::MsgPack::AsyncClient - async client for tarantool.

SYNOPSIS

           use DR::Tarantool::MsgPack::AsyncClient;

           DR::Tarantool::MsgPack::AsyncClient->connect(
               host => '127.0.0.1',
               port => 12345,
               spaces => $spaces,
               sub {
                   my ($client) = @_;
               }
           );

           $client->insert('space_name', [1,2,3], sub { ... });

Class methods

   connect
       Connect to <Tarantool:http://tarantool.org>, returns (by callback) an object which can be used to make
       requests.

       Arguments

       host & port & user & password
           Address and auth information of remote tarantool.

       space
           A hash with space description or a DR::Tarantool::Spaces reference.

       reconnect_period
           An  interval  to  wait before trying to reconnect after a fatal error or unsuccessful connect. If the
           field is defined and is greater than 0, the driver tries  to  reconnect  to  the  server  after  this
           interval.

           Important:  the  driver does not reconnect after the first unsuccessful connection. It calls callback
           instead.

       reconnect_always
           Try to reconnect even after the first unsuccessful connection.

Worker methods

       All methods accept callbacks which are invoked with the following arguments:

       status
           On success, this field has value 'ok'. The value of this parameter determines  the  contents  of  the
           rest of the callback arguments.

       a tuple or tuples or an error code
           On  success, the second argument contains tuple(s) produced by the request. On error, it contains the
           server error code.

       errorstr
           Error string in case of an error.

               sub {
                   if ($_[0] eq 'ok') {
                       my ($status, $tuples) = @_;
                       ...
                   } else {
                       my ($status, $code, $errstr) = @_;
                       ...
                   }
               }

   ping
       Ping the server.

           $client->ping(sub { ... });

   insert, replace
       Insert/replace a tuple into a space.

           $client->insert('space', [ 1, 'Vasya', 20 ], sub { ... });
           $client->replace('space', [ 2, 'Petya', 22 ], sub { ... });

   call_lua
       Call Lua function.

           $client->call_lua(foo => ['arg1', 'arg2'], sub {  });

   select
       Select a tuple (or tuples) from a space by index.

           $client->select('space_name', 'index_name', [ 'key' ], %opts, sub { .. });

       Options can be:

       limit
       offset
       iterator
           An iterator for index. Can be:

           ALL Returns all tuples in space.

           EQ, GE, LE, GT, LT

   delete
       Delete a tuple.

           $client->delete('space_name', [ 'key' ], sub { ... });

   update
       Update a tuple.

           $client->update('space', [ 'key' ], \@ops, sub { ... });

       @ops is array of operations to update.  Each operation is array of elements:

       code
           Code of operation: "=", "+", "-", "&", "|", etc

       field
           Field number or name.

       arguments

perl v5.22.1                                       2014-06-16              DR::Tarantool:...ck::AsyncClient(3pm)