Oliver Gorwits > RPC-Serialized-1.123630 > RPC::Serialized::Server::STDIO

Download:
RPC-Serialized-1.123630.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

Open  0
View/Report Bugs
Module Version: 1.123630   Source  

NAME ^

RPC::Serialized::Server::STDIO - Run a simple RPC server on STDIN and STDOUT

VERSION ^

version 1.123630

SYNOPSIS ^

 use RPC::Serialized::Server::STDIO;
 
 # set up the new server
 my $s = RPC::Serialized::Server::STDIO->new;
 
 # begin a single-process loop handling requests on STDIN and STDOUT
 $s->process;

DESCRIPTION ^

This module provides a very simple way to run an RPC server. It uses the STDIN and STDOUT filehandles to read and write RPC calls and responses.

One use for this module is for testing; you can run a simple server as shown in the "SYNOPSIS" above, and test handlers by just typing CALLs into STDIN.

The more common use is that this modules serves as a base class from which to derive a more useful interface. The various UCSPI server modules do this.

There is no additional server configuration necessary, although you can of course supply arguments to new() as described in the RPC::Serialized manual page.

To start the server, issue the following command:

 $s->process;

THANKS ^

This module is a derivative of YAML::RPC, written by pod and Ray Miller, at the University of Oxford Computing Services. Without their brilliant creation this system would not exist.

AUTHOR ^

Oliver Gorwits <oliver@cpan.org>

COPYRIGHT AND LICENSE ^

This software is copyright (c) 2012 by University of Oxford.

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

syntax highlighting: