Class: Merb::Router::Behavior::Proxy

Inherits:
Object
  • Object
show all
Defined in:
lib/merb-core/dispatch/router/behavior.rb

Overview

Proxy catches any methods and proxies them to the current behavior. This allows building routes without constantly having to catching the yielded behavior object

:api: private

Instance Method Summary collapse

Constructor Details

#initializeProxy

:api: private


21
22
23
# File 'lib/merb-core/dispatch/router/behavior.rb', line 21

def initialize
  @behaviors = []
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *args, &block) ⇒ Object (private)

Proxies the method calls to the behavior.

Notes

Please refer to: ruby-doc.org/core/classes/Kernel.html#M005951

:api: private


152
153
154
155
156
157
158
159
160
# File 'lib/merb-core/dispatch/router/behavior.rb', line 152

def method_missing(method, *args, &block)
  behavior = @behaviors.last
  
  if behavior.respond_to?(method)
    behavior.send(method, *args, &block)
  else
    super
  end
end

Instance Method Details

#popObject

Removes the top-most behavior.

Notes

This occurs at the end of a nested scope (namespace, etc).

:api: private


41
42
43
# File 'lib/merb-core/dispatch/router/behavior.rb', line 41

def pop
  @behaviors.pop
end

#push(behavior) ⇒ Object

Puts a behavior on the bottom of the stack.

Notes

The behaviors keep track of nested scopes.

:api: private


31
32
33
# File 'lib/merb-core/dispatch/router/behavior.rb', line 31

def push(behavior)
  @behaviors.push(behavior)
end

#redirect(url, opts = {}) ⇒ Object

Generates a Rack redirection response.

Notes

Refer to Merb::Rack::Helpers.redirect for documentation.

:api: public


139
140
141
# File 'lib/merb-core/dispatch/router/behavior.rb', line 139

def redirect(url, opts = {})
  Merb::Rack::Helpers.redirect(url, opts)
end

#respond_to?(*args) ⇒ Boolean

Tests whether the top-most behavior responds to the arguments.

Notes

Behaviors contain the actual functionality of the proxy.

:api: private

Returns:

  • (Boolean)

51
52
53
# File 'lib/merb-core/dispatch/router/behavior.rb', line 51

def respond_to?(*args)
  super || @behaviors.last.respond_to?(*args)
end

#url(name, *args) ⇒ Object

There are three possible ways to use this method. First, if you have a named route, you can specify the route as the first parameter as a symbol and any paramters in a hash. Second, you can generate the default route by just passing the params hash, just passing the params hash. Finally, you can use the anonymous parameters. This allows you to specify the parameters to a named route in the order they appear in the router.

Parameters(Named Route)

name<Symbol>

The name of the route.

args<Hash>

Parameters for the route generation.

Parameters(Default Route)

args<Hash>

Parameters for the route generation. This route will use the default route.

Parameters(Anonymous Parameters)

name<Symbol>

The name of the route.

args<Array>

An array of anonymous parameters to generate the route with. These parameters are assigned to the route parameters in the order that they are passed.

Returns

String

The generated URL.

Examples

Named Route

Merb::Router.prepare do

match("/articles/:title").to(:controller => :articles, :action => :show).name("articles")

end

url(:articles, :title => “new_article”)

Default Route

Merb::Router.prepare do

default_routes

end

url(:controller => “articles”, :action => “new”)

Anonymous Paramters

Merb::Router.prepare do

match("/articles/:year/:month/:title").to(:controller => :articles, :action => :show).name("articles")

end

url(:articles, 2008, 10, “test_article”)

:api: public


128
129
130
131
# File 'lib/merb-core/dispatch/router/behavior.rb', line 128

def url(name, *args)
  args << {}
  Merb::Router.url(name, *args)
end