The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Dancer::RPCPlugin::DispatchFromPod - Build dispatch-table from POD

SYNOPSIS

    use Dancer::Plugin;
    use Dancer::RPCPlugin::DispatchFromPod;
    sub dispatch_call {
        return dispatch_table_from_pod(%parameters);
    }

DESCRIPTION

Interface to build a (partial) dispatch table from the special pod-directives in the packages specified and for the optional endpoint specified.

POD Specifications

One can specify a sub/method to be used for the RPCPlugin by using the POD directive =for followed by the rpc-protocol supported by this plugin-set. One of jsonrpc, restrpc and xmlrpc.

    =for <protocol> <rpc-name> <real-code-name>[ <endpoint>]
<protocol> must be one of <jsonrpc|restrpc|xmlrpc>
<rpc-name> is the name used by the rpc-interface to execute this call, different protocols may use diffent 'rpc-name's to reflect the nature of the protocol.
<real-code-name> is the name of the sub/method
<endpoint> this optional argument is needed for files/packages that have code for different endpoints.

The pod-directive must be in the same file the code it refers to is.

Make sure the partial dispatch table for a single endpoint is build in a single pass.

EXPORTS

dispatch_table_from_pod(%arguments)

Parameters

Named:

plugin => <jsonrpc|restrpc|xmlrpc>
packages => [ $package_name, ... ]
endpoint => '/endpoint_for_dispatch_tabledispatch_table'

Responses

A (partial) dispatch-table.

COPYRIGHT

(c) MMXV - Abe Timmerman <abeltje@cpan.org>