module ActionController::Head - actionpack-4.2.4 Documentation

# module ActionController::Head

### Public Instance Methods

head(status, options = {}) click to toggle source

Returns 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)

    head :created, location: @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

See Rack::Utils::SYMBOL_TO_STATUS_CODE for a full list of valid `status` symbols.

    # File lib/action_controller/metal/head.rb, line 19
    def head(status, options = {})
      options, status = status, nil if status.is_a?(Hash)
      status ||= options.delete(:status) || :ok
      location = options.delete(:location)
      content_type = options.delete(:content_type)

      options.each do |key, value|
        headers[key.to_s.dasherize.split('-').each { |v| v[0] = v[0].chr.upcase }.join('-')] = value.to_s
      end

      self.status = status
      self.location = url_for(location) if location

      self.response_body = ""

      if include_content?(self.response_code)
        self.content_type = content_type || (Mime[formats.first] if formats)
        self.response.charset = false if self.response
      else
        headers.delete('Content-Type')
        headers.delete('Content-Length')
      end

      true
    end