Apache2::Ajax 0.1

Apache2::Ajax is a mod_perl interface to CGI::Ajax.

SYNOPSIS

######################################################
# in httpd.conf
PerlLoadModule Apache2::MyAjaxApp
< Location /ajax >
SetHandler perl-script
PerlResponseHandler Apache2::MyAjaxApp
PJX_fn js_function_name perl_function_name
PJX_html Show_Form_sub
PJX_JSDEBUG 2
PJX_DEBUG 1
< /Location >
######################################################

######################################################
# module file Apache2/MyAjaxApp.pm
package Apache2::MyAjaxApp
use Apache2::Ajax;
# use whatever else

sub perl_function_name {
my @params = @_;
# do whatever
return $return_value;
}

sub Show_Form_sub {
my $html = ;
# construct html string
return $html;
}

sub handler {
my $r = shift;
# do stuff
my $ajax = Apache2::Ajax->new($r);
$r->print($ajax->build_html());
return Apache2::Const::OK;
}
1;
##################################################

This module is a mod_perl2 interface to CGI::Ajax, which provides a mechanism for using perl code asynchronously from javascript-enhanced HTML pages.

As well as mod_perl2, this package requires CGI::Ajax, as well as a CGI.pm-compatible CGI module for supplying the param() and header() methods. If available, CGI::Apache2::Wrapper will be used, which is a minimal module that uses methods of mod_perl2 and Apache2::Request to provide these methods; if this is not available, CGI (version 2.93 or greater) will be used.

Setting things up can be illustrated by the following example of CGI::Ajax, which contains a more thorough discussion, as well as a number of illustrative example scripts.