resource

Creates named routes for implementing verb-oriented controllers for a singleton resource. A singleton resource is global to the current user visiting the application, such as a user’s /account profile.

See map.resources for general conventions. These are the main differences:

  - A singular name is given to map.resource.  The default controller name is taken from the singular name.
  - There is no <tt>:collection</tt> option as there is only the singleton resource.
  - There is no <tt>:singular</tt> option as the singular name is passed to map.resource.
  - No default index route is created for the singleton resource controller.
  - When nesting singleton resources, only the singular name is used as the path prefix (example: 'account/messages/1')

Example:

  map.resource :account

  class AccountController < ActionController::Base
    # POST account_url
    def create
      # create an account
    end

    # GET new_account_url
    def new
      # return an HTML form for describing the new account
    end

    # GET account_url
    def show
      # find and return the account
    end

    # GET edit_account_url
    def edit
      # return an HTML form for editing the account
    end

    # PUT account_url
    def update
      # find and update the account
    end

    # DELETE account_url
    def destroy
      # delete the account
    end
  end

Along with the routes themselves, #resource generates named routes for use in controllers and views. map.resource :account produces the following named routes and helpers:

  Named Route   Helpers
  account       account_url, hash_for_account_url,
                account_path, hash_for_account_path
  edit_account  edit_account_url, hash_for_edit_account_url,
                edit_account_path, hash_for_edit_account_path