Class: Flame::Controller

Inherits:
Object
  • Object
show all
Extended by:
Actions, Forwardable
Includes:
PathTo, Memery
Defined in:
lib/flame/controller.rb,
lib/flame/controller/actions.rb,
lib/flame/controller/cookies.rb,
lib/flame/controller/path_to.rb

Overview

Class initialize when Dispatcher found route with it For new request and response

Defined Under Namespace

Modules: Actions, PathTo Classes: Cookies

Class Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Actions

actions, inherit_actions, with_actions

Methods included from PathTo

#path_to, #path_to_back, #url_to

Constructor Details

#initialize(dispatcher) ⇒ Controller

Initialize the controller for request execution

Parameters:

  • host dispatcher



57
58
59
 
# File 'lib/flame/controller.rb', line 57

def initialize(dispatcher)
  @dispatcher = dispatcher
end

Class Attribute Details

.path_arguments ⇒ Object

Returns the value of attribute path_arguments.



32
33
34
 
# File 'lib/flame/controller.rb', line 32

def path_arguments
  @path_arguments
end

Class Method Details

.path ⇒ Object 



34
35
36
37
38
 
# File 'lib/flame/controller.rb', line 34

def path
  return self::PATH if const_defined?(:PATH)

  default_path
end

Instance Method Details

#attachment(filename = nil, disposition = :attachment) ⇒ Object

Set the Content-Disposition to “attachment” with the specified filename, instructing the user agents to prompt to save, and set Content-Type by filename.

Examples:

Set Content-Disposition header without filename

attachment

Set Content-Disposition header with filename and Content-Type

attachment 'style.css'

Parameters:

  • (defaults to: nil)

    filename of attachment

  • (defaults to: :attachment)

    main content for Content-Disposition



115
116
117
118
119
120
121
122
123
 
# File 'lib/flame/controller.rb', line 115

def attachment(filename = nil, disposition = :attachment)
  content_dis = 'Content-Disposition'
  response[content_dis] = disposition.to_s
  return unless filename

  response[content_dis] += "; filename=\"#{File.basename(filename)}\""
  ext = File.extname(filename)
  response.content_type = ext unless ext.empty?
end

#cookies ⇒ Object

Cookies object as Hash



62
63
64
 
# File 'lib/flame/controller.rb', line 62

memoize def cookies
  Cookies.new(request.cookies, response)
end

#redirect(path, status) ⇒ nil #redirect(uri, status) ⇒ nil #redirect(*args, status) ⇒ nil

Redirect for response

Overloads:

  • #redirect(path, status) ⇒ nil

    Redirect to the string path

    Examples:

    Redirect to ‘/hello’

    redirect '/hello'

    Redirect to ‘/hello’ with status 301

    redirect '/hello', 301

    Parameters:

    • path

    • HTTP status

    Returns:

  • #redirect(uri, status) ⇒ nil

    Redirect to the URI location

    Examples:

    Redirect to ‘example.com’

    redirect URI::HTTP.build(host: 'example.com')

    Redirect to ‘example.com’ with status 301

    redirect URI::HTTP.build(host: 'example.com'), 301

    Parameters:

    • URI object

    • HTTP status

    Returns:

  • #redirect(*args, status) ⇒ nil

    Redirect to the path of path_to method

    Examples:

    Redirect to show method of ArticlesController with id = 2

    redirect ArticlesController, :show, id: 2

    Redirect to method of controller with status 301

    redirect ArticlesController, :show, { id: 2 }, 301

    Parameters:

    • arguments for path_to method

    • HTTP status

    Returns:



96
97
98
99
100
101
102
103
104
 
# File 'lib/flame/controller.rb', line 96

def redirect(*args)
  args[0] = args.first.to_s if args.first.is_a? URI
  unless args.first.is_a? String
    path_to_args_range = 0..(args.last.is_a?(Integer) ? -2 : -1)
    args[path_to_args_range] = path_to(*args[path_to_args_range])
  end
  response.redirect(*args)
  status
end

#view(path = nil, options = {}) ⇒ String Also known as: render

Render a template with Flame::Render (based on Tilt-engine)

Parameters:

  • (defaults to: nil)

    path to the template file

  • (defaults to: {})

    options for the Flame::Render rendering

Returns:

  • rendered template



129
130
131
132
133
134
135
136
137
138
 
# File 'lib/flame/controller.rb', line 129

def view(path = nil, options = {}, &)
  cache = options.delete(:cache)
  cache = config[:environment] == 'production' if cache.nil?
  template = Flame::Render.new(
    self,
    path || caller_locations(1, 1)[0].base_label.to_sym,
    options
  )
  template.render(cache: cache, &)
end