NAME

Net::RMI::Server - Perl server-side extension for Remote Method Invocation (RMI).

SYNOPSIS

use Net::RMI::Server;

$s = new Net::RMI::Server ||
	die "Error: could not create object.\n";

sub add2Numbers ($$) {
	my ($n1, $n2) = @_;
	return $n1 + $n2;
}

$function = "add2Numbers";
$s->registerFunction($function, \&$function, ['$', '$'], '$');

$s->listen();

DESCRIPTION

The server portion of Net::RMI, contains the methods for registering and serving remotely invoked methods.

Functions may only receive scalars or references. Complex data types (i.e., arrays and hashes), must be passed by reference. Scalars, may also be optionally passed by reference.

Functions may only return scalars or references. Complex data types (i.e., arrays and hashes), must be return as a reference. Scalars, may also be optionally returned as a reference.

METHODS

new

Creates a new method-server.

Parameters: none.
Returns: a new instance of this class.

listen

Listens forever for remote method requests.

Parameters: none.
Returns: never returns.

getFunction

Returns a pointer to the function referenced by the function name.

Parameters: the function's name.
Returns: a reference to the function code.

getFunctionInfo

Returns the "meta-information" about the function reference by the function name.

Parameters: the function's name.
Returns: the function's parameter list and return-type.

registerFunction

Register's a local method with this remote-method server.

Parameters: the function's name, code, parameter list and
	return-list.
Returns: nothing.

listFunctions

Parameters: none.
Returns: a list of functions registered to this method-server instance.

REAPER

Reaps the zombie children, stolen with thanks from the Perl Cookbook.

Parameters: none.
Returns: nothing.

SEE ALSO

Net::RMI, and Net::RMI::Client.

AUTHOR

Stephen Pandich, pandich@yahoo.com