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