---
name: "JSON::RPC::Common::Procedure::Call"
section: "3pm"
platform: "linux"
package: "libjson-rpc-common-perl"
version: "0.11-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/JSON::RPC::Common::Procedure::Call"
---

# JSON::RPC::Common::Procedure::Call(3pm)

JSON RPC Procedure Call base class.

## 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.