| Module | ActiveResource::CustomMethods | 
| In: | lib/active_resource/custom_methods.rb | 
A module to support custom REST methods and sub-resources, allowing you to break out of the "default" REST methods with your own custom resource requests. For example, say you use Rails to expose a REST service and configure your routes with:
   map.resources :people, :new => { :register => :post },
                          :member => { :promote => :put, :deactivate => :delete }
                          :collection => { :active => :get }
 This route set creates routes for the following HTTP requests:
   POST    /people/new/register.xml # PeopleController.register
   PUT     /people/1/promote.xml    # PeopleController.promote with :id => 1
   DELETE  /people/1/deactivate.xml # PeopleController.deactivate with :id => 1
   GET     /people/active.xml       # PeopleController.active
Using this module, Active Resource can use these custom REST methods just like the standard methods.
  class Person < ActiveResource::Base
    self.site = "http://37s.sunrise.i:3000"
  end
  Person.new(:name => 'Ryan).post(:register)  # POST /people/new/register.xml
  # => { :id => 1, :name => 'Ryan' }
  Person.find(1).put(:promote, :position => 'Manager') # PUT /people/1/promote.xml
  Person.find(1).delete(:deactivate) # DELETE /people/1/deactivate.xml
  Person.get(:active)  # GET /people/active.xml
  # => [{:id => 1, :name => 'Ryan'}, {:id => 2, :name => 'Joe'}]
    | delete | -> | orig_delete | 
Invokes a GET to a given custom REST method. For example:
  Person.get(:active)  # GET /people/active.xml
  # => [{:id => 1, :name => 'Ryan'}, {:id => 2, :name => 'Joe'}]
  Person.get(:active, :awesome => true)  # GET /people/active.xml?awesome=true
  # => [{:id => 1, :name => 'Ryan'}]
Note: the objects returned from this method are not automatically converted into ActiveResource::Base instances - they are ordinary Hashes. If you are expecting ActiveResource::Base instances, use the find class method with the :from option. For example:
Person.find(:all, :from => :active)