NAME

RPC::JSON - JSON-RPC Client Library

SYNOPSIS

    use RPC::JSON;

    my $jsonrpc = RPC::JSON->new(
        "http://www.simplymapped.com/services/geocode/json.smd" );

    # Imports a geocode(['address']) method:
    $jsonrpc->geocode('1600 Pennsylvania Ave');

Dumping this function returns whatever data was returned from the server. In this case:

    $VAR1 = [
        {
            'administrativearea' => 'DC',
            'country' => 'US',
            'longitude' => '-77.037691',
            'subadministrativearea' => 'District of Columbia',
            'locality' => 'Washington',
            'latitude' => '38.898758',
            'thoroughfare' => '1600 Pennsylvania Ave NW',
            'postalcode' => '20004',
            'address' => '1600 Pennsylvania Ave NW, Washington, DC 20004, USA'
         }
    ];

DESCRIPTION

RPC::JSON aims to be a full-featured JSON-RPC client library that enables a client to connect to any JSON-RPC service and dispatch remote method calls.

METHODS

shell

Instantiate a JSON-RPC shell

new(<smd source>)

Return a new RPC::JSON object for a given SMD source

set_smd

Sets the current SMD file, via URI

connect ?SMD?

Connects to the specified SMD file, or whichever was configured with. This will initialize the JSON-RPC service.

load_smd

load_smd will process a given SMD file by converting from JSON to a Perl native structure, and setup the various keys as well as the autoload handles for calling the methods.

is_utf8

makes the call to from_json utf8 aware (see perldoc JSON)

    $jsonrpc->is_utf8( 1 );

default state is non utf8

service

Return the object name of the current service connected to, or undef if not connected.

methods

Return a structure of method names for use on the current service, or undef if not connected.

The structure looks like: { methodName1 => [ { name => NAME, type => DATATYPE }, ... ] }

serviceURI

Returns the serviceURI (not the SMD URI, the URI to request RPC calls against), or undef if not connected.

AUTHORS

J. Shirley <jshirley@gmail.com>

CONTRIBUTORS

Chris Carline Lee Johnson

LICENSE

Copyright 2006-2008 J. Shirley <jshirley@gmail.com>

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. That means either (a) the GNU General Public License or (b) the Artistic License.