restrack 0.0.5 → 0.0.6

data/README.rdoc

@@ -1,20 +1,15 @@
 = RESTRack
 
 == Description:
-    RESTRack is a Rack based MVC framework that makes it extremely easy to
-  develop RESTful data services. It is inspired by Rails, and follows a few of
-  its conventions.  But it has no routes file, routing relationships are done
-  through supplying custom code blocks to class methods such as
-  'has_relationship_to', 'has_mapped_relationships_to',
+    RESTRack is a Rack based MVC framework that makes it extremely easy to develop RESTful data services. It is inspired
+  by Rails, and follows a few of its conventions.  But it has no routes file, routing relationships are done through
+  supplying custom code blocks to class methods such as 'has_relationship_to', 'has_mapped_relationships_to',
   'has_direct_relationship_to', and 'has_direct_relationships_to'.
-    RESTRack aims at being lightweight and easy to use.  It will
-  automatically render JSON and XML for the data structures you return in your
-  actions (any structure parsable by the 'json' and 'xml-simple' gems,
-  respectively).
-    If you supply a view for a controller action, you do that using a builder
-  file (view/<controller>/<action>.xml.builder).  XML format requests will then
-  render the view template with the builder gem, rather than generating XML with
-  XmlSimple.
+    RESTRack aims at being lightweight and easy to use.  It will automatically render JSON and XML for the data
+  structures you return in your actions (any structure parsable by the 'json' and 'xml-simple' gems, respectively).
+    If you supply a view for a controller action, you do that using a builder file.  Builder files are stored in the
+  view directory grouped by controller name subdirectories (view/<controller>/<action>.xml.builder).  XML format
+  requests will then render the view template with the builder gem, rather than generating XML with XmlSimple.
   
 
 == Installation:
@@ -22,63 +17,138 @@
 
 
 == Why RESTRack when there is Rails?
-  Rails is a powerful tool for full web applications.  RESTRack is targeted at
-  making development of lightweight data services as easy as possible, while
-  still giving you a performant and extensible framework.  The primary goal of
-  the framework was to add as little as possible to the framework to give the
-  web developer a good application space for developing JSON or XML services.
+    Rails is a powerful tool for full web applications.  RESTRack is targeted at making development of lightweight data
+  services as easy as possible, while still giving you a performant and extensible framework.  The primary goal of
+  of the development of RESTRack was to add as little as possible to the framework to give the web developer a good
+  application space for developing JSON and XML services.
     
+    Rails 3 instantiates approximately 80K more objects than RESTRack to do a hello world or nothing type response with
+  the default setup.  Trimming Rails down to just ActionController, by eliminating ActiveRecord, ActionMailer, and
+  ActiveResource, it still instantiates over 47K more objects than RESTRack.
 
-== Usage:
+
+== CLI Usage:
   - restrack generate service foo_bar
+    - restrack gen serv foo_bar
+    - restrack g s foo_bar
   - restrack generate controller baz
+    - restrack gen cont baz
+    - restrack g c baz
+  - restrack server # default rackup port 9292
   - restrack server 3456
+    - restrack s 3456
 
 
 == REST action method names
-  All default RESTful controller method names align with their Rails
-  counterparts, with two additional actions being supported(*).
+    All default RESTful controller method names align with their Rails counterparts, with two additional actions being
+  supported(*).
 
     #                    HTTP Verb: |   GET   |   PUT    |   POST   |   DELETE
     #   Collection URI (/widgets/): |  index  |  replace |  create  |  *drop
     #   Element URI (/widgets/42):  |  show   |  update  |  *add    |  destroy
 
 
-== How-Tos
+== URLs and Controller relationships
+    RESTRack enforces a strict URL pattern through the contruct of controller relationships, rather than a routing file.
+  Defining a controller for a resource means that you plan to expose that resource to requests to your service.
+  Defining a controller relationship means that you plan to expose a path from this resource to another.
+  
+    An open, or pass-through, path can be defined via the 'pass_through_to' class method for resource controllers.  This
+  exposes URL patterns like the following:
+  GET /foo/123/bar/234      <= simple pass-through from Foo 123 to show Bar 234
+  GET /foo/123/bar          <= simple pass-through from Foo 123 to Bar index
+  
+    A direct path to a single related resource's controller can be defined with the 'has_relationship_to' method.  This
+  allows you to define a one-to-one relationship from this resource to a related resource, which means that the id of
+  the related resource is implied through the id of the caller.  The caller has one and only one relation through a
+  custom code block passed to 'has_relationship_to'.  The code block takes the caller resource's id and evaluates to the
+  relation resource's id, for example a PeopleController might define a one-to-one relationship like so:
+        has_relationship_to( :people, :as spouse ) do |id|
+          People.find(id).spouse.id
+        end
+  This exposes URL patterns like
+  the following:
+  GET     /people/Sally/spouse  <= direct route to show Sally's spouse
+  PUT     /people/Henry/spouse  <= direct route to update Henry's spouse
+  POST    /people/Jane/spouse   <= direct route to add Jane's spouse
+  
+  # TODO: need has_relationships_to and has_direct_relationships_to
+    A direct path to many related resources' controller can be defined with the 'has_relationships_to' method.  This
+  allows you to define one-to-many relationships.  It works similar to 'has_relationship_to', except that the code block
+  passed to it should evaluate to an array of the related child ids.  Each resource in the parent's relation list is
+  then accessed through its array index (zero-based) in the URL.  An example of exposing the list of a People resource's
+  children in this manner follows:
+        has_direct_relationships_to( :people, :as => children ) do |id|
+          People.find(id).children.collect {|child| child.id}
+        end
+  GET     /people/Nancy/children/0      <= direct route to show child 0
+  DELETE  /people/Robert/children/100   <= direct route to destroy child 100
+  
+    Multiple named one-to-many relationships can be exposed with the 'has_mapped_relationships_to' method.  This allows
+  you to define many named or keyword paths to related resources.  The method's code block should accepts the parent id
+  and return a hash where the keys are your relationship names and the values are the child resource ids.  For example,
+  within a PeopleController the following definition:
+        has_mapped_relationships_to( :people ) do |id|
+          {
+            'father'    => People.find(id).father.id,
+            'mother'    => People.find(id).mother.id,
+            'boss'      => People.find(id).boss.id,
+            'assistant' => People.find(id).assistant.id
+          }
+        end
+  This would expose the following URL patterns:
+  GET     /people/Fred/people/father     => show the father of Fred
+  PUT     /people/Fred/people/assistant  => update Fred's assistant
+  POST    /people/Fred/people/boss       => add Fred's boss
+  DELETE  /people/Luke/people/mother     => destroy Luke's father
+
+
+    Resource id data types can be defined with the keyed_with_type class method within resource controllers.  The
+  default data type of String is used if a different type is not specified.
 
-  ...yet to be done...
-  === Authentication Suggestions
+
+== How-Tos
 
   === Logging/Logging Level
+      RESTRack logs to two logs, the standard log (or error log) and the request log.  Paths and logging levels for these
+    can be configured in config/constants.yaml.  RESTRack uses Logger from Ruby-stdlib.
   
   === XML Serialization
-    ==== With Builder
+      RESTRack will convert the data structures that your actions return to JSON by default.  You can change the default
+    by setting :DEFAULT_FORMAT to :XML in config/constants.yml.
+  
     ==== With XmlSimple
-          @output = XmlSimple.xml_out(data, 'AttrPrefix' => true)
+      RESTRack will attempt to serialize the data structures that your action methods return automatically using the
+    xml-simple gem.
+          
+    ==== With Builder
+      Custom XML serialization can be done by providing Builder gem templates in views/<controller>/<action>.xml.builder
+    
   === Inputs
     ==== GET params
     ==== POST data
 
-
+  === TODO: :DEFAULT_RESOURCE
+    ...yet to be done...
+  === TODO: :ROOT_RESOURCE_ACCEPT/:ROOT_RESOURCE_DENY
+    ...yet to be done...
+  === TODO: Authentication/Authorization Suggestions
+    ...yet to be done...
+  
 
 == License:
 
 Copyright (c) 2010 Chris St. John
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit
+persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/bin/restrack

@@ -2,22 +2,31 @@
 require 'rubygems'
 require 'restrack'
 
-verb = ARGV[0]
+verb = ARGV[0].to_sym
 noun = ARGV[1]
 
-case verb.to_sym
-when :generate
+
+case verb
+when :generate, :gen, :g
   name = ARGV[2]
   case noun.to_sym
-  when :service
+  when :service, :serv, :s
     puts "Generating new RESTRack service #{name}..."
     RESTRack::Generator.generate_service( name )
-  when :controller
-    puts "Generating new controller #{name}..."
-    RESTRack::Generator.generate_controller( name )
+  when :controller, :cont, :c
+    predicate  = ARGV[3].to_sym
+    case predicate
+    when :descendant_from, :parent
+      parent = ARGV[4]
+      puts "Generating new controller #{name} which is descendant from #{parent}..."
+      RESTRack::Generator.generate_descendant_controller( name, parent )
+    else
+      puts "Generating new controller #{name}..."
+      RESTRack::Generator.generate_controller( name )
+    end
   end
   puts 'Creation is complete.'
-when :server
+when :server, :s
   options = { :Port => noun || 9292, :config => 'config.ru' }
   Rack::Server.start( options )
 end

data/lib/restrack/generator/descendant_controller.rb.erb

@@ -0,0 +1,35 @@
+class <%= @service_name.camelize %>::<%= @name.camelize %>Controller < <%= @service_name.camelize %>::<%= @parent.camelize %>Controller
+
+  def index
+
+  end
+  
+  def create
+
+  end
+
+  def replace
+
+  end
+
+  def destroy
+
+  end
+
+  def show(id)
+
+  end
+
+  def update(id)
+
+  end
+
+  def delete(id)
+
+  end
+
+  def add(id)
+
+  end
+
+end

data/lib/restrack/generator.rb

@@ -5,11 +5,13 @@ require 'active_support/inflector'
 
 module RESTRack
   class Generator
+    
     TEMPLATE = {
-      :service    => 'loader.rb.erb',
-      :rackup     => 'config.ru.erb',
-      :constants  => 'constants.yaml.erb',
-      :controller => 'controller.rb.erb'
+      :service                => 'loader.rb.erb',
+      :rackup                 => 'config.ru.erb',
+      :constants              => 'constants.yaml.erb',
+      :controller             => 'controller.rb.erb',
+      :descendant_controller  => 'descendant_controller.rb.erb'
     }
     
     class << self
@@ -20,7 +22,17 @@ module RESTRack
         resultant_string = template.result( get_binding_for_controller( name ) )
         File.open("#{base_dir}/controllers/#{name}_controller.rb", 'w') {|f| f.puts resultant_string }
         # Generate view folder for controller
-        FileUtils.makedirs("#{name}/views")
+        FileUtils.makedirs("#{base_dir}/views/#{name}")
+      end
+      
+      # Generate controller file the descends from specified parent, to enable
+      # grouping of controller types and/or overarching functionality.
+      def generate_descendant_controller(name, parent)
+        template = get_template_for( :descendant_controller )
+        resultant_string = template.result( get_binding_for_descendant_controller( name, parent ) )
+        File.open("#{base_dir}/controllers/#{name}_controller.rb", 'w') {|f| f.puts resultant_string }
+        # Generate view folder for controller
+        FileUtils.makedirs("#{base_dir}/views/#{name}")
       end
   
       # Generate a new RESTRack service
@@ -56,6 +68,13 @@ module RESTRack
         @service_name = get_service_name
         binding
       end
+      
+      def get_binding_for_descendant_controller(name, parent)
+        @name = name
+        @parent = parent
+        @service_name = get_service_name
+        binding
+      end
   
       def get_binding_for_service(name)
         @service_name = name

data/lib/restrack/resource_controller.rb

@@ -1,21 +1,16 @@
 module RESTRack
-  # All RESTRack controllers descend from ResourceController.
   
+  # All RESTRack controllers should descend from ResourceController.  This class
+  # provides the methods for your controllers.
+  #
   #                    HTTP Verb: |    GET    |   PUT     |   POST    |   DELETE
   # Collection URI (/widgets/):   |   index   |   replace |   create  |   drop
   # Element URI   (/widgets/42):  |   show    |   update  |   add     |   destroy
-
-  #def index;       end
-  #def replace;     end
-  #def create;      end
-  #def drop;        end
-  #def show(id);    end
-  #def update(id);  end
-  #def add(id);     end
-  #def destroy(id); end
+  #
   
   class ResourceController
-    attr_reader :input, :output
+    attr_reader :action, :id
+    class << self; attr_accessor :key_type; end
 
     # Base initialization method for resources and storage of request input
     # This method should not be overriden in decendent classes.
@@ -25,35 +20,39 @@ module RESTRack
     end
     def __init(resource_request)
       @resource_request = resource_request
-      setup_action
       self
     end
 
-    # Call the controller's action and return it in the proper format.
+    # Call the controller's action and return output in the proper format.
     def call
+      self.determine_action
       args = []
-      args << @resource_request.id unless @resource_request.id.blank?
-      package( self.send(@resource_request.action.to_sym, *args) )
+      args << @id unless @id.blank?
+      self.send(@action.to_sym, *args)
     end
 
+    #def index;       end
+    #def replace;     end
+    #def create;      end
+    #def drop;        end
+    #def show(id);    end
+    #def update(id);  end
+    #def add(id);     end
+    #def destroy(id); end
+    
     def method_missing(method_sym, *arguments, &block)
       raise HTTP405MethodNotAllowed, 'Method not provided on controller.'
     end
 
-    protected # all internal methods are protected rather than private so that calling methods *could* be overriden if necessary.
+    # all internal methods are protected rather than private so that calling methods *could* be overriden if necessary.
+    protected
+    
     # This method allows one to access a related resource, without providing a direct link to specific relation(s).
-    def self.has_relationship_to(entity, opts = {})
+    def self.pass_through_to(entity, opts = {})
       entity_name = opts[:as] || entity
       define_method( entity_name.to_sym,
-        Proc.new do
-          @resource_request.id, @resource_request.action = nil, nil
-          ( @resource_request.id, @resource_request.action, @resource_request.path_stack ) = @resource_request.path_stack.split('/', 3) unless @resource_request.path_stack.blank?
-          if [ :index, :replace, :create, :destroy ].include? @resource_request.id
-            @resource_request.action = @resource_request.id
-            @resource_request.id = nil
-          end
-          format_id
-          self.call_relation(entity)
+        Proc.new do |calling_id| # The calling resource's id will come along for the ride when the new bridging method is called magically from ResourceController#call
+          @resource_request.call_controller(entity)
         end
       )
     end
@@ -62,33 +61,54 @@ module RESTRack
     # The second parameter is an options hash to support setting the local name of the relation via ':as => :foo'.
     # The third parameter to the method is a Proc which accepts the calling entity's id and returns the id of the relation to which we're establishing the link.
     # This adds an accessor instance method whose name is the entity's class.
-    def self.has_direct_relationship_to(entity, opts = {}, &get_entity_id_from_relation_id)
+    def self.has_relationship_to(entity, opts = {}, &get_entity_id_from_relation_id)
       entity_name = opts[:as] || entity
       define_method( entity_name.to_sym,
-        Proc.new do
-          @resource_request.id = get_entity_id_from_relation_id.call(@resource_request.id)
-          @resource_request.action = nil
-          ( @resource_request.action, @resource_request.path_stack ) = @resource_request.path_stack.split('/', 3) unless @resource_request.path_stack.blank?
-          format_id
-          self.call_relation(entity)
+        Proc.new do |calling_id| # The calling resource's id will come along for the ride when the new bridging method is called magically from ResourceController#call
+          id = get_entity_id_from_relation_id.call(@id)
+          @resource_request.url_chain.unshift(id)
+          @resource_request.call_controller(entity)
         end
       )
     end
 
     # This method defines that there are multiple links to members from an entity collection (an array of entity identifiers).
     # This adds an accessor instance method whose name is the entity's class.
-    def self.has_direct_relationships_to(entity, opts = {}, &get_entity_id_from_relation_id)
+    def self.has_relationships_to(entity, opts = {}, &get_entity_id_from_relation_id)
+      entity_name = opts[:as] || entity
+      define_method( entity_name.to_sym,
+        Proc.new do |calling_id| # The parent resource's id will come along for the ride when the new bridging method is called magically from ResourceController#call
+          entity_array = get_entity_id_from_relation_id.call(@id)
+          begin
+            index = @resource_request.url_chain.shift.to_i
+          rescue
+            raise HTTP400BadRequest, 'You requested an item by index and the index was not a valid number.'
+          end
+          unless index < entity_array.length
+            raise HTTP404ResourceNotFound, 'You requested an item by index and the index was larger than this item\'s list of relations\' length.'
+          end
+          id = entity_array[index]
+          @resource_request.url_chain.unshift(id)
+          @resource_request.call_controller(entity)
+        end
+      )
+    end
+    
+    # This method defines that there are multiple links to members from an entity collection (an array of entity identifiers).
+    # This adds an accessor instance method whose name is the entity's class.
+    def self.has_defined_relationships_to(entity, opts = {}, &get_entity_id_from_relation_id)
       entity_name = opts[:as] || entity
       define_method( entity_name.to_sym,
-        Proc.new do
-          entity_array = get_entity_id_from_relation_id.call(@resource_request.id)
-          @resource_request.id, @resource_request.action = nil, nil
-          ( @resource_request.id, @resource_request.action, @resource_request.path_stack ) = @resource_request.path_stack.split('/', 3) unless @resource_request.path_stack.blank?
-          format_id
-          unless entity_array.include?( @resource_request.id )
+        Proc.new do |calling_id| # The parent resource's id will come along for the ride when the new bridging method is called magically from ResourceController#call
+          entity_array = get_entity_id_from_relation_id.call(@id)
+          id = @resource_request.url_chain.shift
+          raise HTTP400BadRequest, 'No ID provided for has_defined_relationships_to routing.' if id.nil?
+          id = RESTRack.controller_class_for(entity).format_string_id(id) if id.is_a? String
+          unless entity_array.include?( id )
             raise HTTP404ResourceNotFound, 'Relation entity does not belong to referring resource.'
           end
-          self.call_relation(entity)
+          @resource_request.url_chain.unshift(id)
+          @resource_request.call_controller(entity)
         end
       )
     end
@@ -98,98 +118,79 @@ module RESTRack
     def self.has_mapped_relationships_to(entity, opts = {}, &get_entity_id_from_relation_id)
       entity_name = opts[:as] || entity
       define_method( entity_name.to_sym,
-        Proc.new do
-          entity_map = get_entity_id_from_relation_id.call(@resource_request.id)
-          @resource_request.action = nil
-          ( key, @resource_request.action, @resource_request.path_stack ) = @resource_request.path_stack.split('/', 3) unless @resource_request.path_stack.blank?
-          format_id
-          unless @resource_request.id = entity_map[key.to_sym]
-            raise HTTP404ResourceNotFound, 'Relation entity does not belong to referring resource.'
-          end
-          self.call_relation(entity)
+        Proc.new do |calling_id| # The parent resource's id will come along for the ride when the new bridging method is called magically from ResourceController#call
+          entity_map = get_entity_id_from_relation_id.call(@id)
+          key = @resource_request.url_chain.shift
+          id = entity_map[key.to_sym]
+          @resource_request.url_chain.unshift(id)
+          @resource_request.call_controller(entity)
         end
       )
     end
 
-    # Call the child relation (next entity in the path stack)
-    # common logic to all relationship methods
-    def call_relation(entity)
-      @resource_request.resource_name = entity.to_s.camelize
-      setup_action
-      @resource_request.locate
-      @resource_request.call
+    # Allows decendent controllers to set a data type for the id other than the default.
+    def self.keyed_with_type(klass)
+      self.key_type = klass
     end
 
-    # If the action is not set with the request URI, determine the action from HTTP Verb.
-    def setup_action
-      if @resource_request.action.blank?
-        if @resource_request.request.get?
-          @resource_request.action = @resource_request.id.blank? ? :index   : :show
-        elsif @resource_request.request.put?
-          @resource_request.action = @resource_request.id.blank? ? :replace : :update
-        elsif @resource_request.request.post?
-          @resource_request.action = @resource_request.id.blank? ? :create  : :add
-        elsif @resource_request.request.delete?
-          @resource_request.action = @resource_request.id.blank? ? :drop    : :destroy
+    # Find the action, and id if relevant, that the controller must call.
+    def determine_action
+      term = @resource_request.url_chain.shift
+      if term.nil?
+        @id = nil
+        @action = nil
+      # id terms can be pushed on the url_stack which are not of type String by relationship handlers
+      elsif term.is_a? String and self.methods.include?( term.to_sym )
+        @id = nil
+        @action = term.to_sym
+      else
+        @id = term
+        term = @resource_request.url_chain.shift
+        if term.nil?
+          @action = nil
+        elsif self.methods.include?( term.to_sym )
+          @action = term.to_sym
         else
           raise HTTP405MethodNotAllowed, 'Action not provided or found and unknown HTTP request method.'
         end
       end
-    end
-
-    # Allows decendent controllers to set a data type for the id other than the default.
-    def self.keyed_with_type(klass)
-      @@key_type = klass
+      @id = self.class.format_string_id(@id) if @id.is_a? String
+      # If the action is not set with the request URI, determine the action from HTTP Verb.
+      get_action_from_context if @action.blank?
     end
 
     # This method is used to convert the id coming off of the path stack, which is in string form, into another data type if one has been set.
-    def format_id
-      @@key_type ||= nil
-      unless @@key_type.blank?
-        if @@key_type == Fixnum
-          @resource_request.id = @resource_request.id.to_i
-        elsif @@key_type == Float
-          @resource_request.id = @resource_request.id.to_f
+    def self.format_string_id(id)
+      return nil unless id
+      # default key type of resources is String
+      # TODO: Should this be set by service in config/constants.yaml?
+      self.key_type ||= String
+      unless self.key_type.blank? or self.key_type.ancestors.include?(String)
+        if self.key_type.ancestors.include?(Integer)
+          id = id.to_i
+        elsif self.key_type.ancestors.include?(Float)
+          id = id.to_f
         else
           raise HTTP500ServerError, "Invalid key identifier type specified on resource #{self.class.to_s}."
         end
-      else
-        @@key_type = String
       end
+      id
     end
-
-    # This handles outputing properly formatted content based on the file extension in the URL.
-    def package(data)
-      if @resource_request.mime_type.like?( RESTRack.mime_type_for( :JSON ) )
-        @output = data.to_json
-      elsif @resource_request.mime_type.like?( RESTRack.mime_type_for( :XML ) )
-        if File.exists? builder_file
-          @output = builder_up(data)
-        else
-          @output = XmlSimple.xml_out(data, 'AttrPrefix' => true)
-        end
-      elsif @resource_request.mime_type.like?(RESTRack.mime_type_for( :YAML ) )
-        @output = YAML.dump(data)
-      elsif @resource_request.mime_type.like?(RESTRack.mime_type_for( :TEXT ) )
-        @output = data.to_s
+    
+    # Get action from HTTP verb
+    def get_action_from_context
+      if @resource_request.request.get?
+        @action = @id.blank? ? :index   : :show
+      elsif @resource_request.request.put?
+        @action = @id.blank? ? :replace : :update
+      elsif @resource_request.request.post?
+        @action = @id.blank? ? :create  : :add
+      elsif @resource_request.request.delete?
+        @action = @id.blank? ? :drop    : :destroy
       else
-        @output = data
+        raise HTTP405MethodNotAllowed, 'Action not provided or found and unknown HTTP request method.'
       end
     end
 
-    # Use Builder to generate the XML.
-    def builder_up(data)
-      buffer = ''
-      xml = Builder::XmlMarkup.new(:target => buffer)
-      xml.instruct!
-      eval( File.new( builder_file ).read )
-      return buffer
-    end
-
-    # Builds the path to the builder file for the current controller action.
-    def builder_file
-      "#{RESTRack::CONFIG[:ROOT]}/views/#{@resource_request.resource_name.underscore}/#{@resource_request.action}.xml.builder"
-    end
-
   end # class ResourceController
 end # module RESTRack