Utopia SourceUtopiaControllerActions

module Actions

Actions let you match path patterns in your controller and execute code. In your controller.rb simply add:

prepend Actions

If you are adding multiple things, like rewriting, they should come earlier in the chain, e.g:

prepend Rewrite, Actions

A simple CRUD controller might look like:

prepend Actions

on 'index' do
	@users = User.all
end

on 'new' do |request|
	@user = User.new
	
	if request.post?
		@user.update_attributes(request.params['user'])
		
		redirect! "index"
	end
end

on 'edit' do |request|
	@user = User.find(request.params['id'])
	
	if request.post?
		@user.update_attributes(request.params['user'])
		
		redirect! "index"
	end
end

on 'delete' do |request|
	User.find(request.params['id']).destroy
	
	redirect! "index"
end

Path Matching

Path matching works from right to left, and '**' is a greedy operator. Controllers are invoked with a path relative to the controller's URI_PATH, so all lookups are relative to the controller.

"*"
Match a single path element
"**"
Match all remaining path elements
String
Match a named path component, e.g. "edit".
Symbol
Equivalent to ["**", symbol.to_s], e.g. :logout.

Otherwise Matching

If no action was matched, it is sometimes useful to perform some specific behaviour. You can specify this by using the otherwise handler:

otherwise do |request, path|
	fail! :teapot
end

If you are doing this to perform some kind of rewriting, it may be preferable to use the Rewrite controller layer.

Nested

Definitions

def process!(request, path)

Invoke all matching actions. If no actions match, will call otherwise. If no action gives a response, the request is passed to super.

Implementation

def process!(request, path)
	catch_response do
		self.class.dispatch(self, request, path)
	end || super
end