NAME

JSONRPC::Transport::TCP - Client component for TCP JSONRPC

SYNOPSIS

    use JSONRPC::Transport::TCP;
    
    my $rpc = JSONRPC::Transport::TCP->new( host => '127.0.0.1', port => 3000 );
    my $res = $rpc->call('echo', 'arg1', 'arg2' )
        or die $rpc->error;
    
    print $res->result;

DESCRIPTION

This module is a simple client side implementation about JSONRPC via TCP.

This module doen't support continual tcp streams, and so it open/close connection on each request.

METHODS

new

Create new client object.

Parameters:

host: Hostname or ip address to connect
port: Port number to connect

connect

Connect remote host.

This module automatically connect on following "call" method, so you have not to call this method.

disconnect

Disconnect the connection

call($method_name, @params)

Call remote method.

When remote method is success, it returns self object that contains result as ->result accessor.

If some error are occured, it returns undef, and you can check the error by ->error accessor.

Parameters:

$method_name: Remote method name to call
@params: Remote method parameters.

DESTROY

Automatically disconnect when object destroy.

ACCESSORS

result

Contains result of remote method

error

Conteins error of remote method

AUTHOR

Daisuke Murase <typester@cpan.org>

COPYRIGHT

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.

CPAN RT