NAME Net::MPRPC::Client - Synchronous MessagePack RPC client

SYNOPSIS use Net::MPRPC::Client;

    my $client = Net::MPRPC::Client->new(
        host => '127.0.0.1',
        port => 4423,
    );

    # or unix socket:
    my $client = Net::MPRPC::Client->new(
        host => 'unix/',
        port => '/tmp/mprpc.sock',
    );

    # call method "echo" with argument "foo bar"
    my $res = $client->call( echo => "foo bar" )
        or die $client->error;

DESCRIPTION This module is a simple synchronous MessagePack-RPC client, designed to use in synchronous application (e.g. prefork server) For asynchronous version of this module, take a look at AnyEvent::MPRPC::Client.

METHODS new(%parameters) my $client = Net::MPRPC::Client->new( host => '127.0.0.1', port => 4423, );

    # or unix socket:
    my $client = Net::MPRPC::Client->new(
        host => 'unix/',
        port => '/tmp/mprpc.sock',
    );

Create and return client object. Available parameters are:

*   host => 'Str' (Required)

    MessagePack-RPC server's hostname to connect. If you want to use
    unix domain socket, this parameter should be "unix/".

*   port => 'Int | Str' (Required)

    MessagePack-RPC server's port or UNIX socket path to connect.

*   timeout => 'Int'

    Timeout (second) to connect. Default value is 30 seconds.

call($method, $parameter) my $res = $client->call( echo => "foo bar" ) or die $client->error;

Call RPC method and return result.

If remote server return some errors, this method return undef. You can
get error message by "error" method. When something other error (network
error or etc) occurred, this method throw exception.

error() Return error messages. Return empty string when there's no error.

connect disconnect Connect to and disconnect from server. This method automatically called from "call" method.

AUTHOR Daisuke Murase [email protected]

COPYRIGHT AND LICENSE Copyright (c) 2011 by KAYAC Inc.

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

The full text of the license can be found in the LICENSE file included
with this module.