Class: Ramaze::Helper::Upload::UploadedFile

Inherits:
Object
  • Object
show all
Includes:
Traited
Defined in:
lib/ramaze/helper/upload.rb

Overview

This class represents an uploaded file.

Author:

Since:

Instance Attribute Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (Ramaze::Helper::Upload::UploadedFile) initialize(filename, type, tempfile, options)

Initializes a new Ramaze::Helper::Upload::UploadedFile object.

Parameters:

  • filename (String)

    Suggested file name

  • type (String)

    MIME-type

  • tempfile (File)

    temporary file

  • options (Hash)

    Options for uploaded files. Options supported match those available to Ramaze::Helper::Upload::ClassMethods#upload_options

See Also:

Since:

  • 18-08-2011



378
379
380
381
382
383
384
385
# File 'lib/ramaze/helper/upload.rb', line 378

def initialize(filename, type, tempfile, options)
  @filename = File.basename(filename)
  @type     = type
  @tempfile = tempfile
  @realfile = nil

  trait :options => options
end

Instance Attribute Details

- (String) filename

Suggested file name

Returns:

  • (String)

Since:

  • 18-08-2011



359
360
361
# File 'lib/ramaze/helper/upload.rb', line 359

def filename
  @filename
end

- (String) type (readonly)

MIME-type

Returns:

  • (String)

Since:

  • 18-08-2011



363
364
365
# File 'lib/ramaze/helper/upload.rb', line 363

def type
  @type
end

Instance Method Details

- (String|nil) path

Returns the path of the Ramaze::Helper::Upload::UploadedFile object. The method will always return nil before save has been called on the Ramaze::Helper::Upload::UploadedFile object.

Returns:

  • (String|nil)

Since:

  • 18-08-2011



407
408
409
# File 'lib/ramaze/helper/upload.rb', line 407

def path
  return self.saved? ? @realfile.path : nil
end

- (Object) save(path = nil, options = {})

Saves the Ramaze::Helper::Upload::UploadedFile.

If +path+ is not set, the method checks whether there exists default options for the path and tries to use that instead.

If you need to override any options set in the controller (using upload_options) you can set the corresponding option in +options+ to override the behavior for this particular Ramaze::Helper::Upload::UploadedFile object.

Parameters:

  • path (String) (defaults to: nil)

    Path where the Ramaze::Helper::Upload::UploadedFile will be saved

  • options (Hash) (defaults to: {})

    Options for uploaded files. Options supported match those available to Ramaze::Helper::Upload::ClassMethods#upload_options

Raises:

  • (StandardError)

    Will be raised if the save operation fails.

See Also:

Since:

  • 18-08-2011



431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
# File 'lib/ramaze/helper/upload.rb', line 431

def save(path = nil, options = {})
  # Merge options
  opts = trait[:options].merge(options)

  unless path
    # No path was provided, use info stored elsewhere to try to build
    # the path
    unless opts[:default_upload_dir]
      raise StandardError.new('Unable to save file, no dirname given')
    end

    unless @filename
      raise StandardError.new('Unable to save file, no filename given')
    end

    # Check to see if a proc or a string was used for the
    # default_upload_dir parameter. If it was a proc, call the proc and
    # use the result as the directory part of the path. If a string was
    # used, use the string directly as the directory part of the path.
    dn = opts[:default_upload_dir]

    if dn.respond_to?(:call)
      dn = dn.call
    end

    path = File.join(dn, @filename)
  end

  path = File.expand_path(path)

  # Abort if file altready exists and overwrites are not allowed
  if File.exists?(path) and !opts[:allow_overwrite]
    raise StandardError.new('Unable to overwrite existing file')
  end

  # Confirm that we can read source file
  unless File.readable?(@tempfile.path)
    raise StandardError.new('Unable to read temporary file')
  end

  # Confirm that we can write to the destination file
  unless (File.exists?(path) and File.writable?(path)) \
  or (File.exists?(File.dirname(path)) \
    and File.writable?(File.dirname(path)))
    raise StandardError.new(
      "Unable to save file to #{path}. Path is not writable"
    )
  end

  # If supported, use IO,copy_stream. If not, require fileutils
  # and use the same method from there
  if IO.respond_to?(:copy_stream)
    IO.copy_stream(@tempfile, path)
  else
    require 'fileutils'
    File.open(@tempfile.path, 'rb') do |src|
      File.open(path, 'wb') do |dest|
        FileUtils.copy_stream(src, dest)
      end
    end
  end

  # Update the realfile property, indicating that the file has been
  # saved
  @realfile = File.new(path)
  # But no need to keep it open
  @realfile.close

  # If the unlink_tempfile option is set to true, delete the temporary
  # file created by Rack
  unlink_tempfile if opts[:unlink_tempfile]
end

- (Boolean) saved?

Returns whether the Ramaze::Helper::Upload::UploadedFile has been saved or not.

Returns:

  • (Boolean)

Since:

  • 18-08-2011



510
511
512
# File 'lib/ramaze/helper/upload.rb', line 510

def saved?
  return !@realfile.nil?
end

Deletes the temporary file associated with this Ramaze::Helper::Upload::UploadedFile immediately.

Since:

  • 18-08-2011



518
519
520
521
# File 'lib/ramaze/helper/upload.rb', line 518

def unlink_tempfile
  File.unlink(@tempfile.path)
  @tempfile = nil
end