X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FRequest%2FUpload.pm;h=9a5f1c4e6b3969e61f9c4a0c60c33e9d050c87df;hb=649fd1fa74ee22fb2f5220dbdcb25d02427034b2;hp=5df78eee6e6bd30fcdba8f909885fa27bd15e22e;hpb=c462faf09f20b2fca60bb9c63bf30b158760aa2c;p=catagits%2FCatalyst-Runtime.git

diff --git a/lib/Catalyst/Request/Upload.pm b/lib/Catalyst/Request/Upload.pm
index 5df78ee..9a5f1c4 100644
--- a/lib/Catalyst/Request/Upload.pm
+++ b/lib/Catalyst/Request/Upload.pm
@@ -3,24 +3,27 @@ package Catalyst::Request::Upload;
 use strict;
 use base 'Class::Accessor::Fast';
 
+use Catalyst::Exception;
 use File::Copy ();
 use IO::File   ();
 
-__PACKAGE__->mk_accessors(qw/filename size tempname type/);
+__PACKAGE__->mk_accessors(qw/filename headers size tempname type/);
 
 sub new { shift->SUPER::new( ref( $_[0] ) ? $_[0] : {@_} ) }
 
 =head1 NAME
 
-Catalyst::Request::Upload - Catalyst Request Upload Class
+Catalyst::Request::Upload - handles file upload requests
 
 =head1 SYNOPSIS
 
-    $upload->copy_to
-    $upload->fh
+    $upload->copy_to;
+    $upload->fh;
     $upload->filename;
+    $upload->headers;
     $upload->link_to;
     $upload->size;
+    $upload->slurp;
     $upload->tempname;
     $upload->type;
 
@@ -28,16 +31,18 @@ See also L<Catalyst>.
 
 =head1 DESCRIPTION
 
-This is the Catalyst Request Upload class, which provides a set of accessors 
-to the upload data.
+This class provides accessors and methods to handle client upload requests.
 
 =head1 METHODS
 
-=over 4
+=head2 $upload->new
 
-=item $upload->copy_to
+Simple constructor.
 
-Copies tempname using C<File::Copy>. Returns true for success, false otherwise.
+=head2 $upload->copy_to
+
+Copies the temporary file using L<File::Copy>. Returns true for success,
+false for failure.
 
      $upload->copy_to('/path/to/target');
 
@@ -48,29 +53,40 @@ sub copy_to {
     return File::Copy::copy( $self->tempname, @_ );
 }
 
-=item $upload->fh
+=head2 $upload->fh
 
-Opens tempname and returns a C<IO::File> handle.
+Opens a temporary file (see tempname below) and returns an L<IO::File> handle.
 
 =cut
 
 sub fh {
     my $self = shift;
 
-    my $fh = IO::File->new( $self->tempname, IO::File::O_RDONLY )
-      or die( "Can't open ", $self->tempname, ": ", $! );
+    my $fh = IO::File->new( $self->tempname, IO::File::O_RDONLY );
+
+    unless ( defined $fh ) {
+
+        my $filename = $self->tempname;
+
+        Catalyst::Exception->throw(
+            message => qq/Can't open '$filename': '$!'/ );
+    }
 
     return $fh;
 }
 
-=item $upload->filename
+=head2 $upload->filename
+
+Returns the client-supplied filename.
 
-Contains client supplied filename.
+=head2 $upload->headers
 
-=item $upload->link_to
+Returns an L<HTTP::Headers> object for the request.
 
-Creates a hard link to the tempname.  Returns true for success, 
-false otherwise.
+=head2 $upload->link_to
+
+Creates a hard link to the temporary file. Returns true for success, 
+false for failure.
 
     $upload->link_to('/path/to/target');
 
@@ -81,23 +97,47 @@ sub link_to {
     return CORE::link( $self->tempname, $target );
 }
 
-=item $upload->size
+=head2 $upload->size
+
+Returns the size of the uploaded file in bytes.
 
-Contains size of the file in bytes.
+=head2 $upload->slurp
 
-=item $upload->tempname
+Returns a scalar containing the contents of the temporary file.
+
+=cut
 
-Contains path to the temporary spool file.
+sub slurp {
+    my ( $self, $layer ) = @_;
 
-=item $upload->type
+    unless ($layer) {
+        $layer = ':raw';
+    }
 
-Contains client supplied Content-Type.
+    my $content = undef;
+    my $handle  = $self->fh;
 
-=back
+    binmode( $handle, $layer );
 
-=head1 AUTHOR
+    while ( $handle->sysread( my $buffer, 8192 ) ) {
+        $content .= $buffer;
+    }
+
+    return $content;
+}
+
+=head2 $upload->tempname
+
+Returns the path to the temporary file.
+
+=head2 $upload->type
+
+Returns the client-supplied Content-Type.
+
+=head1 AUTHORS
 
 Sebastian Riedel, C<sri@cpan.org>
+
 Christian Hansen, C<ch@ngmedia.com>
 
 =head1 COPYRIGHT