AnyEvent::JSONRPC::Lite::Server - Simple TCP-based JSONRPC server
use AnyEvent::JSONRPC::Lite::Server; my $server = AnyEvent::JSONRPC::Lite::Server->new( port => 4423 ); $server->reg_cb( echo => sub { my ($res_cv, @params) = @_; $res_cv->result(@params); }, sum => sub { my ($res_cv, @params) = @_; $res_cv->result( $params[0] + $params[1] ); }, );
This module is server part of AnyEvent::JSONRPC::Lite.
Create server object, start listening socket, and return object.
my $server = AnyEvent::JSONRPC::Lite::Server->new( port => 4423, );
Available %options are:
%options
Listening port or path to unix socket (Required)
Bind address. Default to undef: This means server binds all interfaces by default.
If you want to use unix socket, this option should be set to "unix/"
Error callback which is called when some errors occurred. This is actually AnyEvent::Handle's on_error.
EOF callback. same as AnyEvent::Handle's on_eof callback.
Hashref options of AnyEvent::Handle that is used to handle client connections.
Register JSONRPC methods.
$server->reg_cb( echo => sub { my ($res_cv, @params) = @_; $res_cv->result(@params); }, sum => sub { my ($res_cv, @params) = @_; $res_cv->result( $params[0] + $params[1] ); }, );
JSONRPC callback arguments consists of $result_cv, and request @params.
$result_cv
@params
my ($result_cv, @params) = @_;
$result_cv is AnyEvent::JSONRPC::Lite::CondVar object. Callback must be call $result_cv->result to return result or $result_cv->error to return error.
$result_cv->result
$result_cv->error
If $result_cv is not defined, it is notify request, so you don't have to return response. See AnyEvent::JSONRPC::Lite::Client notify method.
@params is same as request parameter.
Daisuke Murase <typester@cpan.org>
Copyright (c) 2009 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.
To install AnyEvent::JSONRPC::Lite, copy and paste the appropriate command in to your terminal.
cpanm
cpanm AnyEvent::JSONRPC::Lite
CPAN shell
perl -MCPAN -e shell install AnyEvent::JSONRPC::Lite
For more information on module installation, please visit the detailed CPAN module installation guide.