Apache2::ASP::UploadHookArgs - Argument for UploadHook instances
my $Upload = Apache2::ASP::UploadHookArgs->new( upload => $upload, # An APR::Request::Param::Table object percent_complete => $percent_complete, elapsed_time => $elapsed_time, # in seconds total_expected_time => $total_expected_time, # in seconds time_remaining => $time_remaining, # in seconds length_received => $length_received, # in bytes data => defined($data) ? $data : undef, # bytes received in this "chunk" );
Rather than just passing a hashref as an argument, this class serves to enforce some structure to the whole Apache2::ASP upload model.
%args should be as shown in the synopsis above.
%args
Returns an APR::Request::Param::Table object.
Returns a float representing what percent of the upload has been received so far.
Returns the number of seconds since the upload began.
Returns the total number of seconds we expect the upload to last.
Returns the number of seconds the upload will continue after this point in time.
Returns the number of bytes we have received from the upload so far.
Returns the value of $ENV{CONTENT_LENGTH} at this point, but may be updated later, based on usage and requirements.
$ENV{CONTENT_LENGTH}
Returns the bytes received in this "chunk" of the upload.
After the upload has finished, you can count on the following methods returning actual values:
Returns the filename of the new file, as it was in the upload form field.
Example: C:\Documents\MyFile.txt
C:\Documents\MyFile.txt
Returns something like MyFile.txt
MyFile.txt
Returns something like /media/MyFile.txt
/media/MyFile.txt
It's possible that some bugs have found their way into this release.
Use RT http://rt.cpan.org/NoAuth/Bugs.html?Dist=Apache2-ASP to submit bug reports.
Please visit the Apache2::ASP homepage at http://www.devstack.com/ to see examples of Apache2::ASP in action.
John Drago mailto:jdrago_999@yahoo.com
Copyright 2007 John Drago, All rights reserved.
This software is free software. It may be used and distributed under the same terms as Perl itself.
To install Apache2::ASP, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Apache2::ASP
CPAN shell
perl -MCPAN -e shell install Apache2::ASP
For more information on module installation, please visit the detailed CPAN module installation guide.