Daisuke Murase > Net-MPRPC-Client-0.02 > Net::MPRPC::Client

Download:
Net-MPRPC-Client-0.02.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.02   Source  

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:

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 <typester@cpan.org>

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.

syntax highlighting: