Class: Parse::Client
- Inherits:
-
Object
- Object
- Parse::Client
- Defined in:
- lib/parse/client.rb
Overview
A class which encapsulates the HTTPS communication with the Parse API server. Currently uses the Patron library for low-level HTTP communication.
Instance Attribute Summary collapse
-
#api_key ⇒ Object
Returns the value of attribute api_key.
-
#application_id ⇒ Object
Returns the value of attribute application_id.
-
#host ⇒ Object
Returns the value of attribute host.
-
#session ⇒ Object
Returns the value of attribute session.
Instance Method Summary collapse
- #delete(uri) ⇒ Object
- #get(uri) ⇒ Object
-
#initialize(data = {}) ⇒ Client
constructor
A new instance of Client.
- #post(uri, body) ⇒ Object
- #put(uri, body) ⇒ Object
-
#request(uri, method = :get, body = nil, query = nil) ⇒ Object
Perform an HTTP request for the given uri and method with common basic response handling.
Constructor Details
#initialize(data = {}) ⇒ Client
Returns a new instance of Client.
16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 |
# File 'lib/parse/client.rb', line 16 def initialize(data = {}) @host = data[:host] || Protocol::HOST @application_id = data[:application_id] @api_key = data[:api_key] @session = Patron::Session.new @session.timeout = 10 @session.connect_timeout = 10 @session.base_url = "https://#{host}" @session.headers["Content-Type"] = "application/json" @session.headers["Accept"] = "application/json" @session.headers["User-Agent"] = "Parse for Ruby, 0.0" @session.headers[Protocol::HEADER_API_KEY] = @api_key @session.headers[Protocol::HEADER_APP_ID] = @application_id end |
Instance Attribute Details
#api_key ⇒ Object
Returns the value of attribute api_key.
13 14 15 |
# File 'lib/parse/client.rb', line 13 def api_key @api_key end |
#application_id ⇒ Object
Returns the value of attribute application_id.
12 13 14 |
# File 'lib/parse/client.rb', line 12 def application_id @application_id end |
#host ⇒ Object
Returns the value of attribute host.
11 12 13 |
# File 'lib/parse/client.rb', line 11 def host @host end |
#session ⇒ Object
Returns the value of attribute session.
14 15 16 |
# File 'lib/parse/client.rb', line 14 def session @session end |
Instance Method Details
#delete(uri) ⇒ Object
67 68 69 |
# File 'lib/parse/client.rb', line 67 def delete(uri) request(uri, :delete) end |
#get(uri) ⇒ Object
55 56 57 |
# File 'lib/parse/client.rb', line 55 def get(uri) request(uri) end |
#post(uri, body) ⇒ Object
59 60 61 |
# File 'lib/parse/client.rb', line 59 def post(uri, body) request(uri, :post, body) end |
#put(uri, body) ⇒ Object
63 64 65 |
# File 'lib/parse/client.rb', line 63 def put(uri, body) request(uri, :put, body) end |
#request(uri, method = :get, body = nil, query = nil) ⇒ Object
Perform an HTTP request for the given uri and method with common basic response handling. Will raise a ParseProtocolError if the response has an error status code, and will return the parsed JSON body on success, if there is one.
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 |
# File 'lib/parse/client.rb', line 36 def request(uri, method = :get, body = nil, query = nil) = {} if body [:data] = body end if query [:query] = query end response = @session.request(method, uri, {}, ) if response.status >= 400 raise ParseError, "#{JSON.parse(response.body)['code']}: #{JSON.parse(response.body)['error']}" else if response return JSON.parse response.body end end end |