app/controllers/api/nodes_controller.rb

   1 # The NodeController is the RESTful interface to Node objects
   2
   3 module Api
   4   class NodesController < ApiController
   5     before_action :check_api_writable, :only => [:create, :update, :delete]
   6     before_action :authorize, :only => [:create, :update, :delete]
   7
   8     authorize_resource
   9
  10     before_action :require_public_data, :only => [:create, :update, :delete]
  11     around_action :api_call_handle_error, :api_call_timeout
  12
  13     before_action :set_request_formats, :except => [:create, :update, :delete]
  14     before_action :check_rate_limit, :only => [:create, :update, :delete]
  15
  16     # Dump the details on many nodes whose ids are given in the "nodes" parameter.
  17     def index
  18       raise OSM::APIBadUserInput, "The parameter nodes is required, and must be of the form nodes=id[,id[,id...]]" unless params["nodes"]
  19
  20       ids = params["nodes"].split(",").collect(&:to_i)
  21
  22       raise OSM::APIBadUserInput, "No nodes were given to search for" if ids.empty?
  23
  24       @nodes = Node.find(ids)
  25
  26       # Render the result
  27       respond_to do |format|
  28         format.xml
  29         format.json
  30       end
  31     end
  32
  33     # Dump the details on a node given in params[:id]
  34     def show
  35       @node = Node.find(params[:id])
  36
  37       response.last_modified = @node.timestamp
  38
  39       if @node.visible
  40         # Render the result
  41         respond_to do |format|
  42           format.xml
  43           format.json
  44         end
  45       else
  46         head :gone
  47       end
  48     end
  49
  50     # Create a node from XML.
  51     def create
  52       node = Node.from_xml(request.raw_post, :create => true)
  53
  54       # Assume that Node.from_xml has thrown an exception if there is an error parsing the xml
  55       node.create_with_history current_user
  56       render :plain => node.id.to_s
  57     end
  58
  59     # Update a node from given XML
  60     def update
  61       node = Node.find(params[:id])
  62       new_node = Node.from_xml(request.raw_post)
  63
  64       raise OSM::APIBadUserInput, "The id in the url (#{node.id}) is not the same as provided in the xml (#{new_node.id})" unless new_node && new_node.id == node.id
  65
  66       node.update_from(new_node, current_user)
  67       render :plain => node.version.to_s
  68     end
  69
  70     # Delete a node. Doesn't actually delete it, but retains its history
  71     # in a wiki-like way. We therefore treat it like an update, so the delete
  72     # method returns the new version number.
  73     def delete
  74       node = Node.find(params[:id])
  75       new_node = Node.from_xml(request.raw_post)
  76
  77       raise OSM::APIBadUserInput, "The id in the url (#{node.id}) is not the same as provided in the xml (#{new_node.id})" unless new_node && new_node.id == node.id
  78
  79       node.delete_with_history!(new_node, current_user)
  80       render :plain => node.version.to_s
  81     end
  82   end
  83 end