NAME

Apache2::ASP::Request - Incoming request processor

SYNOPSIS

  <%
    # Cookies:
    my $cookie = $Request->Cookies( "mycookie" );
    my $cookie2 = $Request->Cookies( "cookie2", "fieldname" );
    
    # Form/QueryString values:
    my $Form = $Request->Form; # returns a hashref of all form/querystring data:
    my $name = $Form->{user_name};
    my $name = $Request->Form( 'user_name' );
    
    # File uploads (a):
    my $ifh = $Request->FileUpload( "fieldname" );
    while( my $line = <$ifh> )
    {
      # Process $line from file:
    }# end while()
    
    # File uploads (b):
    my %info = $Request->FileUpload( "fieldname" );
    # %info has the following structure:
    %info = (
      'ContentType'         => 'image/gif',
      'FileHandle'          => <an IO::Handle object>,
      'BrowserFile'         => 'C:\Documents and Settings\franky\Desktop\myfile.gif'
    );
    
    # QueryString itself:
    my $qstring = $Request->QueryString();
    
    # ServerVariables:
    my $host = $Request->ServerVariables( 'HTTP_HOST' );
  %>

DESCRIPTION

The global $Request object is an instance of Apache2::ASP::Request.

PUBLIC METHODS

new( $asp )

Cookies( $name [, $key] )

Given the $name only, returns the whole value of the cookie.

Given the $name and $key, returns only that part of a multi-value cookie.

Form( [$key] )

Called without a $key, returns a hashref of all Form and QueryString data.

Called with a $key, returns only the value for that field.

FileUpload( $field [, $arg ] )

Called in scalar context, returns a filehandle to the uploaded file.

Called in list context, returns a hash containing the following fields:

ContentType
A value like image/gif or text/html. The MIME-Type of the uploaded file.
FileHandle
The stream/filehandle from which the contents of the uploaded file may be read.
BrowserFile
The name of the file as it was on the client's side. For example, C:\Program Files\file.txt.

QueryString( )

Returns the contents of $ENV{HTTP_QUERYSTRING} or an empty string if it is not available.

ServerVariables( [$key] )

Called without a $key, returns a sorted list of all keys in %ENV.

Called with a $key, returns the value associated with that element in %ENV.

BUGS

It's possible that some bugs have found their way into this release.

Use RT http://rt.cpan.org/NoAuth/Bugs.html to submit bug reports.

HOMEPAGE

Please visit the Apache2::ASP homepage at http://www.devstack.com/ to see examples of Apache2::ASP in action.

AUTHOR

John Drago mailto:jdrago_999@yahoo.com

COPYRIGHT AND LICENSE

This software is free software. It may be used and distributed under the same terms as Perl itself.

Apache2::ASP::Request - Incoming request processor