Module: ActionController::Head

Extended by:
ActiveSupport::Concern
Included in:
ConditionalGet
Defined in:
lib/action_controller/metal/head.rb

Instance Method Summary collapse

Instance Method Details

#head(status, options = {}) ⇒ Object

Return a response that has no content (merely headers). The options argument is interpreted to be a hash of header names and values. This allows you to easily return a response that consists only of significant headers:

head :created, :location => person_path(@person)

It can also be used to return exceptional conditions:

return head(:method_not_allowed) unless request.post?
return head(:bad_request) unless valid_request?
render



17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
# File 'lib/action_controller/metal/head.rb', line 17

def head(status, options = {})
  options, status = status, nil if status.is_a?(Hash)
  status ||= options.delete(:status) || :ok
  location = options.delete(:location)

  options.each do |key, value|
    headers[key.to_s.dasherize.split(/-/).map { |v| v.capitalize }.join("-")] = value.to_s
  end

  self.status = status
  self.location = url_for(location) if location
  self.content_type = Mime[formats.first] if formats
  self.response_body = " "
end