NAME

RMI::Server - service RMI::Client requests from another process

SYNOPSIS

    $s = RMI::Server->new(
        reader => $fh1,
        writer => $fh2,
    );
    $s->run;

    $s = RMI::Server::Tcp->new(
        port => 1234
    );
    $s->run;

    $s = RMI::Server->new(...);
    for (1..3) {
        $s->receive_request_and_send_response;
    }
    

DESCRIPTION

This is the base class for RMI::Servers, which accept requests via an IO handle of some sort, execute code on behalf of the request, and send the return value back to the client.

When the RMI::Server responds to a request which returns objects or references, the items in question are not serialized back to the client. Instead the client recieves an identifier, and creates a proxy object which uses the client to delegate method calls to its counterpart on the server.

When objects or references are sent to an RMI server as parameters, the server creates a proxy to represent them, and the client in effect becomes the server for those proxy objects. The real reference stays on the client, and all interaction with the item in question during the invocation result in counter-requests being sent back to the client for method resolution on that end.

See the detailed explanation of remote proxy references in the RMI general documentation.

METHODS

new()

 $s = RMI::Server->new(reader => $fh1, writer => $fh2)

This is typically overriden in a specific subclass of RMI::Server to construct the reader and writer according to a particular strategy. It is possible for the reader and the writer to be the same handle, particularly for RMI::Server::Tcp.

receive_request_and_send_response()

 $bool = $

Implemented in the base class for all RMI::Node objects, this handles processing a single request from the reader handle.

run()

 $s->run();
 

Enter a loop processing RMI requests. This will continue as long as the connection is open.

BUGS AND CAVEATS

See general bugs in RMI for general system limitations

SEE ALSO

RMI RMI::Node RMI::Client RMI::Server::Tcp RMI::Server::ForkedPipes

AUTHORS

Scott Smith <sakoht@cpan.org>

COPYRIGHT

Copyright (c) 2008 - 2009 Scott Smith <sakoht@cpan.org> All rights reserved.

LICENSE

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.