NAME

       JSON::RPC::Common::Procedure::Call - JSON RPC Procedure Call base class.

VERSION

       version 0.11

SYNOPSIS

               use JSON::RPC::Common::Procedure::Call;

               my $req = JSON::RPC::Common::Procedure::Call->inflate({ ... });

               warn "HALLO JSONRPC VERSION " . $req->version;

DESCRIPTION

       A JSON-RPC Procedure Call (ed: *rolls eys*, what was wrong with "request"?) is either a
       notification or a method invocation in JSON-PRC.

       See <http://json-rpc.org/wiki/specification> for more details.

ATTRIBUTES

       All attributes are read only unless otherwise specified.

       version
       id  The request ID.

           Used to correlate a request to a response.

       method
           The name of the method to invoke.

       params
           Returns a reference to the parameters hash or array.

       return_class
       error_class
           The classes to instantiate the response objects.

           These vary per subclass.

METHODS

       inflate
           A factory constructor. Delegates to "new" on a subclass based on the protocol version.

           This is the recommended constructor.

       deflate
           Flatten to JSON data

       new The actual constructor.

           Not intended for normal use on this class, you should use a subclass most of the time.

           Calling "JSON::RPC::Common::Procedure::Call->new" will construct a call with an
           undefined version, which cannot be deflated (and thus sent over the wire). This is
           still useful for testing your own code's RPC hanlding, so this is not allowed.

       params_list
           Dereferences "params" regardless of representation.

           Returns a list of positionals or a key/value list.

       return_result $result
       return_error %error_params
           Create a new JSON::RPC::Common::Procedure::Return with or without an error.

       is_notification
           Whether this request is a notification (a method that does not need a response).

       is_service
           Whether this request is a JSON-RPC 1.1 service method (e.g.  "system.describe").

           This method is always false for 1.0 and 2.0.

       call $obj
           A convenience method to invoke the call on $obj and create a new return with the
           return value.

AUTHOR

       Yuval Kogman <nothingmuch@woobling.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2014 by Yuval Kogman and others.

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