method

resource

v4.0.2 - Show latest stable - 0 notes - Class: ActionDispatch::Routing::Mapper::Resources

1.0.0
1.1.6
1.2.6
2.0.3
2.1.0
2.2.1
2.3.8
3.0.0 (0)
3.0.9 (34)
3.1.0 (3)
3.2.1 (0)
3.2.8 (0)
3.2.13 (0)
4.0.2 (1)
4.1.8
4.2.1
4.2.7
4.2.9
5.0.0.1
5.1.7
5.2.3
6.0.0
6.1.3.1
6.1.7.7
7.0.0
7.1.3.2
7.1.3.4
What's this?

resource(*resources, &block) public

Sometimes, you have a resource that clients always look up without referencing an ID. A common example, /profile always shows the profile of the currently logged in user. In this case, you can use a singular resource to map /profile (rather than /profile/:id) to the show action:

resource :geocoder

creates six different routes in your application, all mapping to the GeoCoders controller (note that the controller is named after the plural):

GET       /geocoder/new
POST      /geocoder
GET       /geocoder
GET       /geocoder/edit
PATCH/PUT /geocoder
DELETE    /geocoder

Options

Takes same options as resources.

Show source

# File actionpack/lib/action_dispatch/routing/mapper.rb, line 1084
        def resource(*resources, &block)
          options = resources.extract_options!.dup

          if apply_common_behavior_for(:resource, resources, options, &block)
            return self
          end

          resource_scope(:resource, SingletonResource.new(resources.pop, options)) do
            yield if block_given?

            concerns(options[:concerns]) if options[:concerns]

            collection do
              post :create
            end if parent_resource.actions.include?(:create)

            new do
              get :new
            end if parent_resource.actions.include?(:new)

            set_member_mappings_for_resource
          end

          self
        end

resource

Related methods

Options