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.

Source: show | on GitHub 

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

eof?()

Shortcut for tempfile.eof?.

Source: show | on GitHub 

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

open()

Shortcut for tempfile.open.

Source: show | on GitHub 

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

path()

Shortcut for tempfile.path.

Source: show | on GitHub 

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

read(length = nil, buffer = nil)

Shortcut for tempfile.read.

Source: show | on GitHub 

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

rewind()

Shortcut for tempfile.rewind.

Source: show | on GitHub 

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

size()

Shortcut for tempfile.size.

Source: show | on GitHub 

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

to_io()

Source: show | on GitHub 

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

to_path()

Shortcut for tempfile.to_path.

Source: show | on GitHub 

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