NAME

ASP4::FileUpload - Simple interface for handling File Uploads

SYNOPSIS

# In your handler:
sub run {
  my ($s, $context) = @_;
  
  if( my $file = $Request->FileUpload('fieldname') ) {
  
    # Save the file:
    $file->SaveAs('/var/media/uploads/budget.csv');
    
    # Some info about it:
    warn $file->UploadedFileName; # C:\Users\billg\budget.csv
    warn $file->FileName;         # budget.csv
    warn $file->FileExtension;    # csv
    warn $file->FileSize;         # 273478 (Calculated via (stat(FH))[7] )
    warn $file->ContentType;      # text/csv
    warn $file->FileContents;     # (The contents of the file)
    my $ifh = $file->FileHandle;  # A normal, plain old filehandle
  }
}

DESCRIPTION

This class provides a simple interface to uploaded files in ASP4.

PUBLIC PROPERTIES

UploadedFileName

The name of the file - as uploaded by the user. For example, if the user was on Windows, it might look like C:\Users\billg\Desktop\file.txt

Filename

The name of the file itself - eg: file.txt

FileExtension

If the filename is file.txt, FileExtension would return txt.

FileSize

The size of the uploaded file in bytes.

FileHandle

Returns a filehandle (open for reading) pointing to the uploaded file.

ContentType

The content-type header supplied by the browser for the uploaded file.

FileContents

The contents of the uploaded file.

PUBLIC METHODS

SaveAs( $path )

Writes the contents of the uploaded file to $path. Will throw an exception if something goes wrong.