view release on metacpan or  search on metacpan

lib/CGI/ExtDirect.pod  view on Meta::CPAN

and works fine.

=back

=item C<api>

Instance method. Returns the current API tree as a stringified
L<API declaration|RPC::ExtDirect::Intro/"API declaration"> along with
the HTTP status code and headers, to be printed or processed further.

Accepts custom headers as described in L</"HTTP response headers">.

=item C<route>

Instance method. Parses Ext.Direct requests from the internal C<CGI> object
passed to L<constructor|/new>; dispatches the quests, collects results and
returns an HTTP response with results as a serialized JSON stream.

Accepts custom headers as described in L</"HTTP response headers">.

=item C<poll>

Instance method. Queries Event provider
L<Poll Handler Methods|RPC::ExtDirect::Intro/"Poll Handler Method">
for events, collects these events and returns back a JSON stream.

Accepts custom headers as described in L</"HTTP response headers">.

=back

=begin readme

=head1 INSTALLATION

To install this module type the following:

    perl Makefile.PL
    make && make test
    make install

=end readme

=for readme continue

=head1 EXAMPLES

See included Ext JS examples for ideas on what Ext.Direct is and how to
use it in CGI applications. The examples are not installed along with
the CGI::ExtDirect module, and are only available in the C<examples/>
directory of the CPAN distribution. 

To run examples type the following in the CGI::ExtDirect tarball
directory:

    cd examples
    perl p5httpd

Note that these examples do not require CGI::ExtDirect to be installed
so you can try them beforehand. That said, CGI::ExtDirect depends on
RPC::ExtDirect being available in C<@INC> so if you don't want to
install either module, unpack RPC::ExtDirect and CGI::ExtDirect
tarballs to the same directory and use C<$PERL5LIB> to point to
RPC::ExtDirect location:
    
    cd examples
    PERL5LIB=../../RPC-ExtDirect-3.xx/lib perl p5httpd

=for readme stop

=head1 ACKNOWLEDGEMENTS

I would like to thank IntelliSurvey, Inc for sponsoring my work
on versions 2.x and 3.x of the RPC::ExtDirect suite of modules.

The tiny but CGI capable HTTP server used to provide working examples
is (c) 2002-2004 by Hans Lub, <hlub@knoware.nl>. It is called p5httpd
and can be found here: L<http://utopia.knoware.nl/~hlub/rlwrap/>

=head1 BUGS AND LIMITATIONS

At this time there are no known bugs in this module. Please report problems
to the author, patches are always welcome.

Use L<Github tracker|https://github.com/nohuhu/CGI-ExtDirect/issues> to open
bug reports, this is the easiest and quickest way to get your issue fixed.

=for readme continue

=head1 COPYRIGHT AND LICENSE

Copyright (c) 2011-2016 Alex Tokarev E<lt>tokarev@cpan.orgE<gt>.

This module is free software; you can redistribute it and/or modify it under
the same terms as Perl itself. See L<perlartistic>.

Included Ext JS examples are copyright (c) 2011, Sencha Inc. Example code
is used and distributed under GPL 3.0 license as provided by Sencha Inc.
See L<http://www.sencha.com/license>. Ext JS is available for download at
L<http://www.sencha.com/products/extjs/>

=cut