After I generate a scaffold, Rails gives me the ability to POST to
items.xml which will create a new
item. A GET to
items.xml will simply list them all. Where does Rails specify which method in the controller (
index, respectively) will be called, based on the type of action I am performing?
More specifically, POST calls methodA but GET to the same URL calls methodB. Where is this specified? Where does Rails make the determination to call the
index method of the controller?
I believe it’s specified by REST. Here’s a list for ya:
GET /items #=> index GET /items/1 #=> show GET /items/new #=> new GET /items/1/edit #=> edit PUT /items/1 #=> update POST /items #=> create DELETE /items/1 #=> destroy
Edited to add to get all those routes, in config/routes.rb, simply add
Rails defines seven controller methods for RESTful resources by convention. They are:
Action HTTP Method Purpose ------------------------------------------------------------------------- index GET Displays a collection of resources show GET Displays a single resource new GET Displays a form for creating a new resource create POST Creates a new resource (new submits to this) edit GET Displays a form for editing an existing resource update PUT Updates an existing resource (edit submits to this) destroy DELETE Destroys a single resource
Note that because web browsers generally only support GET and POST, Rails uses a hidden field to turn these into PUT and DELETE requests as appropriate.
map.resources :items in
config/routes.rb gets you those seven methods “for free”. You can list all the routes within your application at any time by entering
rake routes in the console.
- See Rails Routing from the Outside In for more detail.
The best place to learn about this would be the Routing Guide.
Did you want to know how to use POST only? Do this, for example:
resources :items, :only => [:create]
..etc. This is for Rails 3 by the way, and will generate a single resource to POST create. Or if you only need a really small subset of the REST set, just:
match 'items/:id' => "items#create', :via => :post
Like Don Werve said, take a look at your routes.rb file. In there you probably have something like this:
This is where rails links the POST and GET requests to certain actions. To see how this works look at the links from the other answers. The docs help a ton.
To all the routes and which actions they link to you can type
rake routes into the command prompt when you are in the root of your rails directory. This will show you everything (in terms of routing) that a scaffold gives you.
This will help a lot, but it’s not a direct answer to your question. The following command will list the mappings your app uses so you don’t have to remember all the details or guess.
$ rake routes
To answer more directly, this is a convention that rails uses. You set this mapping up when you put something like the following in your routes.rb
map.resources is a method that automagically gives you the REST routes and path helpers as well. This is a nice feature if you already know and understand how rails’ restful routing works but it is also a bit of a hindrance for learning rails because too much is hidden.
To be honest, you can’t really go wrong with the routing documentation on the Rails website. This has helped take the next steps and move beyond the comfort of resources (which for most apps is fine)and really nail down the solid routing features available.