Skip to Content Skip to Search

Action Dispatch HTTP UploadedFile

Models uploaded files.

The actual file is accessible via the tempfile accessor, though some of its interface is available directly for convenience.

Uploaded files are temporary files whose lifespan is one request. When the object is finalized Ruby unlinks the file, so there is no need to clean them with a separate maintenance task.

Methods
C
E
O
P
R
S
T

Attributes

[RW] content_type

A string with the MIME type of the file.

[RW] headers

A string with the headers of the multipart request.

[RW] original_filename

The basename of the file in the client.

[RW] tempfile

A Tempfile object with the actual uploaded file. Note that some of its interface is available directly.

Instance Public methods

close(unlink_now = false)

Shortcut for tempfile.close.

# File actionpack/lib/action_dispatch/http/upload.rb, line 71
def close(unlink_now = false)
  @tempfile.close(unlink_now)
end

eof?()

Shortcut for tempfile.eof?.

# File actionpack/lib/action_dispatch/http/upload.rb, line 96
def eof?
  @tempfile.eof?
end

open()

Shortcut for tempfile.open.

# File actionpack/lib/action_dispatch/http/upload.rb, line 66
def open
  @tempfile.open
end

path()

Shortcut for tempfile.path.

# File actionpack/lib/action_dispatch/http/upload.rb, line 76
def path
  @tempfile.path
end

read(length = nil, buffer = nil)

Shortcut for tempfile.read.

# File actionpack/lib/action_dispatch/http/upload.rb, line 61
def read(length = nil, buffer = nil)
  @tempfile.read(length, buffer)
end

rewind()

Shortcut for tempfile.rewind.

# File actionpack/lib/action_dispatch/http/upload.rb, line 86
def rewind
  @tempfile.rewind
end

size()

Shortcut for tempfile.size.

# File actionpack/lib/action_dispatch/http/upload.rb, line 91
def size
  @tempfile.size
end

to_io()

# File actionpack/lib/action_dispatch/http/upload.rb, line 100
def to_io
  @tempfile.to_io
end

to_path()

Shortcut for tempfile.to_path.

# File actionpack/lib/action_dispatch/http/upload.rb, line 81
def to_path
  @tempfile.to_path
end