AEAE 0.02

AEAE project is the Ajax Enhanced Asynchroneous Experience.

USAGE:

To use AEAE, you only got two things to write:

The actual server task to do.

For this just make a class that inherits from AEAE::Command, and simply implement the _doIt() method.

See the AEAE::ComandExample :

(extract):
sub _doItReal{
my $self = shift ;
my $mustDie = shift ;
my $i = 0 ;

print "Let us start !n";
local $| = 1 ;
while( $i < 101){

$AEAE::Command::processCommand->oneStep($i);
print STDERR "We are here:".$i."n";
print STDOUT "Step ".$i."n";
$i += 5 ;
sleep(1);
if( ( $i > 70 ) && $mustDie){ confess( "An horrible error" );}
}
print "Now its over!n";
}

See AEAE::Command for full doc and AEAE::CommandExample for full example!

The importants things are:

- All you need to do is to implement your task just as if would be a regular one. Dont worry about synchroneous issues.
- All you write on STDOUT and STDERR will be visible to the final user, so dont be too wordy.
- If you die or confess, the error message will be visible to the user, so be clear!
- You got to use the $AEAE::Command::processCommand->oneStep( ); to gives information to the user on how much your task is complete. If number >= 100, your task will be considered as complete (thus eliminated) by the system, so give number between 1 and 99 !

The CGI that generates the interface.

Once your command is written, you got to write the cgi that will generate your web interface. For that, you will use the AEAE::AsyncCGIPage module.

Just a simple example:

#! /usr/bin/perl -w

use AEAE::AsyncCGIPage ;

use strict ;

use CGI ;

my $c = new CGI ;

my $page = AEAE::AsyncCGIPage->new($c,1);
$page->command(AEAE::CommandExample);
$page->arguments([0]);
$page->debug(1);
print $page->generateAjaxedHTML();

This CGI generates an ajaxed page that will control the AEAE::CommandExample and will give it the argument 0 .

The debug(1) makes ajax call appears in the page.

See AEAE::AsyncCGIPage for full documentation about all features.