Rails POST, PUT, GET
Ruby on-RailsRubyWeb ServicesHttpRuby on-Rails Problem Overview
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 (create
or 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?
Ruby on-Rails Solutions
Solution 1 - Ruby on-Rails
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 map.resources :items
Solution 2 - Ruby on-Rails
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.
Specifying 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.
Solution 3 - Ruby on-Rails
The best place to learn about this would be the Routing Guide.
Solution 4 - Ruby on-Rails
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
etc etc.
Solution 5 - Ruby on-Rails
Like Don Werve said, take a look at your routes.rb file. In there you probably have something like this:
map.resources :items
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.
Solution 6 - Ruby on-Rails
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 :items
Solution 7 - Ruby on-Rails
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.
Railsguides has a nice routes guide.
Solution 8 - Ruby on-Rails
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.