diff options
Diffstat (limited to 'railties/doc/guides/source/actioncontroller_basics/verification.txt')
-rw-r--r-- | railties/doc/guides/source/actioncontroller_basics/verification.txt | 40 |
1 files changed, 0 insertions, 40 deletions
diff --git a/railties/doc/guides/source/actioncontroller_basics/verification.txt b/railties/doc/guides/source/actioncontroller_basics/verification.txt deleted file mode 100644 index a4522a0102..0000000000 --- a/railties/doc/guides/source/actioncontroller_basics/verification.txt +++ /dev/null @@ -1,40 +0,0 @@ -== Verification == - -Verifications make sure certain criteria are met in order for a controller or action to run. They can specify that a certain key (or several keys in the form of an array) is present in the `params`, `session` or `flash` hashes or that a certain HTTP method was used or that the request was made using XMLHTTPRequest (Ajax). The default action taken when these criteria are not met is to render a 400 Bad Request response, but you can customize this by specifying a redirect URL or rendering something else and you can also add flash messages and HTTP headers to the response. It is described in the link:http://api.rubyonrails.org/classes/ActionController/Verification/ClassMethods.html[API documentation] as "essentially a special kind of before_filter". - -Here's an example of using verification to make sure the user supplies a username and a password in order to log in: - -[source, ruby] ---------------------------------------- -class LoginsController < ApplicationController - - verify :params => [:username, :password], - :render => {:action => "new"}, - :add_flash => {:error => "Username and password required to log in"} - - def create - @user = User.authenticate(params[:username], params[:password]) - if @user - flash[:notice] = "You're logged in" - redirect_to root_url - else - render :action => "new" - end - end - -end ---------------------------------------- - -Now the `create` action won't run unless the "username" and "password" parameters are present, and if they're not, an error message will be added to the flash and the `new` action will be rendered. But there's something rather important missing from the verification above: It will be used for *every* action in LoginsController, which is not what we want. You can limit which actions it will be used for with the `:only` and `:except` options just like a filter: - -[source, ruby] ---------------------------------------- -class LoginsController < ApplicationController - - verify :params => [:username, :password], - :render => {:action => "new"}, - :add_flash => {:error => "Username and password required to log in"}, - :only => :create # Only run this verification for the "create" action - -end ---------------------------------------- |