+ def check_database_readable(need_api = false)
+ if OSM_STATUS == :database_offline or (need_api and OSM_STATUS == :api_offline)
+ redirect_to :controller => 'site', :action => 'offline'
+ end
+ end
+
+ def check_database_writable(need_api = false)
+ if OSM_STATUS == :database_offline or OSM_STATUS == :database_readonly or
+ (need_api and (OSM_STATUS == :api_offline or OSM_STATUS == :api_readonly))
+ redirect_to :controller => 'site', :action => 'offline'
+ end
+ end
+
+ def check_api_readable
+ if OSM_STATUS == :database_offline or OSM_STATUS == :api_offline
+ response.headers['Error'] = "Database offline for maintenance"
+ render :nothing => true, :status => :service_unavailable
+ return false
+ end
+ end
+
+ def check_api_writable
+ if OSM_STATUS == :database_offline or OSM_STATUS == :database_readonly or
+ OSM_STATUS == :api_offline or OSM_STATUS == :api_readonly
+ response.headers['Error'] = "Database offline for maintenance"
+ render :nothing => true, :status => :service_unavailable
+ return false
+ end
+ end
+
+ def require_public_data
+ unless @user.data_public?
+ response.headers['Error'] = "You must make your edits public to upload new data"
+ render :nothing => true, :status => :forbidden
+ return false
+ end
+ end
+
+ # Report and error to the user
+ # (If anyone ever fixes Rails so it can set a http status "reason phrase",
+ # rather than only a status code and having the web engine make up a
+ # phrase from that, we can also put the error message into the status
+ # message. For now, rails won't let us)
+ def report_error(message, status = :bad_request)
+ # Todo: some sort of escaping of problem characters in the message
+ response.headers['Error'] = message
+ render :text => message, :status => status
+ end
+
+ def set_locale
+ if @user
+ if !@user.languages.empty?
+ request.user_preferred_languages = @user.languages
+ elsif !request.user_preferred_languages.empty?
+ @user.languages = request.user_preferred_languages
+ @user.save
+ end
+ end
+
+ I18n.locale = request.compatible_language_from(I18n.available_locales)
+ end
+
+ def api_call_handle_error
+ begin
+ yield
+ rescue ActiveRecord::RecordNotFound => ex
+ render :nothing => true, :status => :not_found
+ rescue LibXML::XML::Error, ArgumentError => ex
+ report_error ex.message, :bad_request
+ rescue ActiveRecord::RecordInvalid => ex
+ message = "#{ex.record.class} #{ex.record.id}: "
+ ex.record.errors.each { |attr,msg| message << "#{attr}: #{msg} (#{ex.record[attr].inspect})" }
+ report_error message, :bad_request
+ rescue OSM::APIError => ex
+ report_error ex.message, ex.status
+ rescue Exception => ex
+ report_error "#{ex.class}: #{ex.message}", :internal_server_error
+ end
+ end
+
+ ##
+ # asserts that the request method is the +method+ given as a parameter
+ # or raises a suitable error. +method+ should be a symbol, e.g: :put or :get.
+ def assert_method(method)
+ ok = request.send((method.to_s.downcase + "?").to_sym)
+ raise OSM::APIBadMethodError.new(method) unless ok
+ end
+
+ def api_call_timeout
+ Timeout::timeout(APP_CONFIG['api_timeout'], OSM::APITimeoutError) do
+ yield
+ end
+ end
+
+private
+ # extract authorisation credentials from headers, returns user = nil if none